Bir ajanın araç yapmasını sağlayan istem yazın: 3 bölüm

Bir ajandan "bir araç yap" diye istediniz ve uygulamanıza uymayan belirsiz bir şey aldınız. Çözüm daha uzun bir istem değil, üç belirli bölümden oluşan bir istemdir: aracın nerede yaşadığı, ne yaptığı ve geçerli olması gereken somut ayrıntılar. Birden fazla tura da hazır olun: DeepSeek bile demo eklentilerinden bazılarının birkaç konuşma turu boyunca geliştirildiğini söylüyor.

DeepSeek'in Harness Creator Mode demo videosu için hazırladığı koleksiyondaki istemlerin çoğu bu üç bölümlü yapıyı gösteriyor. Sayfa (DeepSeek'in Creator Mode istem koleksiyonu, 3 Kasım 2026'da kontrol edildi, sayfada yayın tarihi yok) yedi eklenti listeliyor: ünlü yapıların 3D galerisi, bir Transformer 3D görselleştirmesi, pikselli bir DSH arayüzü, bir poster tasarım tezgahı, bir video düzenleme tezgahı, bir makale okuyucu ve konuşma istatistikleri. Birini kullanmak için istemi DeepSeek Harness'a yapıştırıp Creator Mode seçeneğini seçiyorsunuz. Her istem İngilizce ve Çince olarak veriliyor.

Üç bölüm gerçek bir istemde nasıl görünür#

O sayfadaki Transformer 3D görselleştirme istemini ele alalım. "Sol kenar çubuğu girişi olan bir DeepSeek Harness eklentisi oluştur" ile başlıyor. Bu birinci bölüm: aracın nerede yaşadığı. Sonra işlevi tanımlıyor: Transformer hesaplamasını açıklayan etkileşimli bir 3D gösterim oyunu. İkinci bölüm. Sonunda unutulması kolay ve sonradan düzeltmesi can sıkıcı bir gereksinimle bitiyor: panel başlığı ve araç çubuğu yerel macOS pencere düğmeleriyle çakışmamalı. Üçüncü bölüm.

Sayfadaki diğer istemler de aynı yapıyı izliyor, farklılıklarla. Giriş noktası değişiyor: üçünde sol kenar çubuğu girişi, ikisinde konuşmadan ulaşılan bir nokta, makale okuyucuda sağ kenar çubuğu. Son kısım somutlaştıkları yer: beş stil, biri pikselli, ya da varsayılan sayfa başlığı "Her şey bir eklentidir". Kopyalamaya değer desen bu ve fark hızla ortaya çıkıyor:

İlk sürüm ajanı her konuda tahmin yürütmeye bırakıyor. Nereye gidiyor? Kenar çubuğuna mı, bir komuta mı, ayrı bir pencereye mi? "Konuşmalarım için" ne anlama geliyor? İkincisi, ajan sormak zorunda kalmadan bu soruları yanıtlıyor.

Kendinizinkini yazın, her seferinde bir bölüm#

Bir makaleyi okuyan ve onun hakkında soru sormanıza izin veren küçük bir panel istediğinizi varsayalım. Bölümleri sırayla ele alın.

Nerede yaşadığı. Tek cümle ve tam yeri belirtin: "sol kenar çubuğu girişi olan bir eklenti", "araç çubuğunda bir düğme", "menüden açılan bir sayfa". Bunu atlarsanız ajan sizin yerinize seçer.

Ne yaptığı. Nasıl inşa edildiğini değil, neyi gördüğünüzü ve tıkladığınızı tanımlayın. "Bir PDF bırakıyorsunuz, sol taraf metni gösteriyor, sağ tarafta onun hakkında bir sohbet var." Birini adlandırmak için bir nedeniniz yoksa çerçeveyi atlayın.

Somut gereksinimler. Geçen sefer ters giden şeyler buraya gider. Düzen kuralları, çakışmaması gereken şeyler, bir dil, bir dosya biçimi, "ağ çağrısı yok" gibi bir sınır. Kısa, kontrol edilebilir satırlar. Bir gereksinimin karşılanıp karşılanmadığını sonuca bakarak anlayamıyorsanız, anlayana kadar yeniden yazın.

Bir araya getirince:

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

API üzerinden gönderin#

Creator Mode bir DeepSeek Harness özelliğidir; istemin kendisi düz metindir, yani bir istemi okuyan her şey onu çalıştırabilir, CheapTokens API'sini çağıran bir betik dahil. Aşağıdaki istem yukarıdaki istemin DeepSeek-V4-Flash'e gönderilmiş hali (tam kimlik deepseek-ai/DeepSeek-V4-Flash-0731, 380K bağlam, tek yanıtta en fazla 32.768 token, bu da tek bir yanıtta bütün bir eklentiye yer bırakır):

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)

Anahtar bir ortam değişkenine gider, asla dosyaya değil. finish_reason length yazdırıyorsa, eklenti max_tokens tarafından kesilmiştir: sınırı yükseltin. DeepSeek Harness'ı özel bir sağlayıcıyla kurmak ayrı bir iştir, DeepSeek Harness'ı CheapTokens'e bağlama yazısında ele alınmıştır. İlk istek temelleri CheapTokens belgelerinde.

Tek bir istem neden nadiren yeterlidir#

DeepSeek bunu açıkça söylüyor: demo eklentilerinden bazıları birkaç konuşma turu boyunca geliştirildi, yani tek bir istem videoyu tam olarak yeniden üretmeyebilir. Bunu bir müteahhite brifing vermek gibi düşünün. İlk çizim odanın çoğunu size verir, siz de içinde yürüyüp "kapı yanlış yöne açılıyor" dersiniz.

Para da burada gidiyor. Bir ajan her turda konuşmayı yeniden gönderir (uzun bir sohbetin neden daha pahalı olduğu yazısındaki aynı etki), yani beşinci tur istemi, önceki dört yanıtı ve o ana kadarki tüm kodu taşır.

Bir yapım oturumunun maliyeti#

Burada ölçüm değil, varsayımsal bir oturum var: beş tur, tur başına yaklaşık 12.000 token gönderilen (istem, geçmiş, mevcut kod) ve yaklaşık 6.000 token geri yazılan. Aşağıdaki tablo her model için canlı CheapTokens fiyatlarını kullanıyor; OpenRouter sütunu aynı oturumu toplamda, girdi ve çıktı birlikte sayılarak karşılaştırmak için orada.

Bir DeepSeek-V4-Flash turu için aynı sayılar $0.00078 tutuyor. Eklentiniz daha büyükse geçmiş her turda büyür, o yüzden iki sayıyı değiştirip tahmini yeniden çalıştırın. Ajan faturalarını tahmin etme hakkında daha fazlası bir AI ajanının maliyeti nasıl tahmin edilir yazısında, model listesi de fiyatlandırma sayfasında.

Göndermeden önce kontrol edin#

İlk istemi yazın, geri geleni okuyun ve her düzeltmeyi gereksinimlerin bir sonraki sürümüne koyun. İki üç oturumdan sonra her yeni isteme yapıştırdığınız kısa bir satır listesi olacak ve ilk tur kastettiğinize daha yakın çıkacak. Herhangi bir istemin altındaki alışkanlıklar için iyi bir istem nasıl yazılır yazısına bakın.