Napisz prompt, który każe agentowi zbudować narzędzie: 3 części

Poprosiłeś agenta o „zrobienie narzędzia” i dostałeś coś niejasnego, co nie pasuje do twojej aplikacji. Rozwiązaniem nie jest dłuższy prompt, tylko prompt z trzema konkretnymi częściami: gdzie narzędzie żyje, co robi i konkretne szczegóły, które muszą być spełnione. Licz się też z więcej niż jedną rundą: nawet DeepSeek mówi, że część jego wtyczek demonstracyjnych była dopracowywana przez kilka rund rozmowy.

Większość promptów w kolekcji DeepSeek do wideo demonstracyjnego Harness Creator Mode ma ten trójdzielny kształt. Strona (kolekcja promptów Creator Mode DeepSeek, sprawdzona 3 listopada 2026, brak daty publikacji na stronie) wymienia siedem wtyczek: galerię 3D słynnych zabytków, wizualizację 3D Transformera, spikselowany interfejs DSH, warsztat projektowania plakatów, warsztat edycji wideo, czytnik artykułów i statystyki rozmów. Aby użyć jednego z nich, wklejasz prompt do DeepSeek Harness i wybierasz opcję Creator Mode. Każdy prompt jest podany po angielsku i po chińsku.

Jak trzy części wyglądają w prawdziwym prompcie#

Weź prompt do wizualizacji 3D Transformera z tej strony. Zaczyna się od „Create a DeepSeek Harness plugin with a left sidebar entry”. To część pierwsza: gdzie narzędzie żyje. Potem opisuje funkcję: interaktywną grę demonstracyjną 3D, która wyjaśnia obliczenia Transformera. Część druga. Kończy się wymaganiem, o którym łatwo zapomnieć i które jest irytujące do naprawienia później: tytuł panelu i pasek narzędzi nie mogą nachodzić na natywne przyciski okna macOS. Część trzecia.

Pozostałe prompty na stronie mają ten sam kształt, z różnicami. Punkt wejścia się zmienia: wpis na lewym pasku bocznym w trzech z nich, miejsce dostępne z rozmowy w dwóch, prawy pasek boczny w czytniku artykułów. Zakończenie to miejsce, gdzie stają się konkretne: pięć stylów, jeden z nich spikselowany, albo domyślny tytuł strony „Everything is a plugin”. To wzorzec wart skopiowania, a różnica widać szybko:

Pierwsza wersja zostawia agentowi zgadywanie wszystkiego. Gdzie to trafia? Pasek boczny, polecenie, osobne okno? Co się liczy jako „do moich rozmów”? Druga odpowiada na te pytania, zanim agent musi je zadać.

Napisz własny, część po części#

Powiedzmy, że chcesz mały panel, który czyta artykuł i pozwala zadawać o nim pytania. Przejdź przez części po kolei.

Gdzie żyje. Jedno zdanie i nazwij dokładne miejsce: „wtyczka z wpisem na lewym pasku bocznym”, „przycisk na pasku narzędzi”, „strona otwierana z menu”. Jeśli to pominiesz, agent wybierze za ciebie.

Co robi. Opisz, co widzisz i klikasz, a nie jak jest zbudowane. „Wrzucasz PDF, lewa strona pokazuje tekst, prawa ma czat na jego temat.” Pomiń framework, chyba że masz powód, by go nazwać.

Konkretne wymagania. To tutaj trafiają rzeczy, które poszły nie tak ostatnim razem. Zasady układu, rzeczy, które nie mogą na siebie nachodzić, język, format pliku, limit typu „brak wywołań sieciowych”. Krótkie, sprawdzalne linijki. Jeśli nie potrafisz stwierdzić, czy wymaganie zostało spełnione, patrząc na wynik, przepisz je, aż będziesz potrafił.

Złożone razem:

Create a plugin with a left sidebar entry.
It is a paper reader: I open a PDF, the text is shown
on the left, and a chat about the paper is on the right.
Requirements:
- the panel title must not overlap the window buttons
- the chat answers only from the paper's text
- keep everything in one file

Wyślij to przez API#

Creator Mode to funkcja DeepSeek Harness; sam prompt to zwykły tekst, więc wszystko, co czyta prompt, może go uruchomić, w tym skrypt wywołujący API CheapTokens. Poniższy prompt to ten powyższy, wysłany do DeepSeek-V4-Flash (pełny identyfikator deepseek-ai/DeepSeek-V4-Flash-0731, kontekst 380K, do 32 768 tokenów w jednej odpowiedzi, co zostawia miejsce na całą wtyczkę w jednej odpowiedzi):

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)

prompt = """Create a plugin with a left sidebar entry.
It is a paper reader: I open a PDF, the text is shown
on the left, and a chat about the paper is on the right.
Requirements:
- the panel title must not overlap the window buttons
- the chat answers only from the paper's text
- keep everything in one file"""

resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": prompt}],
    max_tokens=8000,
)
print(resp.choices[0].message.content)
print(resp.choices[0].finish_reason, resp.usage)

Klucz trafia do zmiennej środowiskowej, nigdy do pliku. Jeśli finish_reason wypisze length, wtyczka została ucięta przez max_tokens: podnieś limit. Skonfigurowanie samego DeepSeek Harness z niestandardowym dostawcą to osobne zadanie, opisane w podłączaniu DeepSeek Harness do CheapTokens. Podstawy pierwszego żądania są w dokumentacji CheapTokens.

Dlaczego jeden prompt rzadko wystarcza#

DeepSeek mówi to wprost: część wtyczek demonstracyjnych była dopracowywana przez kilka rund rozmowy, więc pojedynczy prompt może nie odtworzyć wideo dokładnie. Pomyśl o tym jak o briefingu dla wykonawcy. Pierwszy rysunek daje ci większość pomieszczenia, a ty przechodzisz przez nie i mówisz „drzwi otwierają się w złą stronę”.

I tu idą pieniądze. Agent wysyła rozmowę ponownie z każdą rundą (ten sam efekt jak w dlaczego długa rozmowa kosztuje więcej), więc piąta runda niesie prompt, cztery wcześniejsze odpowiedzi i cały dotychczasowy kod.

Ile kosztuje sesja budowania#

Oto założona sesja, nie pomiar: pięć rund, około 12 000 tokenów wysyłanych na rundę (prompt, historia, bieżący kod) i około 6 000 tokenów zapisywanych z powrotem. Poniższa tabela używa aktualnych cen CheapTokens dla każdego modelu; kolumna OpenRouter jest tam, by porównać tę samą sesję w całości, z wejściem i wyjściem liczonym razem.

Dla jednej rundy DeepSeek-V4-Flash te same liczby dają $0.00078. Jeśli twoja wtyczka jest większa, historia rośnie z każdą rundą, więc zmień te dwie liczby i uruchom szacunek ponownie. Więcej o szacowaniu rachunków agenta w jak oszacować koszt agenta AI, a lista modeli jest na stronie z cenami.

Sprawdź przed wysłaniem#

Napisz pierwszy prompt, przeczytaj, co wraca, i włóż każdą poprawkę do następnej wersji wymagań. Po dwóch lub trzech sesjach będziesz mieć krótką listę linijek, które wklejasz do każdego nowego promptu, a pierwsza runda wyjdzie bliżej tego, co miałeś na myśli. O podstawowych nawykach każdego promptu przeczytasz w jak napisać dobry prompt.