ایک پرامپٹ لکھیں جو ایجنٹ سے ٹول بنوائے: 3 حصے

آپ نے ایجنٹ سے کہا "ایک ٹول بناؤ"، اور کچھ مبہم سا ملا جو آپ کی ایپ میں فٹ نہیں بیٹھتا۔ حل لمبا پرامپٹ نہیں ہے، بلکہ تین مخصوص حصوں والا پرامپٹ ہے: ٹول کہاں رہتا ہے، وہ کیا کرتا ہے، اور وہ ٹھوس تفصیلات جو پوری ہونی چاہئیں۔ ایک سے زیادہ راؤنڈ کی توقع بھی رکھیں: خود DeepSeek کہتا ہے کہ اس کے کچھ ڈیمو پلگ ان کئی گفتگو راؤنڈز میں بہتر بنائے گئے۔

Harness Creator Mode ڈیمو ویڈیو کے لیے DeepSeek کے مجموعے میں زیادہ تر پرامپٹس یہی تین حصوں کی شکل دکھاتے ہیں۔ صفحہ (DeepSeek's Creator Mode prompt collection، 3 نومبر 2026 کو دیکھا گیا، صفحے پر کوئی اشاعت کی تاریخ نہیں) سات پلگ انز کی فہرست دیتا ہے: مشہور مقامات کی 3D گیلری، Transformer کی 3D بصری نمائش، پکسل شدہ DSH انٹرفیس، پوسٹر ڈیزائن ورک بینچ، ویڈیو ایڈیٹنگ ورک بینچ، پیپر ریڈر اور گفتگو کے اعداد و شمار۔ کسی ایک کو استعمال کرنے کے لیے، آپ پرامپٹ DeepSeek Harness میں پیسٹ کرتے ہیں اور Creator Mode کا آپشن منتخب کرتے ہیں۔ ہر پرامپٹ انگریزی اور چینی میں دیا گیا ہے۔

اصل پرامپٹ میں تین حصے کیسے نظر آتے ہیں#

اسی صفحے سے Transformer 3D بصری نمائش کا پرامپٹ لیں۔ یہ "Create a DeepSeek Harness plugin with a left sidebar entry" سے شروع ہوتا ہے۔ یہ پہلا حصہ ہے: ٹول کہاں رہتا ہے۔ پھر یہ فعل بیان کرتا ہے: ایک انٹرایکٹو 3D مظاہرہ گیم جو Transformer کی کمپیوٹیشن سمجھاتی ہے۔ دوسرا حصہ۔ یہ ایک ایسی شرط پر ختم ہوتا ہے جو بھولنا آسان اور بعد میں ٹھیک کرنا پریشان کن ہے: پینل کا عنوان اور ٹول بار macOS کے مقامی ونڈو بٹنوں سے اوورلیپ نہیں ہونے چاہئیں۔ تیسرا حصہ۔

صفحے کے باقی پرامپٹس بھی یہی شکل اختیار کرتے ہیں، فرق کے ساتھ۔ انٹری پوائنٹ بدلتا ہے: ان میں سے تین میں بائیں سائیڈ بار کا انٹری، دو میں گفتگو سے پہنچنے والی جگہ، پیپر ریڈر میں دائیں سائیڈ بار۔ اختتام وہاں ٹھوس ہوتا ہے: پانچ اسٹائلز، جن میں سے ایک پکسل شدہ، یا "Everything is a plugin" کا ڈیفالٹ صفحہ عنوان۔ یہی وہ نمونہ ہے جس کی نقل کرنی چاہیے، اور فرق فوراً نظر آتا ہے:

پہلا ورژن ایجنٹ کو ہر چیز کے بارے میں اندازہ لگانے پر چھوڑ دیتا ہے۔ یہ کہاں جاتا ہے؟ سائیڈ بار، کمانڈ، الگ ونڈو؟ "میری گفتگو کے لیے" کا مطلب کیا ہے؟ دوسرا ورژن ان سوالات کے جواب ایجنٹ کے پوچھنے سے پہلے دے دیتا ہے۔

اپنا لکھیں، ایک وقت میں ایک حصہ#

فرض کریں آپ ایک چھوٹا پینل چاہتے ہیں جو ایک پیپر پڑھے اور آپ کو اس کے بارے میں سوالات پوچھنے دے۔ حصوں کو ترتیب سے دیکھیں۔

یہ کہاں رہتا ہے۔ ایک جملہ، اور درست جگہ کا نام لیں: "بائیں سائیڈ بار انٹری والا پلگ ان"، "ٹول بار میں ایک بٹن"، "مینو سے کھلنے والا صفحہ"۔ اگر آپ اسے چھوڑ دیں گے، تو ایجنٹ آپ کے لیے انتخاب کرے گا۔

یہ کیا کرتا ہے۔ بیان کریں کہ آپ کیا دیکھتے اور کلک کرتے ہیں، نہ کہ یہ کیسے بنایا گیا ہے۔ "آپ ایک PDF ڈالتے ہیں، بائیں طرف متن دکھائی دیتا ہے، دائیں طرف اس کے بارے میں چیٹ ہوتی ہے۔" فریم ورک چھوڑ دیں جب تک کہ نام لینے کی کوئی وجہ نہ ہو۔

ٹھوس شرائط۔ یہیں وہ چیزیں آتی ہیں جو پچھلی بار غلط ہوئیں۔ لے آؤٹ کے قواعد، چیزیں جو اوورلیپ نہیں ہونی چاہئیں، ایک زبان، ایک فائل فارمیٹ، "کوئی نیٹ ورک کال نہیں" جیسی حد۔ مختصر، جانچنے کے قابل سطریں۔ اگر آپ نتیجہ دیکھ کر یہ نہیں بتا سکتے کہ کوئی شرط پوری ہوئی یا نہیں، تو اسے دوبارہ لکھیں جب تک کہ بتا سکیں۔

مل کر:

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 کے ذریعے بھیجیں#

Creator Mode ایک DeepSeek Harness فیچر ہے؛ پرامپٹ خود سادہ متن ہے، لہٰذا جو بھی پرامپٹ پڑھتا ہے اسے چلا سکتا ہے، بشمول ایک اسکرپٹ جو CheapTokens API کال کرتا ہے۔ نیچے دیا گیا پرامپٹ وہی اوپر والا ہے، جو DeepSeek-V4-Flash کو بھیجا گیا ہے (مکمل id deepseek-ai/DeepSeek-V4-Flash-0731، 380K کانٹیکسٹ، ایک جواب میں زیادہ سے زیادہ 32,768 ٹوکنز، جو ایک جواب میں پورا پلگ ان بنانے کی گنجائش دیتا ہے):

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)

کلید ماحول کے متغیر میں رکھیں، کبھی فائل میں نہیں۔ اگر finish_reason length پرنٹ کرتا ہے، تو پلگ ان max_tokens کی وجہ سے کٹ گیا: حد بڑھائیں۔ DeepSeek Harness کو خود کسٹم پرووائیڈر کے ساتھ سیٹ اپ کرنا الگ کام ہے، جس کا احاطہ connecting DeepSeek Harness to CheapTokens میں کیا گیا ہے۔ پہلی درخواست کی بنیادی باتیں CheapTokens docs میں ہیں۔

ایک پرامپٹ کم ہی کیوں کافی ہوتا ہے#

DeepSeek صاف کہتا ہے: کچھ ڈیمو پلگ ان کئی گفتگو راؤنڈز میں بہتر بنائے گئے، لہٰذا ایک پرامپٹ ویڈیو کو بالکل ویسا نہیں بنا سکتا۔ اسے ٹھیکیدار کو بریفنگ دینے کی طرح سمجھیں۔ پہلا نقشہ کمرے کا زیادہ تر حصہ دے دیتا ہے، اور آپ اس میں چل کر کہتے ہیں "دروازہ غلط طرف کھلتا ہے"۔

اور یہیں پیسہ خرچ ہوتا ہے۔ ایجنٹ ہر راؤنڈ کے ساتھ گفتگو دوبارہ بھیجتا ہے (لمبی چیٹ زیادہ مہنگی کیوں ہوتی ہے جیسا ہی اثر)، لہٰذا پانچواں راؤنڈ پرامپٹ، چار پچھلے جوابات اور اب تک کا سارا کوڈ ساتھ لے کر چلتا ہے۔

ایک بلڈ سیشن کا خرچ#

یہ ایک فرضی سیشن ہے، پیمائش نہیں: پانچ راؤنڈز، فی راؤنڈ تقریباً 12,000 ٹوکنز بھیجے گئے (پرامپٹ، تاریخ، موجودہ کوڈ) اور تقریباً 6,000 ٹوکنز واپس لکھے گئے۔ نیچے دیا گیا جدول ہر ماڈل کے لیے CheapTokens کی لائیو قیمتیں استعمال کرتا ہے؛ OpenRouter کا کالم اسی سیشن کا مجموعی موازنہ کرنے کے لیے ہے، جس میں ان پٹ اور آؤٹ پٹ دونوں شامل ہیں۔

DeepSeek-V4-Flash کے ایک راؤنڈ کے لیے یہی اعداد $0.00078 بنتے ہیں۔ اگر آپ کا پلگ ان بڑا ہے، تو تاریخ ہر راؤنڈ میں بڑھتی ہے، لہٰذا دونوں اعداد بدلیں اور تخمینہ دوبارہ چلائیں۔ ایجنٹ بلز کا تخمینہ لگانے پر مزید how to estimate the cost of an AI agent میں، اور ماڈل کی فہرست pricing page پر ہے۔

بھیجنے سے پہلے جانچیں#

پہلا پرامپٹ لکھیں، جو واپس آئے اسے پڑھیں، اور ہر اصلاح کو شرائط کے اگلے ورژن میں ڈالیں۔ دو یا تین سیشنز کے بعد آپ کے پاس سطروں کی ایک مختصر فہرست ہوگی جو آپ ہر نئے پرامپٹ میں پیسٹ کریں گے، اور پہلا راؤنڈ آپ کے مطلب کے زیادہ قریب نکلے گا۔ کسی بھی پرامپٹ کی بنیادی عادات کے لیے how to write a good prompt دیکھیں۔