وكلاء الذكاء الاصطناعي
تستدعي عقدة agent نموذج LLM بسياق مُركَّب ومجموعة من الأدوات. وهي اللَّبِنة المركزية للذكاء الاصطناعي في betool.
ثلاثية الدور / المهمّة / الاختيار
الوكيل لا يعرف بنفسه ما يجب فعله. وثلاثة أشياء توجّهه:
- الدور (Role) — كيف يعمل (الأسلوب، القيود، الموقف). موجز. قابل لإعادة الاستخدام عبر الوكلاء.
- المهمّة (Mission) — ما يجب أن يفعله لهذه الحالة الاستخدامية تحديدًا. أطول. خاصّ بالـpipeline.
- الاختيار (Selection) — أي بيانات سياق يستقبلها كإدخال. مُركَّب صراحةً.
الوكيل الذي يسيء التصرّف يكون لديه دائمًا تقريبًا مشكلة في الدور أو المهمّة أو الاختيار — لا مشكلة في النموذج. وقبل ترقية النموذج، تحقّق من هذه الثلاثة أولًا.
تهيئة الاختيار
يحدّد الـاختيار بدقّة ما يراه نموذج LLM. وله خمسة أنواع:
| النوع | الأثر |
|---|---|
key | يقرأ ctx.results[<key>] — مثال: exchange.intent |
prefix | يدمج كل المفاتيح تحت بادئة — مثال: project.* |
literal | نصّ صِرف مع عناصر نائبة — مثال: "Question: {user_message}" |
file | يرفق ملفًا (متعدّد الوسائط) — مثال: webhook.payload._files |
history | يتضمّن الدورات الـN السابقة (متعدّد الدورات أصيل) |
تُركّب الأنواع الأربعة الأولى الـuser_message للدورة الحالية. أما history فقناة متعامدة تُمرَّر في مصفوفة messages[] الخاصة بـLLM.
لا احتياطي في وقت التشغيل. إذا كان الاختيار فارغًا، يستقبل نموذج LLM "" ويسجّل تحذيرًا. ويجب عليك تضمين كل ما يحتاجه الوكيل صراحةً — لا سحر هنا.
نموذج LLM
يُختار من النماذج المُهيَّأة في الإدارة ← النماذج. ويمكنك:
- تثبيت نموذج محدَّد (مثال:
claude-opus-4-7). - استخدام النموذج الافتراضي للمؤسسة.
- تعريف احتياطي (إذا فشل الأساسي، يُنتقَل إلى ثانوي).
الأدوات
الـأدوات هي الدوال التي يمكن لنموذج LLM استدعاؤها. تختارها من الكتالوج:
- أدوات عامة —
knowledge.search،web.fetch،compute.now… - أدوات القناة — لـpipeline صوتي:
voice.barge_in،voice.hangup،voice.transfer… - أدوات المجال — يُنشئها المشغّلون لديك (مثال:
crm.create_ticketالمعروضة عبر عقدة operator).
لا يرى الوكيل سوى الأدوات القابلة للوصول فعليًا ضمن سياق تنفيذه. فالوكيل في pipeline بريد إلكتروني لن تُعرَض عليه أداة صوتية.
تنسيق الإخراج
ثلاثة خيارات:
- نصّ حرّ — للردود الموجَّهة إلى المستخدم.
- JSON مُهيكَل — يجب أن يُنتج الوكيل JSON يطابق مخطَّطًا محدَّدًا (يُتحقَّق منه بصرامة).
- استدعاء أداة فقط — لا يكتب الوكيل شيئًا: فهو إما يستدعي أداة أو لا يفعل شيئًا.
وضع JSON إلزامي للوكلاء الذين يغذّي إخراجهم عقدة condition لاحقة أو وكيلًا آخر.
أفضل الممارسات
- صِف الأدوات بدقّة. يجب أن يغطي الوصف الذي يراه نموذج LLM: ماذا، ومتى يُستخدَم، ومتى يُتجنّب، والتنسيق. فالوصف القصير جدًا يعني أن نموذج LLM يخمّن — وهذا يعني أخطاءً غير مرئية.
- اختبر بمعيار (benchmark). راجع المعايير.
- حافظ على اتّساق المهمّة. المهمّة التي تتغيّر عبر 3 نسخ تعني وكيلًا يتراجع. أخضِع مهامك لإدارة النسخ.
التكاليف
راجع التسعير. مع BYOK، تدفع لمزوّد LLM مباشرةً. وإلا، فتوقّع نحو 30 credit لكل 1000 توكِن إدخال و90 لكل 1000 توكِن إخراج.