Geyser SDK · 0.2.0

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

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

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

Otis

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

עוזרים למישהו בצוות התמיכה להבין פנייה קשה ולנסח תשובה. הדוגמה לתמיכה ממיינת את פרטי הפנייה שמעבירים לה, מבקשת מ-⁠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.2.0 · הרצה מקומית
git clone --branch v0.2.0 --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, וההרשאות שלו קשורות לפרויקט הזה ול-⁠Customer Cell הנוכחי שלו. חבילת JSON חתומה הופכת לפעילה רק אחרי שה-⁠Agent שהוקצה אימת את הבתים המדויקים והחבילה עברה את הבדיקות שלה בסביבה מבודדת.

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

SDK/CLI 0.2.0 פורסם ב-⁠PyPI וב-⁠GitHub. ההתקנה דרך Homebrew עובדת על macOS עם Apple Silicon ועל Linux מסוג AMD64, ו-⁠handlers מקומיים ב-⁠Python צריכים גם Python 3.11 ומעלה. אפשר להריץ מקומית כבר היום. הרצה מרוחקת דורשת גרסאות תואמות של Customer Cell ושל תוכנת ה-⁠Agent, אז כדאי לבדוק בדף המפתחים במסוף הניהול אם זה מוכן לפני ששולחים משימה מרוחקת. Bundles שומרים על הסמכויות הקיימות כמו שהן, ופרופילי מודל בוחרים מודל שכבר מוגדר. forks ציבוריים לבדיקה לא מריצים כלים, והרצה חוזרת של ביצוע היא פעולה נפרדת.

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

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

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