Menulis prompt yang membuat agen membangun tool: 3 bagian

Anda meminta agen untuk "membuat sebuah tool", dan mendapat sesuatu yang samar yang tidak cocok dengan aplikasi Anda. Solusinya bukan prompt yang lebih panjang, melainkan prompt dengan tiga bagian spesifik: di mana tool itu berada, apa yang dilakukannya, dan detail konkret yang harus dipenuhi. Bersiaplah untuk lebih dari satu putaran: bahkan DeepSeek mengatakan beberapa plugin demonya disempurnakan melalui beberapa putaran percakapan.

Sebagian besar prompt dalam koleksi DeepSeek untuk video demo Harness Creator Mode menunjukkan bentuk tiga bagian itu. Halaman tersebut (koleksi prompt Creator Mode DeepSeek, diperiksa 3 November 2026, tidak ada tanggal publikasi di halaman) mencantumkan tujuh plugin: galeri 3D landmark terkenal, visualisasi 3D Transformer, antarmuka DSH berpiksel, workbench desain poster, workbench pengeditan video, pembaca makalah, dan statistik percakapan. Untuk menggunakannya, Anda menempelkan prompt ke DeepSeek Harness dan memilih opsi Creator Mode. Setiap prompt diberikan dalam bahasa Inggris dan Mandarin.

Seperti apa ketiga bagian itu dalam prompt nyata#

Ambil prompt visualisasi 3D Transformer dari halaman itu. Prompt tersebut dibuka dengan "Create a DeepSeek Harness plugin with a left sidebar entry". Itu bagian pertama: di mana tool itu berada. Lalu dijelaskan fungsinya: sebuah game demonstrasi 3D interaktif yang menjelaskan komputasi Transformer. Bagian kedua. Prompt ditutup dengan persyaratan yang mudah terlupakan dan menjengkelkan untuk diperbaiki nanti: judul panel dan toolbar tidak boleh menimpa tombol jendela bawaan macOS. Bagian ketiga.

Prompt lain di halaman itu mengikuti bentuk yang sama, dengan perbedaan. Titik masuknya bervariasi: entri sidebar kiri di tiga prompt, titik yang dicapai dari percakapan di dua prompt, sidebar kanan di pembaca makalah. Bagian akhirnya adalah tempat mereka menjadi konkret: lima gaya, salah satunya berpiksel, atau judul halaman default "Everything is a plugin". Itulah pola yang layak ditiru, dan perbedaannya terlihat cepat:

Versi pertama membuat agen menebak segala hal. Di mana tempatnya? Sidebar, perintah, jendela terpisah? Apa yang dimaksud "untuk percakapan saya"? Versi kedua menjawab pertanyaan itu sebelum agen harus bertanya.

Tulis sendiri, satu bagian demi satu bagian#

Misalkan Anda ingin panel kecil yang membaca sebuah makalah dan memungkinkan Anda mengajukan pertanyaan tentangnya. Lewati bagian-bagiannya secara berurutan.

Di mana tempatnya. Satu kalimat, dan sebutkan tempat persisnya: "plugin dengan entri sidebar kiri", "tombol di toolbar", "halaman yang dibuka dari menu". Jika Anda melewatkannya, agen yang memilih untuk Anda.

Apa yang dilakukannya. Jelaskan apa yang Anda lihat dan klik, bukan bagaimana cara membangunnya. "Anda menjatuhkan PDF, sisi kiri menampilkan teks, sisi kanan memiliki obrolan tentangnya." Lewati framework kecuali Anda punya alasan untuk menyebutkannya.

Persyaratan konkret. Di sinilah hal-hal yang salah terakhir kali diletakkan. Aturan tata letak, hal-hal yang tidak boleh tumpang tindih, bahasa, format file, batasan seperti "tanpa panggilan jaringan". Baris pendek yang dapat diperiksa. Jika Anda tidak bisa menentukan apakah suatu persyaratan terpenuhi dengan melihat hasilnya, tulis ulang sampai bisa.

Gabungkan:

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

Kirim melalui API#

Creator Mode adalah fitur DeepSeek Harness; prompt itu sendiri adalah teks biasa, jadi apa pun yang membaca prompt dapat menjalankannya, termasuk skrip yang memanggil API CheapTokens. Prompt di bawah adalah prompt di atas, dikirim ke DeepSeek-V4-Flash (id lengkap deepseek-ai/DeepSeek-V4-Flash-0731, konteks 380K, hingga 32.768 token dalam satu jawaban, yang menyisakan ruang untuk seluruh plugin dalam satu balasan):

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)

Key dimasukkan ke variabel lingkungan, jangan pernah ke dalam file. Jika finish_reason mencetak length, plugin terpotong oleh max_tokens: naikkan batasnya. Menyiapkan DeepSeek Harness itu sendiri dengan provider kustom adalah pekerjaan terpisah, dibahas di menghubungkan DeepSeek Harness ke CheapTokens. Dasar-dasar permintaan pertama ada di dokumentasi CheapTokens.

Mengapa satu prompt jarang cukup#

DeepSeek mengatakannya dengan jelas: beberapa plugin demo disempurnakan melalui beberapa putaran percakapan, jadi satu prompt mungkin tidak mereproduksi video secara persis. Anggap saja seperti memberi arahan kepada kontraktor. Gambar pertama sudah memberi Anda sebagian besar ruangan, lalu Anda menelusurinya dan berkata "pintunya terbuka ke arah yang salah".

Dan di situlah biayanya mengalir. Agen mengirim ulang percakapan di setiap putaran (efek yang sama seperti pada mengapa obrolan panjang lebih mahal), jadi putaran kelima membawa prompt, empat jawaban sebelumnya, dan semua kode sejauh ini.

Berapa biaya sesi build#

Berikut adalah sesi yang diasumsikan, bukan pengukuran: lima putaran, sekitar 12.000 token dikirim per putaran (prompt, riwayat, kode saat ini) dan sekitar 6.000 token ditulis kembali. Tabel di bawah menggunakan harga CheapTokens langsung untuk setiap model; kolom OpenRouter ada untuk membandingkan sesi yang sama secara total, dengan input dan output dihitung bersama.

Untuk satu putaran DeepSeek-V4-Flash, angka yang sama menjadi $0.00078. Jika plugin Anda lebih besar, riwayat tumbuh setiap putaran, jadi ubah kedua angka tersebut dan jalankan ulang estimasinya. Selengkapnya tentang memperkirakan tagihan agen di cara memperkirakan biaya agen AI, dan daftar model ada di halaman harga.

Periksa sebelum mengirim#

Tulis prompt pertama, baca apa yang kembali, dan masukkan setiap koreksi ke versi persyaratan berikutnya. Setelah dua atau tiga sesi Anda akan memiliki daftar baris pendek yang Anda tempelkan ke setiap prompt baru, dan putaran pertama akan keluar lebih dekat dengan maksud Anda. Untuk kebiasaan mendasar dari prompt apa pun, lihat cara menulis prompt yang baik.