بناء الوكلاء على الواجهة البرمجية (API)
الوكيل هو نموذج يعمل ضمن حلقة: يسعى لتحقيق هدف عبر استدعاء الأدوات، ومراقبة النتائج، واتخاذ قرار الخطوة التالية حتى الانتهاء. قبل أن تبني وكيلًا، اختر أبسط شيء يؤدّي الغرض.
اختبار اتخاذ القرار (لا تُفرط في البناء)
- استدعاء واحد — مطالبة واحدة تجيب عنه. معظم المهام. الأرخص والأكثر موثوقية.
- سير عمل — أنت تنسّق تسلسلًا ثابتًا من الاستدعاءات في الشيفرة (تدفّق تحكّم حتمي). استخدمه عندما تكون الخطوات معروفة.
- وكيل — النموذج يقرّر الخطوات ديناميكيًا. استخدمه فقط عندما يتعذّر فعلًا ترميز المسار بشكل ثابت.
لجأ إلى الوكيل عندما تكون القابلية للتكيّف هي الهدف — لا لأنه يبدو مبهرًا. سير العمل الذي تتحكّم به أسهل في الاختبار وتصحيح الأخطاء.
تصميم الحلقة
وكيل مخصّص بحدّه الأدنى:
- مطالبة النظام (System prompt): الهدف، والقيود، والأدوات المتاحة.
- الحلقة: أرسل الرسائل ← إذا ظهر
tool_use، شغّل الأداة، وأضفtool_result، وكرّر ← حتى الوصول إلى إجابة نهائية أو شرط توقّف. - الضوابط الوقائية: حدّ أقصى للتكرارات، وميزانية للرموز/التكلفة، والتحقّق من مدخلات الأدوات.
- إدارة السياق: لخّص/قلّص مع نموّ السجلّ (الفكرة ذاتها الواردة في إدارة السياق).
تمنحك حزمة Claude Agent SDK هذه الحلقة — الأدوات، والصلاحيات، ومعالجة السياق — جاهزة بالكامل، حتى لا تبنيها يدويًا بنفسك.
اجعله متينًا
- حُدّ كل شيء: التكرارات، والوقت، والتكلفة. فالوكلاء قد يدخلون في حلقة لا تنتهي.
- عالِج أعطال الأدوات بسلاسة (أعِد الخطأ كنتيجة).
- أقل صلاحية ممكنة + تدخّل بشري للإجراءات الخطرة — راجع تأمين الوكلاء.
- قيّمه على حالات حقيقية قبل الوثوق به — راجع التقييمات.