Dialogflow-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 Discovery Engine 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. Geben Sie im Abschnitt Tooleinstellungen eine Beschreibung in das Feld Toolbeschreibung ein. Anhand dieser Beschreibung versteht das LLM den Zweck des Tools und entscheidet, wann es verwendet werden soll.

    5. Geben Sie den Namen in das Feld Name des Eingabeparameters ein. Das ist der Parametername für den Funktionsaufruf. Dieser Parametername gibt dem LLM einen Hinweis darauf, welche Art von Inhalt der Parameter voraussichtlich enthalten wird, z. B. eine question, eine command oder eine search_query.

    6. Geben Sie die Beschreibung für das Feld Beschreibung des Eingabeparameters ein. Dies ist eine Parameterbeschreibung für den Funktionsaufruf. Diese Beschreibung gibt dem LLM weitere Informationen zum Parameter, z. B. welche Art von Inhalt voraussichtlich übergeben wird und welche Aktionen dafür ausgeführt werden sollen.

    7. 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. Weisen Sie einen der folgenden Werte zu:
    • us- für die multiregionale Option „USA“
    • eu- für die multiregionale Option „EU“
    • global- für den globalen Standort
    Weitere Informationen zum Festlegen multiregionaler Standorte für Ihren Datenspeicher.
  • PROJECT_ID: Die ID Ihres Projekts in Google Cloud .
  • LOCATION: Die Multiregion 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:

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: