בדף הזה מוסבר איך לספק הקשר שנוצר על ידי מחברים לסוכני נתונים של Conversational Analytics API בצורה הטובה ביותר, על ידי כתיבת הנחיות אפקטיביות באמצעות הוראות מערכת, ובחלק ממקורות הנתונים, גם על ידי אספקת הקשר מובנה. הוספת הקשר היא אופציונלית, אבל הקשר מובנה היטב יכול לשפר את הדיוק והרלוונטיות של התשובות שה-API מספק.
מהו הקשר שנוצר על ידי המחבר?
הנחיות שניתנות על ידי המפתח כדי לעצב את ההתנהגות של סוכן נתונים ולשפר את התגובות של ה-API. ההנחיות האלה כוללות הוראות מערכת חופשיות, ובחלק ממקורות הנתונים יש שדות הקשר מובנים עם מידע כמו תיאורי טבלאות ושאילתות לדוגמה. כדי לענות על שאלות, הסוכן משלב את ההקשר שנוצר עם מידע ממקורות נתונים – כמו טבלאות BigQuery, ניתוחים ב-Looker, Data Studio ומקורות נתונים של מסדי נתונים – ועם היסטוריית השיחות (בשיחות רב-שלביות).
הנחיות ברורות בשדות הקשר המובנים והוראות המערכת החופשיות יכולות לשפר את היכולת של הסוכן לפרש את שאלות המשתמשים וליצור תשובות שימושיות ומדויקות. הקשר מוגדר היטב שימושי במיוחד אם מתחברים לנתונים כמו טבלאות BigQuery. לדוגמה, אפשר להשתמש בהקשר שנוצר כדי לספק לסוכן הנחיות מהסוגים הבאים:
- לוגיקה ספציפית לעסק: הגדרה של לקוח נאמן כמי שביצע יותר מחמש רכישות בפרק זמן מסוים.
- עיצוב התשובה: כדי לחסוך למשתמשים זמן, התשובה צריכה להיות סיכום של כל התשובות מסוכן הנתונים, באורך של 20 מילים או פחות.
- הצגת נתונים: צריך לעצב את כל המספרים בהתאם לסגנון שמוגדר במדריך הסגנון של החברה.
לספק הקשר שנוצר על ידי המחבר
המידע הספציפי שאתם יכולים לספק תלוי במקור הנתונים. לגבי נתונים ב-BigQuery, נתונים ב-Looker ונתונים במסד נתונים, אפשר להגדיר גם הקשר מובנה וגם הוראות מערכת. כדי לקבל את התוצאות הטובות ביותר, כדאי קודם לספק לסוכן הקשר באמצעות השדות המובנים הזמינים. אחר כך תוכלו לספק הנחיות נוספות באמצעות הגדרת הוראות למערכת.
אתם מספקים הקשר מובנה בשדות API לפרטים כמו תיאורי טבלאות ושאילתות לדוגמה. אתם מספקים את ההוראות למערכת כמחרוזת בפורמט YAML באמצעות הפרמטר system_instruction.
אחרי שמגדירים את ההקשר שנוצר, אפשר לספק אותו ל-API באחת מהקריאות הבאות:
- יצירת סוכן נתונים קבוע: כדי להגדיר התנהגות של סוכן שנשמרת בכמה שיחות, צריך לכלול הקשר שנוצר על ידי המשתמש באובייקט
published_contextבגוף הבקשה. מידע נוסף זמין במאמרים יצירת סוכן נתונים (HTTP) או הגדרת הקשר לשיחה עם שמירת סטטוס או ללא שמירת סטטוס (Python SDK). - שליחת בקשה ללא מצב: כדי להגדיר את ההתנהגות של הסוכן עבור קריאה ספציפית ל-API, צריך לספק הקשר שנוצר בתוך אובייקט
inline_contextבבקשה לצ'אט. מידע נוסף אפשר למצוא במאמר יצירת שיחה מרובת תפניות ללא שמירת מצב (HTTP) או במאמר שליחת בקשת צ'אט ללא שמירת מצב עם הקשר מוטבע (Python SDK). - שליחת בקשה לנתוני שאילתה: במקורות נתונים של מסד נתונים, צריך לציין את מזהה קבוצת ההקשר של ההקשר שנוצר באובייקט
agent_context_referenceבבקשה לנתוני שאילתה. מידע נוסף זמין במאמר הגדרת ההקשר של סוכן הנתונים למקורות נתונים של מסדי נתונים.
שיטה מומלצת ליצירת סוכנים: שימוש בניהול גרסאות להקשר שנוצר
כדי לשלוט בגרסאות ההקשר כשיוצרים סוכנים באמצעות Conversational Analytics API, משתמשים בשדות stagingContext, publishedContext ו-lastPublishedContext. בדוגמה הבאה לתרחיש שימוש אפשר לראות איך משתמשים בשדות האלה כדי ליצור גרסת ביניים וגרסת ייצור של הקשר של הסוכן.
נניח שאתם משתמשים בסוכן קיים עם השדה publishedContext, אבל אתם צריכים לעדכן את הסוכן (למשל, להפוך את כל התרשימים לירוקים במקום לכחולים).
כדי לבצע שינויים ולבדוק אותם לפני הפרסום, פועלים לפי השלבים הבאים:
- מבצעים את השינויים בסוכן בשדה
stagingContextובודקים את הסוכן עם השינויים. - כשהשינויים מוכנים, מעדכנים את השדה
publishedContextעם השינויים מ-stagingContext. - אם רוצים לחזור לסוכן הקודם, אפשר לעדכן את
publishedContextל-lastPublishedContext.
מקורות מידע שקשורים לנושא
- יצירת סוכן נתונים באמצעות HTTP ו-Python
- יצירת סוכן נתונים באמצעות Python SDK
- הגדרת הקשר של סוכן הנתונים למקורות נתונים של BigQuery
- הגדרת הקשר של סוכן הנתונים למקורות נתונים של Looker
- הגדרת הקשר של סוכן הנתונים למקורות נתונים של מסדי נתונים