Agent-Lab הוא פריימוורק Python בגישת cloud-native לבנייה, סימולציה ובדיקה של סוכני LLM,
המבוסס על FastAPI, LangChain/LangGraph ו-PostgreSQL. מריצים pip install btech-agent-lab, מרחיבים את מחלקות הבסיס של הסוכנים ומרכיבים אפליקציה מוכנה לסביבת
ייצור בקריאה אחת ל-create_app() — כולל REST API, שרת MCP, שמירת נתונים, אימות
וניטור מבוסס OpenTelemetry.
התיעוד מאורגן לפי מה שמנסים לעשות, ברוח הפריימוורק של Diátaxis: הדרכות כשלומדים, מדריכים כשעובדים, חומר עזר כשצריך עובדה מדויקת. בוחרים מסלול:
| אני רוצה… | מסלול |
|---|---|
| להתחיל | הסוכן הראשון שלך ← מדריך למפתחים |
| לבנות אפליקציה | מדריך למפתחים ← חומר עזר לתצורה ← חומר עזר ל-REST API ← מדריך שרת MCP |
| להעריך ולחקור | מדריך לחוקרים ← בדיקות וסימולציות |
| לפרוס ולתפעל | מדריך פריסה ← ניטור ← Keycloak ← Vault |
| לתרום | מדריך למפתחים ← מודל הדומיין של הישויות ← תודות |
הדרכות
מוכוונות למידה: עוברים על הכול מתחילתו ועד סופו, בלי לסטות.
| עמוד | תיאור |
|---|---|
| הסוכן הראשון שלך | יצירת שלד לפרויקט, הגדרת סוכן, קריאה אליו דרך REST, צפייה ב-trace וחשיפת כלי MCP — בתוך כ-15 דקות. |
מדריכים
מוכווני עבודה: פותרים את הבעיה שעומדת מולך עכשיו.
| עמוד | תיאור |
|---|---|
| מדריך למפתחים | מדריך הדגל: שני מודלי פיתוח, תצורה, DI, בניית סוכנים וכל נקודות ההרחבה. |
| שרת MCP | חשיפת סוכנים ללקוחות MCP (Claude Desktop, MCP Inspector); הוספת כלים ופרומפטים. |
| בדיקות וסימולציות | חבילת בדיקות אינטגרציה עם testcontainers; סימולציות סוכנים בשיטת LLM-as-judge עם Langfuse/LangWatch. |
| מדריך לחוקרים | מחברות Jupyter, ניסויים ובניית אבות-טיפוס להתנהגויות סוכנים חדשות. |
| פריסה | סביבות Docker Compose מקומיות ו-Kubernetes לסביבת ייצור עם Terraform ו-Helm. |
| אימות עם Keycloak | הגדרת realm, לקוח וחשבון שירות; תהליכי הטוקנים שה-API מצפה להם. |
| סודות עם Vault | כיצד סודות התצורה נשמרים, נשלפים ומתחלפים. |
| ניטור עם Grafana · עם OpenSearch | דשבורדים לדוגמה עבור שתי סביבות הניטור המצורפות. |
חומר עזר
עובדות בלבד: מדויקות, מלאות ומופקות מהקוד.
| עמוד | תיאור |
|---|---|
| חומר עזר לתצורה | כל מפתחות התצורה ומשתני הסביבה, ואופן הבחירה של ה-ConfigSource הפעיל. |
| REST API | הקטלוג המלא של נקודות הקצה, עם דוגמאות לבקשות ולתגובות. |
| מודל הדומיין של הישויות | ישויות, קשרים ושלושת מסדי הנתונים של PostgreSQL. |
פרויקט
מה הלאה?
חדשים ב-Agent-Lab? כדאי להתחיל עם הסוכן הראשון שלך — מדריך מלא שאפשר להעתיק ולהדביק ממנו, שמסתיים בסוכן פועל שאפשר לשוחח איתו דרך REST ו-MCP.