כלי מערכת הם כלים מובנים שהסוכן יכול להשתמש בהם כדי לבצע משימות נפוצות. אי אפשר לערוך אותן.
בדומה לכלים אחרים, כשמשתמשים בכלי מערכת, צריך לספק לסוכן הוראות מתי להשתמש בכלי וארגומנטים של הכלי.
customize_response
יצירת תגובה קולית של נציג עם שליטה מדויקת בפרמטרים, כולל השבתת ההתפרצות לשיחה ופרמטרים של DTMF.
ארגומנטים:
| ארגומנט | נדרש/אופציונלי | תיאור | ברירת מחדל |
|---|---|---|---|
| תוכן | חובה | תוכן הטקסט של התשובה מהסוכן. | |
| enable_dtmf | אופציונלי | האם להפעיל קלט מהמקלדת (DTMF). | ההודעה נבחרת לפי הגדרות האפליקציה של הסוכן |
| dtmf_endpointing_timeout_modes | אופציונלי | זמן ההמתנה לתגובת המשתמש בהקלדה, עם אפשרויות הבחירה 'קצר', 'בינוני' ו'ארוך'. | "mid" |
| dtmf_finish_digit | אופציונלי | ספרת ה-DTMF שמסיימת את איסוף ה-DTMF. לדוגמה, '#'. | מחרוזת ריקה |
| disable_barge_in | אופציונלי | אי אפשר להצטרף לשיחה כשהנציג מדבר. | לא נכון |
דוגמה להוראה לאיסוף מספר טלפון באמצעות DTMF, שבו DTMF מופעל באופן מפורש, ויכול להיות שהוא מבטל את ההגדרה של אפליקציית הנציג:
make the tool call customize_response(content="Please type your phone number",
enable_dtmf=True,
dtmf_endpointing_timeout_modes='short')
אפשר גם להגדיר את enable_dtmf באופן מפורש ל-False,
או להשמיט את הארגומנט הזה ולהסתמך על הגדרות האפליקציה של הסוכן.
דוגמה להוראה לאיסוף מספר כרטיס אשראי באמצעות DTMF:
make the tool call customize_response(
content="Using your keypad, please enter your 16-digit credit card number, then press the pound key when you are finished.",
enable_dtmf=True,
dtmf_finish_digit='#',
dtmf_endpointing_timeout_modes='mid')
דוגמה להוראה לקריאת התנאים בלי לאפשר השתלטות על השיחה:
make the tool call customize_response(
content="By proceeding, you agree to the terms and condition...",
disable_barge_in=True)
end_session
סיום הסשן. הכלי הזה משמש לסיום השיחה, להעברה לנציג תמיכה אנושי או לסיום הסשן אם למשתמש אין בקשות נוספות.
אם הסשן הסתיים בגלל בעיה, והיה צורך להעביר את הטיפול למדרגה גבוהה יותר,
צריך לציין את הערך True בפרמטר session_escalated.
משתמשים בארגומנט params כדי להעביר נתונים למטא-נתונים של סיום הסשן בתשובה הסופית.
ארגומנטים:
| ארגומנט | נדרש/אופציונלי | תיאור | ברירת מחדל |
|---|---|---|---|
| reason | חובה | הסיבה לסיום הסשן. | |
| session_escalated | אופציונלי | האם הסשן הועבר לנציג תמיכה אנושי. | לא נכון |
| params | אופציונלי | פרמטרים אחרים להעברה ל-handler של סיום הסשן. | ללא |
הוראה לדוגמה לסיום השיחה:
If the user has no more questions execute the tool end_session(reason="success")
דוגמה להוראה להעברה לטיפול ברמה גבוהה יותר כשהמשתמש רוצה לדבר עם נציג אנושי:
If the user wants to talk to a human, execute the tool
end_session(reason="escalate_to_human", session_escalated=True)
דוגמה להוראה לבדיקת שפת הקלט של המשתמש:
If the user speaks a language that is not English or Spanish, escalate by
calling: end_session(
reason='Encountered an unsupported language, escalating to a human agent.',
session_escalated=true).