רישום וניהול של סוכני Dialogflow

בדף הזה מוסבר איך לרשום סוכני Dialogflow ולהשתמש בהם עם Gemini Enterprise.

סקירה כללית

כדי להשתמש בנציג Dialogflow עם Gemini Enterprise, קודם צריך לפרוס את הנציג ואז לרשום אותו. רישום של נציג Dialogflow מקשר את הנציג שפרסתם ל-Gemini Enterprise, כדי שהם יוכלו לתקשר.

לפני שמתחילים

לפני שרושמים את נציג Dialogflow, צריך לוודא שהשלבים הבאים בוצעו:

  • פורסים את סוכן Dialogflow. כדי לראות את מרכז הבקרה של Dialogflow ושל צ'אט בוטים, אפשר לעיין במאמר בנושא צ'אט בוטים.

  • התפקיד אדמין Discovery Engine.

  • מפעילים את Discovery Engine API. כדי להפעיל את Discovery Engine API בפרויקט Google Cloud, במסוף Google Cloud , עוברים לדף Discovery Engine API.

    ל-Discovery Engine API

  • יוצרים אפליקציית Gemini Enterprise. מידע נוסף זמין במאמר בנושא יצירת אפליקציה.

רישום של סוכן Dialogflow ב-Gemini Enterprise

אפשר לרשום את סוכן Dialogflow ב-Gemini Enterprise באמצעות מסוףGoogle Cloud או ה-API בארכיטקטורת REST. ההרשמה מאפשרת למשתמשים באפליקציית Gemini Enterprise לגשת לסוכן.

המסוף

כדי לרשום סוכן Dialogflow באמצעות המסוף Google Cloud :

  1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

    נכנסים אל Gemini Enterprise

  2. בוחרים את הפרויקט הרצוי.

  3. לוחצים על שם האפליקציה שרוצים לרשום בה את הסוכן.

  4. לוחצים על Agents (סוכנים) > Add Agents (הוספת סוכנים). מופיעה החלונית Choose an agent type (בחירת סוג סוכן).

  5. בכרטיס סוכן בהתאמה אישית דרך Dialogflow, לוחצים על הוספה כדי לרשום את סוכן Dialogflow ב-Gemini Enterprise. החלונית Configuration (הגדרה) תיפתח.

  6. כדי להגדיר את הסוכן, מבצעים את השלבים הבאים:

    1. מזינים שם בשדה Your agent name (שם הנציג שלך). הערך הזה מופיע ב-Gemini Enterprise כשם לתצוגה של הסוכן.

    2. בשדה Describe your agent (תיאור הסוכן) מזינים תיאור. הערך הזה משמש מודל LLM כדי לקבוע אם להפעיל את הסוכן בתגובה לשאילתת משתמש.

    3. בשדה מקור נציג Dialogflow, מזינים את נתיב המשאב של נציג Dialogflow שרוצים לרשום ב-Gemini Enterprise.

      צריך להשתמש בפורמט הזה: projects/{project}/locations/{location}/agents/{agent}

      האפשרות זמינות נציג, כשהיא נבחרת, מוגדרת כברירת מחדל.

    4. לוחצים על יצירה.

curl

בדוגמת הקוד הזו אפשר לראות איך רושמים את הסוכן:

  curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -H "X-Goog-User-Project: PROJECT_ID" \
    "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/assistants/default_assistant/agents" \
    -d '{
      "displayName": "DISPLAY_NAME",
      "description": "DESCRIPTION",
      "icon": {
        "uri": "ICON_URI"
      },
      "dialogflowAgentDefinition": {
        "dialogflowAgent": "projects/DIALOGFLOW_PROJECT_ID/locations/DIALOGFLOW_LOCATION/agents/DIALOGFLOW_AGENT_ID"
      }
    }'

מחליפים את המשתנים בערכים:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫APP_ID: המזהה של אפליקציית Gemini Enterprise.
  • ‫DISPLAY_NAME: השם הידידותי למשתמש של הסוכן שמוצג ב-Gemini Enterprise.
  • ‫DESCRIPTION: הסבר קצר על מה שהסוכן עושה שגלוי למשתמשים ב-Gemini Enterprise. לדוגמה, אפשר לחלץ מידע חשוב מחשבוניות שהועלו לצורך נסיעות עסקיות.
  • ‫ICON_URI: ה-URI הציבורי של סמל שמוצג לצד השם של סוכן Dialogflow. אפשר גם לספק תמונה בקידוד Base64 ב-icon.content.
  • ‫DIALOGFLOW_PROJECT_ID: מזהה הפרויקט ב- Google Cloud שמזהה את המיקום של הנציג שלכם ב-Dialogflow.
  • ‫DIALOGFLOW_LOCATION: המיקום הגיאוגרפי הספציפי שבו מתארח נציג Dialogflow, כמו global או us-central1.
  • ‫DIALOGFLOW_AGENT_ID: המזהה הייחודי של נציג Dialogflow.

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

רשימת נציגים שמחוברים לאפליקציה

בדוגמת הקוד הבאה אפשר לראות איך מקבלים את הפרטים של כל הסוכנים שמחוברים לאפליקציה:

REST 

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant/agents"

מחליפים את המשתנים בערכים:

  • ‫ENDPOINT_LOCATION: האזור במספר אזורים של בקשת ה-API. מציינים אחד מהערכים הבאים:
    • ‫us בארה"ב במספר אזורים
    • ‫eu במספר אזורים באיחוד האירופי
    • global למיקום הגלובלי
    מידע נוסף זמין במאמר בנושא ציון מספר אזורים למאגר הנתונים.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫LOCATION: האפליקציה במספר אזורים: ‫global,‏ us או eu.
  • ‫APP_ID: המזהה של אפליקציית Gemini Enterprise.

אם הסוכן לא נוצר מראש על ידי Google, התשובה כוללת שדה name בכמה השורות הראשונות. הערך של השדה הזה מכיל את מזהה הסוכן בסוף הנתיב. לדוגמה, בתגובה הבאה, מזהה הסוכן הוא 12345678901234567890:

{
"name": "projects/123456/locations/global/collections/default_collection/engines/my-app/assistants/default_assistant/agents/12345678901234567890",
...
}

הצגת פרטים של סוכן Dialogflow

בדוגמת הקוד הבאה אפשר לראות איך מאחזרים את הפרטים של סוכן שנרשם ב-Gemini Enterprise:

REST 

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant/agents/AGENT_ID"

מחליפים את המשתנים בערכים:

  • ‫ENDPOINT_LOCATION: האזור במספר אזורים של בקשת ה-API. מציינים אחד מהערכים הבאים:
    • ‫us בארה"ב במספר אזורים
    • ‫eu במספר אזורים באיחוד האירופי
    • global למיקום הגלובלי
    מידע נוסף זמין במאמר בנושא ציון מספר אזורים למאגר הנתונים.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫LOCATION: האפליקציה במספר אזורים: ‫global,‏ us או eu.
  • ‫APP_ID: המזהה של אפליקציית Gemini Enterprise.
  • ‫AGENT_ID: מזהה הסוכן. אפשר למצוא את מזהה הסוכן על ידי הצגת רשימה של הסוכנים שמחוברים לאפליקציה.

עדכון סוכן Dialogflow

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

  • displayName
  • description
  • reasoning_engine

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

בדוגמת הקוד הזו אפשר לראות איך מעדכנים את הרישום של סוכן Dialogflow:

curl 

  curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -H "X-Goog-User-Project: PROJECT_ID" \
  "https://discoveryengine.googleapis.com/v1alpha/AGENT_RESOURCE_NAME" \
    -d '{
      "displayName": "DISPLAY_NAME",
      "description": "DESCRIPTION",
      "icon": {
        "uri": "ICON_URI"
      },
      "dialogflowAgentDefinition": {
        "dialogflowAgent": "projects/PROJECT_ID/locations/REASONING_ENGINE_LOCATION/agents/DIALOGFLOW_AGENT_ID"
      }
    }'

מחליפים את המשתנים בערכים:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • AGENT_RESOURCE_NAME: שם המשאב של רישום הסוכן שרוצים לעדכן.
  • ‫DISPLAY_NAME:השם המוצג של הסוכן.
  • ‫DESCRIPTION: התיאור של הסוכן שמוצג ב-Gemini Enterprise. התיאור מיועד רק לטובת המשתמש.
  • ‫ICON_URI: ה-URI הציבורי של סמל שמוצג לצד השם של סוכן Dialogflow. אפשר גם לספק תמונה בקידוד Base64 ב-icon.content.
  • ‫REASONING_ENGINE_LOCATION: המיקום בענן של מנוע ההסקה שבו יוצרים את הסוכן.
  • ‫DIALOGFLOW_AGENT_ID: המזהה הייחודי של נציג Dialogflow.

מחיקת סוכן Dialogflow

בדוגמת הקוד הבאה אפשר לראות איך מוחקים סוכן שמחובר לאפליקציה:

REST 

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant/agents/AGENT_ID"

מחליפים את המשתנים בערכים:

  • ‫ENDPOINT_LOCATION: האזור במספר אזורים של בקשת ה-API. מציינים אחד מהערכים הבאים:
    • ‫us בארה"ב במספר אזורים
    • ‫eu במספר אזורים באיחוד האירופי
    • global למיקום הגלובלי
    מידע נוסף זמין במאמר בנושא ציון מספר אזורים למאגר הנתונים.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫LOCATION: האפליקציה במספר אזורים: ‫global,‏ us או eu
  • ‫APP_ID: המזהה של אפליקציית Gemini Enterprise.
  • ‫AGENT_ID: מזהה הסוכן. אפשר למצוא את מזהה הסוכן על ידי הצגת רשימה של הסוכנים שמחוברים לאפליקציה.