Geyser SDK · 0.3.4

לבנות אפליקציות שמפעילות Agents

אפשר להוסיף Agents לתוכנה שהצוות או הלקוחות שלך כבר משתמשים בה. הם יכולים לבדוק בקשה, לכתוב תקציר או להציע שינוי, ואז להחזיר תוצאה שהאפליקציה שלך יודעת לעבוד איתה.

"אפשר לספר לי מה המשימה, באיזה פורמט להחזיר את התוצאה ומה המגבלה. אחזיר תוצאה שהאפליקציה שלך יכולה להשתמש בה."

Otis

לעזור לתמיכה לפצח פנייה מסובכת

עוזרים למישהו בצוות התמיכה להבין פנייה קשה ולנסח תשובה. הדוגמה לתמיכה ממיינת את פרטי הפנייה שמעבירים לה, מבקשת מ-⁠Agent לבדוק את הרקע, ואז בודקת את המקורות שה-⁠Agent מצטט.

האפליקציה שלך מטפלת בחיבור למערכת התמיכה ומעבירה את הרשומות. הדוגמה כותבת טיוטה, ואדם מחליט אם היא נכונה ואם לשלוח אותה.

לנסות את הדוגמה לתמיכה

להפוך מחקר לתדריך שאנשים יכולים להשתמש בו

אפשר לבנות משהו שעוזר לצוות מכירות להתכונן לשיחה עם לקוח, או עוזר לחוקרת להיכנס מהר לנושא. מעבירים את ההערות והמסמכים ומבקשים מ-⁠Agent סיכום עם הפניות.

כדאי להתחיל מהדוגמאות של סקירת Agent ובדיקת מקורות. הן תופסות הפניות שחסרות או מומצאות, אבל כדאי שגם הסקירה שלך תבדוק את העובדות.

לנסות את אבני הבניין למחקר

שלב אישור בכלי תפעול

נותנים ל-⁠Agent להציע שינוי ברשומה, להראות לאדם מה יקרה ולחכות להחלטה שלו. זה מתאים לכלים פנימיים שבהם הצוות בודק שינויים לפני שהם עוברים.

הדוגמאות לרשומה מאושרת רצות מול מסד נתונים לדוגמה או סביבת עבודה זמנית של Agent, והן מכסות אישור והתאוששות מתשובה שנקטעה. כל חיבור למערכת עסקית אמיתית מגיע מהאפליקציה שלך.

לנסות עדכון מאושר

כלים שנבנים סביב הדרך שבה הצוות שלך עובד

אפשר ליצור עוזר להצעות או כלי להעברת פרויקטים שפועל לפי ההנחיות של הצוות. אורזים את השלבים והרקע שהוא צריך, ואפשר להשתמש באותה גישה גם בעבודה הבאה.

Agent Bundle שומר יחד הוראות, מיומנויות והקשר נייד. כל הרצה עדיין כפופה להרשאות של סביבת העבודה כפי שהן באותו רגע, ומבקשת אישור מחדש לפני כל דבר משמעותי.

לארוז תהליך עבודה לשימוש חוזר
למה לבנות על Geyser?

להשקיע את הזמן באפליקציה בזמן ש-⁠Geyser עוקב אחרי העבודה

האפליקציה שלך אחראית על הממשק ועל החיבורים שלה לשירותים אחרים. Geyser עוקב במקום אחד, בתוך סביבת העבודה של הלקוח, אחרי המשימה של ה-⁠Agent, כולל ההתקדמות, התקציב, ההרשאות, בקשות האישור והתוצאה.

אם החיבור נופל, מתחברים מחדש לאותה משימה. אפשר להראות לאנשים עבודה שמחכה להחלטה, ולקבל תוצאות בפורמט שהאפליקציה שלך מצפה לו. כל זה משתלם כשמשימה כוללת כמה שלבים או צריכה פיקוח. להמרת טקסט פשוטה, ייתכן שקריאה ישירה למודל או פונקציה רגילה הן כל מה שצריך.

לבנות אפליקציה עם ה-⁠SDK
  1. 1
    לתת לו משימה

    מעבירים מידע שמותר להשתמש בו, את הפורמט שרוצים לקבל בחזרה ומגבלות של זמן והוצאות.

  2. 2
    להתחיל את המשימה

    משתמשים שוב באותו מזהה פעולה, כדי שהאפליקציה שלך תוכל למצוא את המשימה שוב אם החיבור נופל.

  3. 3
    לעקוב אחרי העבודה

    לקרוא את ההתקדמות, ולהציג לאנשים כל בקשה לאישור או לעזרה בהשלמת פעולה שנקטעה.

  4. 4
    להשתמש בתוצאה

    שולפים את התוצאה השמורה מסביבת העבודה של הלקוח, ובודקים אותה לפני שמשתמשים בה.

להתחיל מדוגמה קטנה שעובדת

להריץ את הכלי הראשון על המכונה שלך

כותבים כלי Python שמקבל JSON, מריצים אותו על קלטי הדוגמה ובודקים מה יוצא. המדריך המהיר מריץ את הקוד האמיתי שלך בסביבה מוגבלת, יחד עם בדיקה שדוחה קלט לא תקין, ולא צריך חשבון כדי לנסות.

המדריך המהיר מקוד המקור המתויג צריך Python 3.11 ומעלה ו-⁠sandbox נתמך, כלומר sandbox-exec של macOS או bubblewrap של Linux עם user namespaces מותרים. אחרי ההתקנה, ה-⁠handler לא משתמש במודל, בגישה לרשת או בהרשאות גישה.

להבין את חוזה ההרחבות
גרסה מתויגת 0.3.4 · הרצה מקומית
git clone --branch v0.3.4 --depth 1 https://github.com/geyserlabs/geyser-open.git
cd geyser-open
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e ./sdk/python -e ./cli
geyser init tool word-count
geyser test word-count
geyser --json dev word-count
סמכויות וזמינות, במילים פשוטות

איפה דברים רצים, וכמה הם עולים

כל פרויקט עובד דרך Agent אחד שבוחרים. המפתחות של הפרויקט עובדים רק בשבילו, ורק במקום שבו נשמרים עכשיו הנתונים של סביבת העבודה שלו. חבילת JSON חתומה נכנסת לפעולה רק אחרי שה-⁠Agent הזה בדק אותה בייט אחר בייט והיא עברה את הבדיקות שלה בסביבה מבודדת.

הרחבת JSON טהורה לא יכולה לגעת בקבצים של המחשב, ברשת, בתהליכים אחרים או בהרשאות גישה שהיא עשויה לרשת. משימות Agent שנשלחות דרך ה-⁠SDK או ה-⁠CLI משתמשות במודלים ובכלים שהוגדרו בסביבת העבודה שלך. ה-⁠SDK עצמו ברישיון MIT, ושימוש מרוחק במודלים ובמחשוב מחויב דרך החשבון שלך. בתקופת התצוגה המקדימה אין מכסת מחשוב חינמית ואין SLA לזמינות.

SDK/CLI 0.3.4 זמין ב-⁠PyPI וב-⁠GitHub. Homebrew מתקין אותו על Mac עם Apple silicon ועל Linux מסוג AMD64, ו-⁠handlers מקומיים ב-⁠Python צריכים גם Python 3.11 ומעלה. הרצה מקומית עובדת כבר היום. הרצת משימה מרחוק דורשת גרסאות תואמות של תוכנת סביבת העבודה ושל תוכנת ה-⁠Agent, אז כדאי לבדוק את דף המפתחים במסוף הניהול לפני ששולחים משימה. Bundle לא מרחיב את מה ש-⁠Agent כבר רשאי לעשות, ופרופיל מודל בוחר מתוך מודלים שכבר הוגדרו. forks ציבוריים לבדיקה לא מריצים כלים, והרצה חוזרת של ביצוע היא פעולה נפרדת.

Python SDK ב-⁠PyPICLI ב-⁠PyPIהורדת SDK/CLI 0.3.4לקרוא את השינויים והערות המעבר
לעשות התחלה

להתחיל ממשימה אחת שהאפליקציה שלך יכולה להקל

בוחרים דוגמה, מתאימים אותה לדרך שבה הצוות שלך עובד, ובודקים אם היא חוסכת את הצורך לבנות בעצמך את הטיפול במשימות. כל דוגמה היא נקודת התחלה לאפליקציה שלך.