متى يستحق الوكيل

طريقان إلى نفس الفكرة

قبل أن تبدأ

الفكرة الجوهرية

لكل نظام ثلاث درجات تختار منها: استدعاء واحد، ثم سلسلة ثابتة، ثم وكيل. في هذا الدرس ترى كل درجة ومتى تكفي، ثم تحسب ثمن الحرية.

1الدرجة الأولى: استدعاء واحد

أغلب المهام تحويل واحد: تصنيف، أو تلخيص، أو استخراج، أو ترجمة. قالب جيد واستدعاء واحد يحلّها، وهذا أرخص وأسرع وأسهل في الاختبار.

انظر إلى الرسم: الرسالة تدخل، والنموذج يُستدعى مرة واحدة، ثم يقرّر كودك بجملة if بسيطة ماذا يفعل بالنتيجة.

النموذج هنا لا يختار أي خطوة. هو يحوّل نصًّا إلى نص، وكودك يملك كل ما بعده.

2الدرجة الثانية: سلسلة ثابتة

حين تعرف الخطوات وترتيبها مسبقًا، اكتبها كودًا. كل خطوة استدعاء أو كود عادي، والسلسلة نفسها كود تختبره خطوة خطوة.

مهمة تُبنى كثيرًا كوكيل: «أين طلبي؟». خطواتها معروفة دائمًا، فنكتبها كودًا.

import re

def extract_order_id(message):
    m = re.search(r"\b(\d{5})\b", message)
    return m.group(1) if m else None

ORDERS = {"48213": {"status": "shipped", "eta": "Thursday"}}

def lookup(order_id):
    return ORDERS.get(order_id)

def reply(message):
    order_id = extract_order_id(message)          # step 1: in production, one small model call
    if not order_id:
        return "Please send your 5-digit order number."
    order = lookup(order_id)                      # step 2: plain code, no model
    if not order:
        return f"I could not find order {order_id}."
    return f"Order {order_id} is {order['status']}, arriving {order['eta']}."   # step 3: a template

for msg in ["where is my order 48213?", "where is my order?", "status of 11111 please"]:
    print(f"{msg!r:32} -> {reply(msg)}")

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

اسأل نفسك: هل أستطيع رسم مخطّط سير لهذه المهمة؟ إن استطعت، فالمخطّط هو الكود ولا تحتاج وكيلًا.

3الدرجة الثالثة: وكيل حقيقي

الوكيل نموذج يقرّر بنفسه أي أداة يستدعي وكم مرة. تحتاجه فقط حين لا تعرف عدد الخطوات ولا ترتيبها، وتعتمد كل خطوة على نتيجة السابقة.

انظر إلى الرسم: النموذج يختار أداة، ويقرأ نتيجتها، ثم يختار من جديد. الدورة لا تُرسم مسبقًا لأنها تتغيّر مع كل حالة.

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

4ثمن الحرية

الحرية لها ثمن: رموز أكثر، وزمن أطول، وسلوك يتغيّر بين تشغيلين، واختبار أصعب بكثير. الرموز أسهل ما يُقاس منها، فلنحسبها.

system_and_tools = 1200      # tokens sent with every call
per_step = 400               # each step adds a tool call and its result to the history

def agent_tokens(steps):
    total, history = 0, 0
    for _ in range(steps):
        total += system_and_tools + history
        history += per_step
    return total

one_call = system_and_tools + 300
print(f"one call:          {one_call:>7,} input tokens")
for steps in [3, 10, 25]:
    print(f"agent, {steps:2} steps:   {agent_tokens(steps):>7,} input tokens")

استدعاء واحد 1500 رمز. وكيل بعشر خطوات 30 ألفًا، عشرون ضعفًا، وبخمس وعشرين خطوة 150 ألفًا. النمو تربيعي تقريبًا لأن كل خطوة تعيد إرسال ما قبلها. والتخزين المؤقت للبداية المتكرّرة يخفّف السعر لكنه لا يلغي الزمن. هذا ما تدفعه مقابل أن يقرّر النموذج الطريق بنفسه.

كيف يعمل، خطوة بخطوة: كيف تختار بين استدعاء وسلسلة ووكيل

مثال محلول

قبل أن تبني وكيلًا، احسب ثمنه. في كل خطوة يرسل الوكيل رسالة النظام ووصف الأدوات، ومعها كل ما حدث في الخطوات السابقة. فالتاريخ يكبر مع كل خطوة، والتكلفة تكبر أسرع منه.

جرّب بلا كود

خرافة مقابل حقيقة

جرّب بنفسك

بطاقات مراجعة سريعة

تحقق من فهمك