تستدعي عقدة 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
يُختار من النماذج المُدارة الخاصة بالمنصّة أو من حسابات LLM المُهيَّأة في الإعدادات ← المزودون (راجع ربط مفتاح LLM). ويمكنك:
- تثبيت نموذج محدَّد من الكتالوج (مُدار أو على حسابك الخاص).
- استخدام النموذج الافتراضي للمؤسسة.
- تعريف احتياطي (إذا فشل الأساسي، يُنتقَل إلى ثانوي).
الأدوات
الـأدوات هي الدوال التي يمكن لنموذج LLM استدعاؤها. تختارها من الكتالوج:
- أدوات عامة —
knowledge.searchوknowledge.semantic_search(قاعدة المعارف)،web_search.search(البحث على الويب)،web_scrape.fetch_page(قراءة صفحة ويب)… - أدوات القناة — لـpipeline صوتي:
phone_gateway.transfer_call،phone_gateway.hangup_call،phone_gateway.set_call_disposition. - أدوات الموصِّلات — أدوات التكاملات التي ربطتها مؤسستك (مثال:
jira.create_issue،hubspot.search_contacts).
لا يرى الوكيل سوى الأدوات القابلة للوصول فعليًا ضمن سياق تنفيذه. فالوكيل في pipeline بريد إلكتروني لن تُعرَض عليه أداة هاتفية.
تنسيق الإخراج
ثلاثة خيارات:
- نصّ حرّ — للردود الموجَّهة إلى المستخدم.
- JSON مُهيكَل — يجب أن يُنتج الوكيل JSON يطابق مخطَّطًا محدَّدًا (يُتحقَّق منه بصرامة).
- استدعاء أداة فقط — لا يكتب الوكيل شيئًا: فهو إما يستدعي أداة أو لا يفعل شيئًا.
وضع JSON إلزامي للوكلاء الذين يغذّي إخراجهم عقدة condition لاحقة أو وكيلًا آخر.
أفضل الممارسات
- صِف الأدوات بدقّة. يجب أن يغطي الوصف الذي يراه نموذج LLM: ماذا، ومتى يُستخدَم، ومتى يُتجنّب، والتنسيق. فالوصف القصير جدًا يعني أن نموذج LLM يخمّن — وهذا يعني أخطاءً غير مرئية.
- اختبر بمعيار (benchmark). راجع المعايير.
- حافظ على اتّساق المهمّة. المهمّة التي تتغيّر عبر 3 نسخ تعني وكيلًا يتراجع. أخضِع مهامك لإدارة النسخ.
التكاليف
راجع التسعير. مع BYOK، تدفع لمزوّد LLM مباشرةً. أمّا على نموذج مُدار، فتُخصَم توكِنات الإدخال والإخراج بالأرصدة وفق جدول أسعار النموذج المختار.