المحرّر المرئي

الـpipeline في betool هو رسم بياني من العُقد تجمّعه في المحرّر المرئي. وتعلن كل عقدة عمّا تستهلكه وما تُنتجه؛ ويرفض المحرّر الاتصالات غير المتوافقة قبل تشغيل الـpipeline أصلًا.

بنية الـpipeline

[Start]──▶[agent]──▶[condition]──┬──▶[agent]
                                 └──▶[operator HTTP]

• تعلن عقدة Start عن قناة الإدخال التي تُشغّل الـpipeline.
• تستقبل كل عقدة لاحقة السياق من العُقد السابقة (خانات المُنتِج / المُستهلِك).
• يُنشئ الشرط فروعًا؛ وكل الفروع تُنتج في النهاية نتيجة قابلة للتتبّع.

المفاهيم الأساسية

الخانة (Slot)

الـخانة قطعة بيانات مُسمّاة تتدفّق بين العُقد. مثلًا: يمكن لعقدة agent أن تُنتج exchange.intent: "refund_request"، تستهلكها عقدة condition لاحقة.

عائلتان:

• المُنتِجون (Producers) — ما تُخرجه العقدة (fixed_key، configurable_key).
• المُستهلِكون (Consumers) — ما تقبله العقدة كإدخال (selector، selector_list).

العقد (Contract)

يعرض كل نوع عقدة عقدًا مُعلَنًا على جانب الخادم. ويقرأ المحرّر هذا العقد ليقترح الاتصالات الصالحة فقط.

التهيئة

للعقدة أيضًا معاملات ثابتة (تهيئتها) — بالنسبة إلى عقدة agent مثلًا: دورها، ومهمّتها، وأدواتها، ونموذج LLM الخاص بها.

إنشاء pipeline

1. مصمّم ← Pipelines ← pipeline جديد.
2. تُفتَح لوحة العمل بعقدة Start فارغة. هيّئها لاختيار قناة الإدخال.
3. اسحب العُقد من لوحة الأدوات على اليسار: agent، operator، condition…
4. اربط المخرجات بالمدخلات. لا يسمح المحرّر إلا بالروابط المتوافقة.
5. انقر على عقدة لفتح تهيئتها في اللوحة على اليمين.
6. اختبر — يشغّل تبويب الاختبار الـpipeline على exchange مُصاغ يدويًا.
7. انشر — يُنشئ نسخة جديدة. وتُوجَّه الـexchanges الواردة إلى أحدث نسخة؛ وتتابع عمليات التنفيذ الجارية على نسختها الخاصة.

إدارة النسخ (Versioning)

كل تغيير منشور يُنشئ نسخة جديدة. ويمكنك:

• مقارنة نسختين (فرق مرئي).
• إعادة تشغيل exchange سابق على نسخة جديدة.
• التراجع إلى نسخة سابقة.

التحقق المستمرّ

يشغّل المحرّر مُدقِّقًا باستمرار:

• خانات مطلوبة غير موصولة ← تحذير يظهر على العقدة.
• دورات غير محدودة ← خطأ (يُحجَب النشر).
• قدرات غير متوافقة (مثلًا وكيل يستدعي أداة صوتية داخل pipeline بريد إلكتروني) ← تحذير.
• حقول تهيئة مفقودة ← خطأ.

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