Registrare e gestire gli agenti Dialogflow

Questa pagina descrive come registrare e utilizzare gli agenti Dialogflow con Gemini Enterprise.

Panoramica

Per utilizzare un agente Dialogflow con Gemini Enterprise, devi prima eseguire il deployment e poi registrare l'agente. La registrazione dell'agente Dialogflow collega l'agente di cui è stato eseguito il deployment a Gemini Enterprise in modo che possano comunicare.

Prima di iniziare

Prima di registrare l'agente Dialogflow, devi assicurarti che questi passaggi siano completati:

  • Esegui il deployment dell'agente Dialogflow. Per visualizzare la dashboard di Dialogflow e degli agenti conversazionali, vedi Agenti conversazionali.

  • Il ruolo Discovery Engine Admin.

  • Abilita l'API Discovery Engine. Per abilitare l'API Discovery Engine per il progetto Google Cloud, nella console Google Cloud , vai alla pagina API Discovery Engine.

    Vai all'API Discovery Engine

  • Crea un'app Gemini Enterprise. Per saperne di più, consulta Crea un'app.

Registrare un agente Dialogflow con Gemini Enterprise

Puoi registrare il tuo agente Dialogflow con Gemini Enterprise utilizzando la consoleGoogle Cloud o l'API REST. La registrazione rende il tuo agente disponibile per gli utenti all'interno di un'app Gemini Enterprise.

Console

Per registrare un agente Dialogflow utilizzando la console Google Cloud , segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

    Vai a Gemini Enterprise

  2. Seleziona il progetto.

  3. Fai clic sul nome dell'app con cui vuoi registrare l'agente.

  4. Fai clic su Agenti > Aggiungi agenti. Viene visualizzato il riquadro Scegli un tipo di agente.

  5. Nella scheda Agente personalizzato tramite Dialogflow, fai clic su Aggiungi per registrare il tuo agente Dialogflow con Gemini Enterprise. Viene visualizzato il riquadro Configurazione.

  6. Per configurare l'agente:

    1. Inserisci un nome nel campo Nome dell'agente. Questo valore viene visualizzato in Gemini Enterprise come nome visualizzato dell'agente.

    2. Inserisci una descrizione nel campo Descrivi il tuo agente. Questo valore viene utilizzato da un LLM per determinare se richiamare il tuo agente in risposta a una query dell'utente.

    3. Inserisci il percorso della risorsa dell'agente Dialogflow che vuoi registrare in Gemini Enterprise nel campo Origine agente Dialogflow.

      Utilizza questo formato: projects/{project}/locations/{location}/agents/{agent}

      L'opzione Disponibilità agente, Se selezionata, è impostata per impostazione predefinita.

    4. Nella sezione Impostazioni strumento, inserisci una descrizione nel campo Descrizione strumento. Questa descrizione viene utilizzata dal modello LLM per comprendere lo scopo dello strumento e decidere quando utilizzarlo.

    5. Inserisci il nome nel campo Nome parametro di input. Questo è il nome del parametro per la chiamata di funzione. Questo nome del parametro fornisce un suggerimento all'LLM sul tipo di contenuti che il parametro dovrebbe contenere, ad esempio un question, un command o un search_query.

    6. Inserisci la descrizione per il campo Descrizione del parametro di input. Questa è una descrizione del parametro per la chiamata di funzione. Questa descrizione fornisce all'LLM maggiori informazioni sul parametro, ad esempio quale tipo di contenuto ci si aspetta che venga trasmesso e quali azioni devono essere eseguite.

    7. Fai clic su Crea.

curl

Questo esempio di codice mostra come registrare l'agente:

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

Sostituisci le variabili con i valori:

  • PROJECT_ID: l'ID del tuo Google Cloud progetto.
  • APP_ID: l'ID della tua app Gemini Enterprise.
  • DISPLAY_NAME: il nome intuitivo dell'agente che viene visualizzato in Gemini Enterprise.
  • DESCRIPTION: una breve spiegazione di cosa fa l'agente visibile agli utenti di Gemini Enterprise. Ad esempio, estrai le informazioni chiave dalle fatture caricate per i viaggi di lavoro.
  • ICON_URI: l'URI pubblico di un'icona visualizzata accanto al nome dell'agente Dialogflow. Puoi anche fornire un'immagine codificata in Base64 in icon.content.
  • DIALOGFLOW_PROJECT_ID: l'ID progetto Google Cloud che identifica la posizione del tuo agente Dialogflow.
  • DIALOGFLOW_LOCATION: la posizione geografica specifica in cui è ospitato l'agente Dialogflow, ad esempio global o us-central1.
  • DIALOGFLOW_AGENT_ID: l'identificatore univoco del tuo agente Dialogflow.

La risposta riuscita a questo comando restituisce tutti i campi della risorsa agente Dialogflow appena creata, incluso il nome risorsa univoco nel campo name. Questo nome della risorsa può essere utilizzato per aggiornamenti o riferimenti futuri.

Elencare gli agenti connessi a un'app

L'esempio di codice seguente mostra come ottenere i dettagli di tutti gli agenti connessi alla tua app:

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"

Sostituisci le variabili con i valori:

  • ENDPOINT_LOCATION-: la multiregione per la tua richiesta API. Assegna uno dei seguenti valori:
    • us- per la multiregione Stati Uniti
    • eu- per la multiregione EU
    • global- per la località globale
    Per saperne di più, consulta Specifica una regione multipla per il datastore.
  • PROJECT_ID: l'ID del tuo Google Cloud progetto.
  • LOCATION: la multiregione della tua app: global, us o eu.
  • APP_ID: l'ID della tua app Gemini Enterprise.

Se l'agente non è predefinito da Google, la risposta include un campo name nelle prime righe. Il valore di questo campo contiene l'ID agente alla fine del percorso. Ad esempio, nella seguente risposta, l'ID agente è 12345678901234567890:

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

Visualizza i dettagli di un agente Dialogflow

Il seguente esempio di codice mostra come recuperare i dettagli di un agente registrato con 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"

Sostituisci le variabili con i valori:

  • ENDPOINT_LOCATION-: la multiregione per la tua richiesta API. Assegna uno dei seguenti valori:
    • us- per la multiregione Stati Uniti
    • eu- per la multiregione EU
    • global- per la località globale
    Per saperne di più, consulta Specifica una regione multipla per il datastore.
  • PROJECT_ID: l'ID del tuo Google Cloud progetto.
  • LOCATION: la multiregione della tua app: global, us o eu.
  • APP_ID: l'ID della tua app Gemini Enterprise.
  • AGENT_ID: l'ID dell'agente. Puoi trovare l'ID agente elencando gli agenti connessi alla tua app.

Aggiorna un agente Dialogflow

È possibile aggiornare tutti i campi forniti durante la registrazione dell'agente. I seguenti campi sono obbligatori durante la procedura di aggiornamento:

  • displayName
  • description
  • reasoning_engine

Quando aggiorni un campo, tutti i campi e i relativi valori devono essere ridefiniti nella richiesta di aggiornamento, anche se non vengono apportate modifiche a un campo specifico.

Questo esempio di codice mostra come aggiornare la registrazione del tuo agente 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"
      }
    }'

Sostituisci le variabili con i valori:

  • PROJECT_ID: l'ID del tuo Google Cloud progetto.
  • AGENT_RESOURCE_NAME: il nome della risorsa della registrazione dell'agente da aggiornare.
  • DISPLAY_NAME:il nome visualizzato dell'agente.
  • DESCRIPTION: la descrizione dell'agente visualizzata in Gemini Enterprise. La descrizione è solo a vantaggio dell'utente.
  • ICON_URI: l'URI pubblico di un'icona visualizzata accanto al nome dell'agente Dialogflow. Puoi anche fornire un'immagine codificata in Base64 in icon.content.
  • REASONING_ENGINE_LOCATION: la posizione cloud del motore di ragionamento in cui stai creando un agente.
  • DIALOGFLOW_AGENT_ID: l'identificatore univoco del tuo agente Dialogflow.

Eliminare un agente Dialogflow

Il seguente esempio di codice mostra come eliminare un agente connesso alla tua app:

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"

Sostituisci le variabili con i valori:

  • ENDPOINT_LOCATION-: la multiregione per la tua richiesta API. Assegna uno dei seguenti valori:
    • us- per la multiregione Stati Uniti
    • eu- per la multiregione EU
    • global- per la località globale
    Per saperne di più, consulta Specifica una regione multipla per il datastore.
  • PROJECT_ID: l'ID del tuo Google Cloud progetto.
  • LOCATION: la regione multipla della tua app: global, us o eu
  • APP_ID: l'ID della tua app Gemini Enterprise.
  • AGENT_ID: l'ID dell'agente. Puoi trovare l'ID agente elencando gli agenti connessi alla tua app.