كيف تبني أول وكيل ذكاء اصطناعي لك: نموذج، وبعض الأدوات، وحلقة

يبدو مصطلح "وكيل الذكاء الاصطناعي" كأنه يستلزم إطار عمل، وقاعدة بيانات متجهية (vector database)، وعطلة أسبوعية كاملة للإعداد. لكنه لا يستلزم ذلك. فتعريف Anthropic نفسه صغير على نحوٍ منعش: الوكيل هو نموذج لغوي كبير يستخدم الأدوات بشكل مستقل داخل حلقة. وبمجرد أن ترى النمط، يمكنك بناء وكيل أول مفيد في أقل بكثير من مئة سطر من الشيفرة — وبالقدر نفسه من الأهمية، أن تعرف متى لا ينبغي لك ذلك.

الحلقة الأساسية

كل وكيل، مهما بلغ تعقيده، هو الدورة نفسها المكوّنة من أربع خطوات:

1. تمنح النموذج هدفًا وقائمة بالأدوات المسموح له باستدعائها.
2. يقرّر النموذج ما إذا كان سيجيب مباشرة أم سيستدعي أداة.
3. تشغّل شيفرتك الأداة وتعيد النتيجة إلى النموذج.
4. كرّر حتى يقول النموذج إنه انتهى.

لا يلمس النموذج نظام ملفاتك أو شبكتك بنفسه أبدًا. كل ما يفعله هو أنه يطلب تشغيل أداة؛ وشيفرتك هي التي تقرّر ما إذا كانت ستنفّذ ذلك فعلًا وكيف. تلك الفجوة هي حيث يكمن كل أمانك.

مثال ملموس

إليك وكيلًا أدنى قادرًا على الإجابة عن الأسئلة باستخدام أداة آلة حاسبة. البنية هي ما يهمّ — فالشكل نفسه يتوسّع ليشمل تحرير الملفات، أو البحث على الويب، أو استعلامات قواعد البيانات.

import anthropic

client = anthropic.Anthropic()

tools = [{
    "name": "calculator",
    "description": "Evaluate a basic arithmetic expression and return the result.",
    "input_schema": {
        "type": "object",
        "properties": {"expression": {"type": "string"}},
        "required": ["expression"],
    },
}]

def run_tool(name, args):
    if name == "calculator":
        # In real code, use a safe parser, not eval()
        return str(eval(args["expression"], {"__builtins__": {}}))
    return "unknown tool"

messages = [{"role": "user", "content": "What is 1894 * 37 plus 12?"}]

while True:
    resp = client.messages.create(
        model="claude-sonnet-4-6",
        max_tokens=1024,
        tools=tools,
        messages=messages,
    )
    messages.append({"role": "assistant", "content": resp.content})

    if resp.stop_reason != "tool_use":
        print(resp.content[0].text)
        break

    tool_results = []
    for block in resp.content:
        if block.type == "tool_use":
            result = run_tool(block.name, block.input)
            tool_results.append({
                "type": "tool_result",
                "tool_use_id": block.id,
                "content": result,
            })
    messages.append({"role": "user", "content": tool_results})

حلقة while هذه هي الوكيل. يرى النموذج السؤال، ويطلب استدعاء calculator مع "1894 * 37 + 12"، فتشغّله شيفرتك، وتعيد إليه 70090، ثم يكتب النموذج الإجابة النهائية. استبدل الآلة الحاسبة بزوج من read_file/write_file وستحصل على وكيل برمجة بدائي.

الأدوات هي الجزء الذي يهمّ فعلًا

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

• سمِّ الأدوات وصِفها كما لو كنت تكتب لزميل جديد في الفريق. فـ search_invoices(customer_id, date_range) أفضل من query(sql) الغامض — فكلّما كان العقد أوضح، قلّت الاستدعاءات الخاطئة.
• أعِد نتائج عالية الإشارة، لا مخرجات خامة. إذا أعادت أداة 5000 سطر من JSON، فأنت بذلك قد أنفقت ميزانية سياق النموذج على الضجيج. اقتطعها إلى ما هو مفيد.
• اجعل الأخطاء تعليمية. فعبارة "الملف غير موجود: هل تقصد config.yaml؟" تتيح للنموذج التعافي؛ أما تتبّع المكدّس (stack trace) المجرّد فلا يفعل ذلك عادة.

ضوابط الأمان قبل أن تتركه يعمل

لأن شيفرتك هي التي تنفّذ كل استدعاء أداة، فأنت من يملك مسؤولية الأمان. إليك ثلاثة ضوابط ينبغي إضافتها قبل أن يلمس أي وكيل شيئًا حقيقيًا:

• حُدّ من الحلقة. أضِف حدًّا أقصى لعدد التكرارات حتى لا يدور وكيل مرتبك إلى الأبد (ويُراكم فاتورة).
• اضبط بوابةً على الإجراءات المدمِّرة. أي شيء يحذف أو يرسل أو يدفع ينبغي أن يستلزم تأكيدًا أو أن يُنفَّذ أولًا في بيئة معزولة (sandbox).
• تحقّق من مدخلات الأدوات. لا تستخدم أبدًا eval() على سلاسل غير موثوقة ولا تمرّر مخرجات النموذج مباشرة إلى صدفة (shell). عامِل كل وسيط أداة بوصفه مدخلًا غير موثوق من المستخدم — لأنه كذلك عمليًا.

متى لا تبني وكيلًا

أنفع ما يمكن تعلّمه مبكرًا: كثير من المسائل لا تحتاج إلى وكيل على الإطلاق. إذا كانت الخطوات معروفة سلفًا — جلب البيانات، وتلخيصها، وإرسال الملخّص بالبريد — فإن نصًّا برمجيًا بسيطًا باستدعاء أو اثنين للنموذج يكون أرخص وأسرع وأسهل في تصحيح الأخطاء. تسمّي Anthropic هذه سير العمل (workflows)، وتوصي بها كلّما كان المسار قابلاً للتنبؤ. لا تلجأ إلى وكيل حقيقي إلا عندما يحتاج النموذج فعلًا إلى أن يقرّر ما يفعله تاليًا بناءً على ما يكتشفه.

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