סוכנים

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

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

יצירת סוכן

כדי ליצור סוכן:

המסוף

  1. פותחים את מסוף Dialogflow CX.
  2. יוצרים או בוחרים פרויקט.
  3. לוחצים על יצירת סוכן.
  4. בוחרים באפשרות יצירה אוטומטית כדי ליצור סוכן של מאגר נתונים, או באפשרות יצירה משלך כדי ליצור סוגים אחרים של סוכנים.
  5. ממלאים את הטופס להגדרות בסיסיות של הסוכן:
    1. אתם יכולים לבחור כל שם לתצוגה.
    2. בוחרים את המיקום המועדף. אם רוצים לשנות את הגדרות המיקום המתקדמות, לוחצים על הלחצן עריכה.
    3. בוחרים את אזור הזמן.
    4. בוחרים את שפת ברירת המחדל של הסוכן. אחרי שיוצרים סוכן, אי אפשר לשנות את שפת ברירת המחדל שלו.
  6. לוחצים על Save.

API

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

כדי ליצור סוכן, אפשר לעיין בשיטה create עבור הסוג Agent.

בוחרים פרוטוקול וגרסה להפניה לסוכן:

פרוטוקול V3 V3beta1
REST משאב של נציג משאב של נציג
RPC ממשק לנציגים ממשק לנציגים
C++‎ AgentsClient לא זמין
C#‎ AgentsClient לא זמין
המשך AgentsClient לא זמין
Java AgentsClient AgentsClient
Node.js AgentsClient AgentsClient
PHP לא זמין לא זמין
Python AgentsClient AgentsClient
Ruby לא זמין לא זמין

נתוני הסוכן

סוכני Dialogflow CX משמשים כקונטיינרים ברמה העליונה להגדרות ולנתונים של נציגים וירטואליים. הנתונים הבאים משויכים לסוכנים:

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

הגדרת נקודות קצה חכמה

המרת דיבור לטקסט (STT) היא API שממיר אודיו לטקסט באמצעות למידת מכונה, ומאפשר לכם לשלב זיהוי דיבור באפליקציות שלכם. מודלים נתמכים של STT כוללים כל מודל ארוך (לדוגמה, phone_call). רק השפה en-US נתמכת.

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

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

תכונות נוספות של STT כוללות:

  • זיהוי מהיר יותר של סוף דיבור: ניתוח בזמן אמת משתמש בסטרימינג של תמלול אודיו כדי להבחין בין הפסקה טבעית לבין סיום של אמירה, בזמן שסטרימינג ה-STT נשאר פתוח. אם המשתמש סיים לדבר, Dialogflow CX מסיים את הסטרימינג מוקדם יותר כדי לספק תשובה מהירה יותר.
  • משוב טבעי בשיחה: אם המשתמש עוצר באמצע הדיבור, מערכת Dialogflow CX יכולה להאריך באופן דינמי את זמן קצוב לתפוגה של ה-STT כדי למנוע הפרעות מוקדמות, או להוסיף רמזים טבעיים של תקשורת ברקע (למשל, "אהה", "אוקיי") כדי לאשר שהנציג הווירטואלי עדיין מקשיב.

ייצוא ושיחזור של סוכן

אפשר לייצא סוכן לקובץ ולשחזר סוכן באמצעות הקובץ הזה.

ייצוא של סוכן כולל את כל הנתונים של הסוכן, חוץ מהנתונים הבאים:

שחזור של סוכן מחליף את כל נתוני סוכן היעד (כולל כל גרסאות התהליך), למעט הנתונים הבאים:

  • סביבות: כל הסביבות המותאמות אישית נשארות ללא שינוי בסוכן היעד. גרסאות של תהליכים שאליהן מתייחסות סביבות בהתאמה אישית בסוכן היעד ימשיכו להתקיים כל עוד הסביבות המשויכות קיימות. עם זאת, גרסאות התהליך המיושנות האלה לא מופיעות ברשימה של גרסאות התהליך של הסוכן ולא ניתן לבחור אותן.
  • Vertex AI Agents Apps: השיוך לאפליקציית סוכנים של Vertex AI נשאר ללא שינוי בסוכן היעד (כלומר, הערך של engine ב-GenAppBuilderSettings). המשמעות היא שאפשר לשחזר סוכנים של מאגרי נתונים רק לסוכנים אחרים של מאגרי נתונים קיימים, כי גם לסוכן שנוצר צריך להיות שיוך לאפליקציית סוכנים של Vertex AI.

  • מאגרי נתונים של סוכני Vertex AI: כל ההפניות למאגרי נתונים יימחקו בסוכן היעד, בהתאם לכללים הבאים:

    • אם סוכן היעד לא משויך לאפליקציה, אי אפשר לשחזר בו סוכן עם הפניות למאגר נתונים. ניסיון לעשות את זה יוביל להודעת שגיאה. כדי לפתור את הבעיה, אפשר ליצור סוכן חדש של מאגר נתונים מאפס. (לחלופין, אפשר להפוך את הסוכן הקיים לסוכן מאגר נתונים על ידי הוספת מטפל במצב של מאגר נתונים). במקרה כזה, תקבלו הנחיות להוספת אפליקציה משויכת לסוכן שלכם).
    • אם סוכן היעד משויך לאפליקציה, כל ההפניות למאגר הנתונים יעודכנו לאחר השחזור: מזהה הפרויקט והמיקום שלהם יעודכנו כך שיתאימו לאפליקציה של סוכן היעד. Google Cloud המזהה של האוסף והמזהה של מאגר הנתונים יישארו ללא שינוי. כלומר, צריך להוסיף מאגרי נתונים לכל המזהים עם סוגים תואמים לאפליקציה של הסוכן היעד לפני פעולת השחזור.

    דוגמה: אם סוכן המקור מתייחס למאגר נתונים בשם projects/123/locations/eu-west2/collections/default_collection/dataStores/myDataStore1, והאפליקציה של סוכן היעד נקראת projects/321/locations/us-east1/collections/default_collections/engines/app123, אז ההפניה למאגר הנתונים בסוכן היעד תהיה: projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1

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

כדי לייצא או לשחזר סוכן:

המסוף

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט של הסוכן.
  3. בוחרים באפשרות התפריט לסוכן ברשימה.
  4. לוחצים על הלחצן ייצוא או על הלחצן שחזור.
  5. פועלים לפי ההוראות כדי להשלים את התהליך.

API

אפשר לעיין בשיטות export ו-restore של הסוג Agent.

בוחרים פרוטוקול וגרסה להפניה לסוכן:

פרוטוקול V3 V3beta1
REST משאב של נציג משאב של נציג
RPC ממשק לנציגים ממשק לנציגים
C++‎ AgentsClient לא זמין
C#‎ AgentsClient לא זמין
המשך AgentsClient לא זמין
Java AgentsClient AgentsClient
Node.js AgentsClient AgentsClient
PHP לא זמין לא זמין
Python AgentsClient AgentsClient
Ruby לא זמין לא זמין

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

אם אתם משתמשים ב-GitHub, כדאי לעיין גם במדריך לייצוא ולשחזור ב-GitHub.

מחיקת סוכן

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

כדי למחוק סוכן:

המסוף

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט של הסוכן.
  3. בוחרים באפשרות התפריט לסוכן ברשימה.
  4. לוחצים על הלחצן .
  5. מאשרים את המחיקה בתיבת הדו-שיח.

API

אפשר לעיין בשיטה delete עבור הסוג Agent.

בוחרים פרוטוקול וגרסה להפניה לסוכן:

פרוטוקול V3 V3beta1
REST משאב של נציג משאב של נציג
RPC ממשק לנציגים ממשק לנציגים
C++‎ AgentsClient לא זמין
C#‎ AgentsClient לא זמין
המשך AgentsClient לא זמין
Java AgentsClient AgentsClient
Node.js AgentsClient AgentsClient
PHP לא זמין לא זמין
Python AgentsClient AgentsClient
Ruby לא זמין לא זמין

אם תמחקו את הפרויקט, כל הסוכנים של Dialogflow CX והנתונים שמשויכים לפרויקט יימחקו באופן מיידי.

הקודם
Dialogflow CX console overview
הבא
Overview