כיצד להשתמש ב-Letta: מדריך מעשי לבניית סוכני AI בעלי מצב
אם אי פעם רציתם שלסוכן ה-AI שלכם תהיה יכולת לזכור הקשר בין סשנים, לתזמר כלים באופן מהימן ולהתפתח ללא סקריפטים מאולתרים, Letta נבנה בדיוק בשביל זה. להלן מדריך מעשי, צעד אחר צעד, שיעזור לכם להגדיר את Letta, לבנות את הסוכן העקבי הראשון שלכם ולשחרר תהליכי עבודה שבאמת מחזיקים מעמד.
חשוב לציין: בעבר, Letta הייתה מקושרת לפרויקט MemGPT ומאז התפתחה לפלטפורמה מלאה עם ערכות SDK וסביבת פיתוח סוכנים (ADE) ויזואלית. תוכלו למצוא התחלות מהירות ותיעוד רשמי לעקוב אחריהם, סרטון מבוא קצר שמדריך אתכם ביצירת סוכן עקבי, ופוסט הכרזה עבור ADE אם אתם מעדיפים ממשק משתמש בעל קוד נמוך. לרקע קונספטואלי מעמיק יותר על סוכנים בעלי מצב ב-Letta, ראו סקירת הסוכנים. אם אתם סקרנים לגבי השינוי משם MemGPT ל-Letta ושינויי החבילות, הערות חבילת ה-Python מועילות והמאגר בקוד פתוח מספק את הקשר הארכיטקטורה.
מדריך זה עוקב אחר סגנון מעשי ומכוון פתרונות: מינימום סרבול, הרבה שלבים ניתנים להעתקה-הדבקה והחלטות ברורות בכל שלב.
מה זה Letta (ולמה זה משנה)?
Letta היא פלטפורמה לבניית סוכני AI בעלי מצב - סוכנים ששומרים זיכרון לטווח ארוך, מנהלים כלים ושומרים על המצב שלהם בין שיחות. במקום מעטפת צ'אט חסרת מצב, אתם מקבלים זמן ריצה מובנה שבו סוכן יכול:
- לשמור על מאגר זיכרון ולאחזר הקשר רלוונטי באופן אוטומטי.
- לקרוא לכלים (פונקציות, ממשקי API, וו-בקים) עם כניסות שאוכפות סכמה.
- לשמור ולגרס את התצורה שלו.
- לרוץ בענן או באופן מקומי עם ערכות SDK (Python/TypeScript) או באמצעות סביבה ויזואלית בעלת קוד נמוך (ADE).
זה אומר שאתם יכולים לבנות סוכנים לתמיכת לקוחות, עוזרי מחקר, פעולות נתונים, פעולות מוצר או אוטומציה פנימית שאינם "שוכחים" את הפרויקט באמצע.
עץ החלטות מהיר: מאיפה כדאי להתחיל?
- אני מפתח שמעדיף קוד ← השתמשו בהתחלה המהירה של ה-SDK (Python או TypeScript).
- אני רוצה ליצור אב טיפוס באופן ויזואלי, ואז לייצא לקוד ← השתמשו ב-ADE ובסקירת הסוכנים.
- אני צריך הקשר על הארכיטקטורה וההיסטוריה ← עיינו במאגר/readme ובהערות החבילה.
- אני מעדיף סרטון קצר ומודרך ← צפו במבוא.
התקנה: מאפס לסוכן ראשון (נתיב קוד)
הנה הנתיב המהיר ביותר באמצעות ה-SDK (מוצג Python; TypeScript דומה בתיעוד).
- התקינו את חבילת
letta לפי התיעוד. ודאו שמפתח ה-API שלכם או אישורי השרת המקומיים מוגדרים באמצעות משתני סביבה (למשל, LETTA_API_KEY).
- הגדירו את הנחיית המערכת (תפקיד), אסטרטגיית הזיכרון ורשימת הכלים של הסוכן שלכם. ההתחלה המהירה מציגה דוגמה עובדת מינימלית.
- אפשרו זיכרון עקבי והגדירו כיצד הסוכן כותב/קורא ממאגר הזיכרון שלו. סקירת הסוכנים מסבירה כיצד Letta מאחסנת מצב וכיצד סוכנים נשמרים בשרת.
- הוסיפו כלים (קריאה לפונקציות)
- </a25><a64>- גבשו את חוקי ההפעלה שלכם. השתמשו בעדיפויות מפורשות: "תמיד תעשו את X לפני Y."
- הריצו משימות קצרות (למשל, "סכמו את שרשור הלקוחות הזה וצרו כרטיס פתרון"). בדקו יומנים ועקבות זיכרון כדי לאמת את ההתנהגות.
- בחרו בין זמן ריצה מקומי לפיתוח והתקנה מארחת עבור בימוי/ייצור. גרסו את תצורות הסוכנים והכלים שלכם תוך כדי תנועה.
דוגמה: שרטוט סוכן מינימלי (פסאודו-Python)
afrom letta import Client, Agent, Tool
client = Client(api_key=os.environ.
## שימוש ב-Letta ADE (נתיב ללא קוד/קוד נמוך)
אם אתם מעדיפים יצירת אב טיפוס ויזואלית, ה-ADE מאפשר לכם להרכיב סוכנים, זיכרון וכלים מבלי לכתוב קוד.
- התחילו פרויקט סוכן חדש ב-ADE.
- הגדירו את התפקיד (הנחיית המערכת), הטון והגבולות של הסוכן.
- הגדירו עקביות זיכרון ואסטרטגיות אחזור.
- הוסיפו כלים על ידי בחירה ממחברים או הגדרת פעולות מותאמות אישית.
- בדקו שיחות בתוך השורה, התבוננו בכתיבת זיכרון, התאימו ספים.
- ייצאו או העבירו למפתחים ברגע שאב הטיפוס שלכם מתנהג כהלכה.
ראו את הכרזת ה-ADE ואת המדריך להסבר וסרטון מבוא מהיר.
## עיצוב סוכני Letta נהדרים: שיטות עבודה מומלצות מוטות
1) התחילו עם העבודה שיש לבצע
- הגדירו היקף צר (למשל, "מיון כרטיסי תמיכה עבור שגיאות אינטרנט"), לא מומחה כללי מעורפל.
2) קידדו נהלי הפעלה
<a24>- הכניסו את נהלי התפעול הסטנדרטיים שלכם להנחיית המערכת. דוגמה: "כאשר מיון מצביע על השפעה על הייצור, הסלימו והגדירו עדיפות=גבוהה. תמיד כללו שלבי שכפול אם זמינים."
