اكتب مطالبة تجعل الوكيل يبني أداة: 3 أجزاء

طلبت من وكيل أن "يصنع أداة"، فحصلت على شيء غامض لا يناسب تطبيقك. الحل ليس مطالبة أطول، بل مطالبة بثلاثة أجزاء محددة: أين تعيش الأداة، وماذا تفعل، والتفاصيل الملموسة التي يجب أن تتحقق. توقّع أكثر من جولة أيضاً: حتى DeepSeek تقول إن بعض إضافاتها التجريبية صُقلت عبر عدة جولات محادثة.

معظم المطالبات في مجموعة DeepSeek لفيديو عرض Harness Creator Mode تُظهر هذا الشكل الثلاثي. تسرد الصفحة (مجموعة مطالبات Creator Mode من DeepSeek، تم التحقق في 3 نوفمبر 2026، لا يوجد تاريخ نشر على الصفحة) سبع إضافات: معرض ثلاثي الأبعاد لمعالم شهيرة، وتصوّر ثلاثي الأبعاد لـ Transformer، وواجهة DSH مبكسلة، وطاولة عمل لتصميم الملصقات، وطاولة عمل لتحرير الفيديو، وقارئ أوراق، وإحصاءات المحادثات. لاستخدام واحدة، تلصق المطالبة في DeepSeek Harness وتختار خيار Creator Mode. كل مطالبة معروضة بالإنجليزية والصينية.

كيف تبدو الأجزاء الثلاثة في مطالبة حقيقية#

خذ مطالبة التصوّر ثلاثي الأبعاد لـ Transformer من تلك الصفحة. تبدأ بـ "Create a DeepSeek Harness plugin with a left sidebar entry". هذا هو الجزء الأول: أين تعيش الأداة. ثم تصف الوظيفة: لعبة عرض تفاعلية ثلاثية الأبعاد تشرح حساب 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 (المعرّف الكامل 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 نفسه مع مزوّد مخصص مهمة منفصلة، مغطاة في ربط DeepSeek Harness بـ CheapTokens. أساسيات الطلب الأول في وثائق CheapTokens.

لماذا نادراً ما تكفي مطالبة واحدة#

تقولها DeepSeek بوضوح: بعض الإضافات التجريبية صُقلت عبر عدة جولات محادثة، لذا قد لا تعيد مطالبة واحدة إنتاج الفيديو بدقة. فكّر فيها كإحاطة بمقاول. الرسم الأول يمنحك معظم الغرفة، ثم تتجول فيها وتقول "الباب يُفتح في الاتجاه الخاطئ".

وهنا يذهب المال. يعيد الوكيل إرسال المحادثة مع كل جولة (نفس التأثير كما في لماذا تكلف المحادثة الطويلة أكثر)، لذا تحمل الجولة الخامسة المطالبة وأربع إجابات سابقة وكل الشيفرة حتى الآن.

كم تكلف جلسة بناء#

هذه جلسة مفترضة، لا قياس: خمس جولات، نحو 12,000 رمز مُرسل لكل جولة (المطالبة، السجل، الشيفرة الحالية) ونحو 6,000 رمز مكتوب في الرد. يستخدم الجدول أدناه أسعار CheapTokens الحية لكل نموذج؛ عمود OpenRouter موجود لمقارنة الجلسة نفسها إجمالاً، مع احتساب الإدخال والإخراج معاً.

لجولة واحدة من DeepSeek-V4-Flash تبلغ الأرقام نفسها $0.00078. إذا كانت إضافتك أكبر، ينمو السجل كل جولة، لذا غيّر الرقمين وأعد تشغيل التقدير. المزيد عن تقدير فواتير الوكلاء في كيفية تقدير تكلفة وكيل ذكاء اصطناعي، وقائمة النماذج على صفحة الأسعار.

تحقق قبل أن ترسل#

اكتب المطالبة الأولى، واقرأ ما يعود، وضع كل تصحيح في النسخة التالية من المتطلبات. بعد جلستين أو ثلاث سيكون لديك قائمة قصيرة من الأسطر تلصقها في كل مطالبة جديدة، وستخرج الجولة الأولى أقرب إلى ما قصدته. للعادات الأساسية لأي مطالبة، راجع كيفية كتابة مطالبة جيدة.