Enregistrer et gérer des agents Dialogflow

Cette page explique comment enregistrer et utiliser des agents Dialogflow avec Gemini Enterprise.

Présentation

Pour utiliser un agent Dialogflow avec Gemini Enterprise, vous devez d'abord le déployer, puis l'enregistrer. L'enregistrement de votre agent Dialogflow associe votre agent déployé à Gemini Enterprise afin qu'ils puissent communiquer.

Avant de commencer

Avant d'enregistrer votre agent Dialogflow, vous devez vous assurer d'avoir effectué les étapes suivantes :

Enregistrer un agent Dialogflow auprès de Gemini Enterprise

Vous pouvez enregistrer votre agent Dialogflow auprès de Gemini Enterprise à l'aide de la consoleGoogle Cloud ou de l'API REST. L'enregistrement permet aux utilisateurs d'accéder à votre agent dans une application Gemini Enterprise.

Console

Pour enregistrer un agent Dialogflow à l'aide de la console Google Cloud , procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

    Accéder à Gemini Enterprise

  2. Sélectionnez votre projet.

  3. Cliquez sur le nom de l'application auprès de laquelle vous souhaitez enregistrer l'agent.

  4. Cliquez sur Agents >  Ajouter des agents. Le volet Choisir un type d'agent s'affiche.

  5. Sur la fiche Agent personnalisé via Dialogflow, cliquez sur Ajouter pour enregistrer votre agent Dialogflow auprès de Gemini Enterprise. Le volet Configuration s'ouvre.

  6. Pour configurer votre agent, procédez comme suit :

    1. Saisissez un nom dans le champ Nom de votre agent. Cette valeur apparaît dans Gemini Enterprise comme nom à afficher de votre agent.

    2. Saisissez une description dans le champ Décrivez votre agent. Cette valeur est utilisée par un LLM pour déterminer s'il doit appeler votre agent en réponse à une requête utilisateur.

    3. Dans le champ Source de l'agent Dialogflow, saisissez le chemin d'accès à la ressource de l'agent Dialogflow que vous souhaitez enregistrer auprès de Gemini Enterprise.

      Utilisez le format suivant : projects/{project}/locations/{location}/agents/{agent}

      L'option Disponibilité de l'agent, Si sélectionnée, est définie par défaut.

    4. Dans la section Paramètres de l'outil, saisissez une description dans le champ Description de l'outil. Cette description est utilisée par le LLM pour comprendre l'objectif de l'outil et décider quand l'utiliser.

    5. Saisissez le nom dans le champ Nom du paramètre d'entrée. Il s'agit du nom de paramètre pour l'appel de fonction. Ce nom de paramètre donne une indication au LLM sur le type de contenu que le paramètre est censé contenir, par exemple une question, une command ou une search_query.

    6. Saisissez la description dans le champ Description du paramètre d'entrée. Il s'agit d'une description de paramètre pour l'appel de fonction. Cette description fournit au LLM plus d'informations sur le paramètre, par exemple, le type de contenu attendu et les actions à effectuer.

    7. Cliquez sur Créer.

curl

Cet exemple de code montre comment enregistrer votre agent :

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

Remplacez les variables par des valeurs :

  • PROJECT_ID : ID de votre projet Google Cloud .
  • APP_ID : ID de votre application Gemini Enterprise.
  • DISPLAY_NAME : nom convivial de votre agent qui s'affiche dans Gemini Enterprise.
  • DESCRIPTION : brève explication de ce que fait votre agent, visible par les utilisateurs dans Gemini Enterprise. Par exemple, extraire des informations clés des factures de voyages d'affaires importées.
  • ICON_URI : URI public d'une icône qui s'affiche à côté du nom de votre agent Dialogflow. Vous pouvez également fournir une image encodée en base64 dans icon.content.
  • DIALOGFLOW_PROJECT_ID : ID du projet Google Cloud qui identifie l'emplacement de votre agent Dialogflow.
  • DIALOGFLOW_LOCATION : emplacement géographique spécifique où votre agent Dialogflow est hébergé, par exemple global ou us-central1.
  • DIALOGFLOW_AGENT_ID : identifiant unique de votre agent Dialogflow.

La réponse à cette commande renvoie tous les champs de la ressource d'agent Dialogflow nouvellement créée, y compris son nom de ressource unique dans le champ "name" (nom). Ce nom de ressource pourra être utilisé pour les futures mises à jour ou références.

Lister les agents connectés à une application

L'exemple de code suivant montre comment obtenir les détails de tous les agents connectés à votre application :

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"

Remplacez les variables par des valeurs :

  • ENDPOINT_LOCATION- : région multirégionale pour votre requête API. Attribuez l'une des valeurs suivantes :
    • us- pour la multirégion des États-Unis
    • eu- pour la multirégion de l'UE
    • global- pour l'emplacement "Global"
    Pour en savoir plus, consultez Spécifier une région multiple pour votre datastore.
  • PROJECT_ID : ID de votre projet Google Cloud .
  • LOCATION : région multiple de votre application : global, us ou eu.
  • APP_ID : ID de votre application Gemini Enterprise.

Si votre agent n'est pas prédéfini par Google, la réponse inclut un champ name dans les premières lignes. La valeur de ce champ contient l'ID de l'agent à la fin du chemin d'accès. Par exemple, dans la réponse suivante, l'ID de l'agent est 12345678901234567890 :

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

Afficher les détails d'un agent Dialogflow

L'exemple de code suivant montre comment récupérer les détails d'un agent enregistré auprès de 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"

Remplacez les variables par des valeurs :

  • ENDPOINT_LOCATION- : région multirégionale pour votre requête API. Attribuez l'une des valeurs suivantes :
    • us- pour la multirégion des États-Unis
    • eu- pour la multirégion de l'UE
    • global- pour l'emplacement "Global"
    Pour en savoir plus, consultez Spécifier une région multiple pour votre datastore.
  • PROJECT_ID : ID de votre projet Google Cloud .
  • LOCATION : région multiple de votre application : global, us ou eu.
  • APP_ID : ID de votre application Gemini Enterprise.
  • AGENT_ID : ID de l'agent. Vous pouvez trouver l'ID de l'agent en listant les agents connectés à votre application.

Mettre à jour un agent Dialogflow

Vous pouvez mettre à jour tous les champs fournis lors de l'enregistrement de l'agent. Les champs suivants sont obligatoires lors de la mise à jour :

  • displayName
  • description
  • reasoning_engine

Lorsque vous mettez à jour un champ, tous les champs et leurs valeurs doivent être redéfinis dans la requête de mise à jour, même si aucun changement n'est apporté à un champ particulier.

Cet exemple de code montre comment mettre à jour l'enregistrement de votre agent 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"
      }
    }'

Remplacez les variables par des valeurs :

  • PROJECT_ID : ID de votre projet Google Cloud .
  • AGENT_RESOURCE_NAME : nom de ressource de l'enregistrement de l'agent à mettre à jour.
  • DISPLAY_NAME : nom à afficher de l'agent.
  • DESCRIPTION : description de l'agent affichée dans Gemini Enterprise. La description n'est là que pour l'utilisateur.
  • ICON_URI : URI public d'une icône qui s'affiche à côté du nom de votre agent Dialogflow. Vous pouvez également fournir une image encodée en base64 dans icon.content.
  • REASONING_ENGINE_LOCATION : emplacement cloud du moteur de raisonnement pour lequel vous créez un agent.
  • DIALOGFLOW_AGENT_ID : identifiant unique de votre agent Dialogflow.

Supprimer un agent Dialogflow

L'exemple de code suivant montre comment supprimer un agent connecté à votre application :

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"

Remplacez les variables par des valeurs :

  • ENDPOINT_LOCATION- : région multirégionale pour votre requête API. Attribuez l'une des valeurs suivantes :
    • us- pour la multirégion des États-Unis
    • eu- pour la multirégion de l'UE
    • global- pour l'emplacement "Global"
    Pour en savoir plus, consultez Spécifier une région multiple pour votre datastore.
  • PROJECT_ID : ID de votre projet Google Cloud .
  • LOCATION : région multiple de votre application : global, us ou eu
  • APP_ID : ID de votre application Gemini Enterprise.
  • AGENT_ID : ID de l'agent. Vous pouvez trouver l'ID de l'agent en listant les agents connectés à votre application.