עורך הצינורות הויזואלי
pipeline ב-betool הוא גרף של צמתים שאתם מרכיבים בעורך הויזואלי. כל צומת מצהיר מה הוא צורך ומה הוא מייצר; העורך דוחה חיבורים לא תואמים עוד לפני שהפעלתם את ה-pipeline.
אנטומיה של pipeline
[Start]──▶[agent]──▶[condition]──┬──▶[agent]
└──▶[operator HTTP]
- הצומת Start מצהיר איזה ערוץ קלט מפעיל את ה-pipeline.
- כל צומת שבזרם מקבל את הקונטקסט מהצמתים שלפניו (slots producers / consumers).
- תנאי יוצר ענפים; כולם בסופו של דבר מייצרים תוצאה שניתן לאתר.
מושגי יסוד
Slot
slot הוא נתון בעל שם שעובר בין הצמתים. לדוגמה: צומת agent יכול לייצר exchange.intent: "demande_remboursement", וצומת תנאי שבזרמו צורך את אותו slot.
שתי משפחות:
- Producers — מה שצומת מייצר כפלט (
fixed_key,configurable_key). - Consumers — מה שצומת מקבל כקלט (
selector,selector_list).
חוזה
כל סוג צומת חושף חוזה שמוצהר בצד השרת. העורך קורא חוזה זה כדי להציע רק חיבורים תקינים.
תצורה
לצומת יש גם פרמטרים סטטיים (התצורה שלו) — לדוגמה, עבור צומת agent: התפקיד, המשימה, ה-tools, מודל ה-LLM.
יצירת pipeline
- מעצב ← Pipelines ← Pipeline חדש.
- הבד (canvas) נפתח עם צומת Start ריק. הגדירו אותו כדי לבחור את ערוץ הקלט.
- גררו צמתים מלוח הצד: agent, operator, condition...
- חברו פלטים לקלטים. העורך מאפשר רק קישורים תואמים.
- לחצו על צומת כדי לפתוח את התצורה שלו בפאנל הימני.
- בדיקה — לשונית ה-Test מריצה את ה-pipeline על exchange שנוצר ידנית.
- פרסום — יוצר גרסה חדשה. exchanges נכנסים עוברים לגרסה העדכנית ביותר; ביצועים בתהליך ממשיכים על הגרסה שלהם.
ניהול גרסאות
כל שינוי שפורסם יוצר גרסה. ניתן:
- להשוות שתי גרסאות (diff ויזואלי).
- להריץ מחדש exchange ישן על גרסה חדשה.
- לבצע rollback לגרסה קודמת.
אימות מתמשך
העורך מריץ תמיד validator:
- slots לא מחוברים אך נדרשים — warning גלוי על הצומת.
- מחזורים לא חסומים — שגיאה (לא ניתן לפרסם).
- יכולות לא תואמות (למשל, agent שקורא ל-tool קולי בתוך pipeline של אימייל) — warning.
- שדות תצורה חסרים — שגיאה.
כתוצאה מכך: pipeline שמתפרסם הוא מובטח כתקין מבנית. שגיאות בזמן ריצה נובעות אך ורק מלוגיקה עסקית (קריאת API חיצונית שנכשלה, parsing בלתי צפוי), לא מהרכבה שגויה.