אפליקציות Agent-Lab חולקות מודל דומיין אחד, המוגדר ב-agent_lab/domain/. אותו מודל
משמש את סכמות ה-REST API, את שכבת השמירה ואת סביבת הריצה של הסוכנים — לומדים אותו פעם
אחת ויודעים מה כל נקודת קצה קוראת וכותבת.
ישויות
| ישות | מה היא מייצגת |
|---|---|
| Agent | מופע של סוכן LLM — agent_name, agent_type (מאומת מול הרישום), דגל פעיל וחותמות זמן. מימוש אחד, מופעים מוגדרים רבים. |
| AgentSettings | תצורת מפתח-ערך של מופע סוכן: פרומפטים (תבניות Jinja2), שמות אוספים, temperature וערכים מותאמים אישית. עד 16,000 תווים לכל ערך — כאן מכווננים את התנהגות הסוכן דרך POST /agents/update_setting. |
| LanguageModel | מודל שפה הזמין לסוכנים, יחד עם החיבור לספק שלו. |
| LanguageModelSettings | פרמטרים לכל מודל (temperature, max tokens, …), המנוהלים דרך נקודות הקצה /llms. |
| Integration | אינטגרציה חיצונית (לדוגמה ספק AI) והתצורה שלה. סודות נשמרים ב-Vault, ולעולם לא במסד הנתונים. |
| Message | תור אחד בשיחה: תפקיד (human / assistant / tool), תוכן, response_data וקישורי שרשור (replies_to). נשמר יחד עם הזיכרון של הסוכן באמצעות checkpoints של LangGraph. |
| Attachment | קובץ המצורף להודעה: תוכן גולמי, תוכן מפוענח והפניה לאוסף ה-embeddings המשמש לאחזור. |
דוגמה להגדרות סוכן שמורות — פרומפטים וערכים מותאמים אישית עבור סוכן התזכירים הקוליים — מתוך notebooks/08_test_agent_type-multiagent-voice-assistant.ipynb:
היכן הנתונים נשמרים
Agent-Lab משתמש ב-שלושה מסדי נתונים של PostgreSQL (וגם ב-Redis) — שמוקמים לפי
מדריך הפריסה ומוגדרים דרך db.url, db.vectors ו-db.checkpoints
(ראו חומר העזר לתצורה):
| מאגר | תוכן |
|---|---|
db.url |
נתונים רלציוניים: סוכנים, הגדרות, מודלים, אינטגרציות, הודעות, קבצים מצורפים |
db.vectors |
embeddings של pgvector — חיפוש וקטורי ואחזור (/attachments/embeddings) |
db.checkpoints |
נתוני checkpoints של LangGraph — זיכרון הסוכן לאורך אינטראקציות |
Redis (broker.url) |
broker של pub/sub לעדכוני סטטוס בפעולות ארוכות; משמש גם לאחסון לקוחות OAuth של MCP |
אבטחה וניהול סודות
סודות — פרטי התחברות של אינטגרציות, מפתחות API של מודלים ומטען התצורה עצמו — מנוהלים באמצעות Vault. מסד הנתונים שומר הפניות; הערכים הרגישים נשלפים מ-Vault בעת העלייה ולפי דרישה. ראו סודות עם Vault ואת חומר העזר לתצורה.