Dialogflow-KI-Agenten registrieren und verwalten

Auf dieser Seite wird beschrieben, wie Sie Dialogflow-Agenten für Gemini Enterprise registrieren und verwenden.

Übersicht

Wenn Sie einen Dialogflow-Agenten mit Gemini Enterprise verwenden möchten, müssen Sie ihn zuerst bereitstellen und dann registrieren. Durch die Registrierung Ihres Dialogflow-Agenten wird er mit Gemini Enterprise verknüpft, sodass beide miteinander kommunizieren können.

Hinweis

Sie müssen die folgenden Schritte ausführen, bevor Sie Ihren Dialogflow-Agenten registrieren:

  • Stellen Sie Ihren Dialogflow-Agenten bereit. Informationen zum Anzeigen des Dashboards für Dialogflow- und Konversations-Agenten finden Sie unter Konversations Agenten.

  • Die Rolle „Gemini Enterprise Admin“ .

  • Aktivieren Sie die Discovery Engine API. Wenn Sie die Discovery Engine API für das Google Cloud-Projekt aktivieren möchten, rufen Sie in der Google Cloud Console die Seite Discovery Engine API auf.

    Zur Discovery Engine API

  • Erstellen Sie eine Gemini Enterprise-App. Weitere Informationen finden Sie unter App erstellen.

Dialogflow-Agenten bei Gemini Enterprise registrieren

Sie können Ihren Dialogflow-Agenten bei Gemini Enterprise über dieGoogle Cloud Console oder die REST API registrieren. Durch die Registrierung wird Ihr Agent für Nutzer in einer Gemini Enterprise-App verfügbar.

Console

So registrieren Sie einen Dialogflow-Agenten über die Google Cloud Console:

  1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

    Zu Gemini Enterprise

  2. Wählen Sie Ihr Projekt aus.

  3. Klicken Sie auf den Namen der App, für die Sie den Agenten registrieren möchten.

  4. Klicken Sie auf Agenten > Agenten hinzufügen. Der Bereich Agenttyp auswählen wird angezeigt.

  5. Klicken Sie auf der Karte Benutzerdefinierter Agent über Dialogflow auf Hinzufügen, um Ihren Dialogflow-Agenten bei Gemini Enterprise zu registrieren. Der Bereich Konfiguration wird geöffnet.

  6. So konfigurieren Sie Ihren Agenten:

    1. Geben Sie im Feld Name des KI-Agenten einen Namen ein. Dieser Wert wird in Gemini Enterprise als Anzeigename Ihres KI-Agenten angezeigt.

    2. Geben Sie im Feld Beschreiben Sie Ihren Agenten eine Beschreibung ein. Dieser Wert wird von einem LLM verwendet, um zu bestimmen, ob Ihr KI-Agent für die Antwort auf eine Nutzeranfrage aufgerufen werden soll.

    3. Geben Sie im Feld Dialogflow-Agentenquelle den Ressourcenpfad des Dialogflow-Agenten ein, den Sie bei Gemini Enterprise registrieren möchten.

      Verwenden Sie dieses Format: projects/{project}/locations/{location}/agents/{agent}

      Die Option Verfügbarkeit des KI-Agenten ist standardmäßig auf Wenn ausgewählt festgelegt.

    4. Klicken Sie auf Erstellen.

curl

In diesem Codebeispiel wird gezeigt, wie Sie Ihren Agenten registrieren:

  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"
      }
    }'

Ersetzen Sie die Variablen durch folgende Werte:

  • PROJECT_ID: Die ID Ihres Projekts in Google Cloud .
  • APP_ID: Die ID Ihrer Gemini Enterprise-App.
  • DISPLAY_NAME: Der nutzerfreundliche Name für Ihren KI-Agenten, der in Gemini Enterprise angezeigt wird.
  • DESCRIPTION: Eine kurze Beschreibung der Funktion Ihres KI-Agenten, die Nutzern in Gemini Enterprise angezeigt wird. Beispiel: Schlüsselinformationen aus hochgeladenen Rechnungen für Geschäftsreisen extrahieren.
  • ICON_URI: Der öffentliche URI des Symbols, das neben dem Namen Ihres Dialogflow-Agenten angezeigt wird. Sie können auch ein Base64-codiertes Bild in icon.content angeben.
  • DIALOGFLOW_PROJECT_ID: Die Google Cloud -Projekt-ID, die den Standort Ihres Dialogflow-Agenten angibt.
  • DIALOGFLOW_LOCATION: Der genaue geografische Standort, an dem Ihr Dialogflow-Agent gehostet wird, zum Beispiel global oder us-central1.
  • DIALOGFLOW_AGENT_ID: Die eindeutige Kennung Ihres Dialogflow-Agenten.

Bei einer erfolgreichen Antwort auf diesen Befehl werden alle Felder der neu erstellten Dialogflow-Agentenressource zurückgegeben, einschließlich des eindeutigen Ressourcennamens im Feld „name“. Dieser Ressourcenname kann für zukünftige Updates oder Verweise verwendet werden.

Mit einer App verbundene Agenten auflisten

Im folgenden Codebeispiel wird gezeigt, wie Sie die Details aller mit Ihrer App verbundenen Agenten abrufen können:

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"

Ersetzen Sie die Variablen durch folgende Werte:

  • ENDPOINT_LOCATION: Die Multiregion für Ihre API-Anfrage. Geben Sie einen der folgenden Werte an:
  • us für die Multiregion „USA“
  • eu für die Multiregion „EU“
  • global für den Standort „Global“
Weitere Informationen zum Festlegen multiregionaler Standorte für Ihren Datenspeicher.
  • PROJECT_ID: die ID Ihres Google Cloud -Projekts.
  • LOCATION: Der multiregionale Standort Ihrer Anwendung: global, us oder eu.
  • APP_ID: die ID Ihrer Gemini Enterprise-App.

    • Wenn Ihr Agent nicht von Google vorab erstellt wurde, enthält die Antwort in den ersten Zeilen das Feld name. Der Wert dieses Felds enthält die Agenten-ID am Ende des Pfads. In der folgenden Antwort lautet die Agenten-ID beispielsweise 12345678901234567890:

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

    Details eines Dialogflow-Agenten ansehen

    Im folgenden Codebeispiel wird gezeigt, wie Sie die Details eines Agenten abrufen können, der bei Gemini Enterprise registriert wurde:

    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"

    Ersetzen Sie die Variablen durch folgende Werte:

    • ENDPOINT_LOCATION: Die Multiregion für Ihre API-Anfrage. Geben Sie einen der folgenden Werte an:
    • us für die Multiregion „USA“
    • eu für die Multiregion „EU“
    • global für den Standort „Global“
    Weitere Informationen zum Festlegen multiregionaler Standorte für Ihren Datenspeicher.
  • PROJECT_ID: die ID Ihres Google Cloud -Projekts.
  • LOCATION: Der multiregionale Standort Ihrer Anwendung: global, us oder eu.
  • APP_ID: Die ID Ihrer Gemini Enterprise-App.
  • AGENT_ID: Die ID des Agenten. Sie können die Agenten-ID abrufen, indem Sie die mit Ihrer App verbundenen Agenten auflisten.

    • Dialogflow-Agent aktualisieren

    Alle Felder, die bei der Registrierung des Agenten angegeben wurden, können aktualisiert werden. Folgende Felder sind für die Aktualisierung obligatorisch:

    • displayName
    • description
    • reasoning_engine

    Wenn Sie ein Feld aktualisieren, müssen alle Felder und deren Werte in der Aktualisierungsanfrage neu definiert werden, auch wenn an einem Feld keine Änderungen vorgenommen werden.

    In diesem Codebeispiel wird gezeigt, wie Sie die Registrierung Ihres Dialogflow-Agenten aktualisieren:

    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"
      }
    }'

    Ersetzen Sie die Variablen durch folgende Werte:

    • PROJECT_ID: Die ID Ihres Projekts in Google Cloud .
    • AGENT_RESOURCE_NAME: Der Ressourcenname des registrierten Agenten, der aktualisiert werden soll.
    • DISPLAY_NAME: Der Anzeigename des Agenten.
    • DESCRIPTION: Die Beschreibung des Agenten, die in Gemini Enterprise angezeigt wird. Die Beschreibung ist nur für Nutzer gedacht.
    • ICON_URI: Der öffentliche URI des Symbols, das neben dem Namen Ihres Dialogflow-Agenten angezeigt wird. Sie können auch ein Base64-codiertes Bild in icon.content angeben.
    • REASONING_ENGINE_LOCATION: Der Cloud-Standort der Reasoning Engine, auf der Sie den Agenten erstellen.
    • DIALOGFLOW_AGENT_ID: Die eindeutige Kennung Ihres Dialogflow-Agenten.

    Dialogflow-Agent löschen

    Im folgenden Codebeispiel wird gezeigt, wie Sie einen Agenten löschen, der mit Ihrer App verbunden ist:

    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"

    Ersetzen Sie die Variablen durch folgende Werte:

    • ENDPOINT_LOCATION: Die Multiregion für Ihre API-Anfrage. Geben Sie einen der folgenden Werte an:
    • us für die Multiregion „USA“
    • eu für die Multiregion „EU“
    • global für den Standort „Global“
    Weitere Informationen zum Festlegen multiregionaler Standorte für Ihren Datenspeicher.
  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .
  • LOCATION: Der multiregionale Standort Ihrer Anwendung: global, us oder eu.
  • APP_ID: die ID Ihrer Gemini Enterprise-App.
  • AGENT_ID: Die ID des Agenten. Sie können die Agenten-ID abrufen, indem Sie die mit Ihrer App verbundenen Agenten auflisten.
    •