סוכנים

נציג של 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 והנתונים שמשויכים לפרויקט יימחקו באופן מיידי.