Enregistrer et gérer des agents Dialogflow

Aperçu

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

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 pour qu'ils puissent communiquer.

Avant de commencer

Avant d'enregistrer votre agent Dialogflow, vous devez vous assurer que les étapes suivantes ont été effectuées :

• Déployer votre agent Dialogflow Pour afficher le tableau de bord Dialogflow et des agents conversationnels, consultez Agents conversationnels.

• Le rôle Administrateur Gemini Enterprise.

• Activez l'API Discovery Engine. Pour activer l'API Discovery Engine pour le projet Google Cloud, accédez à la page API Discovery Engine dans la console Google Cloud .

  Accéder à l'API Discovery Engine

• Créez une application Gemini Enterprise. Pour en savoir plus, consultez Créer une application.

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'une application Gemini Enterprise d'accéder à votre agent.

Quota d'enregistrement des agents et licences : l'enregistrement d'un agent auprès d'une application consomme une unité du quota quotidien de création d'agents de votre projet (discoveryengine.googleapis.com/agents_tier_enterprise_regional). Le quota est déterminé par le nombre de licences Gemini Enterprise Standard (une création par utilisateur et par jour, regroupées) ou Plus (10 par utilisateur et par jour, regroupées) distribuées au projet. Les licences Frontline n'offrent aucun quota de création.

Si vous enregistrez un agent de backend dans plusieurs applications ou moteurs Gemini Enterprise du même projet, chaque appel d'API d'enregistrement (agents.create) est comptabilisé comme une création d'agent dans ce quota quotidien. Les scripts de déploiement automatisés ou les pipelines CI/CD qui enregistrent un agent sur de nombreuses applications peuvent rencontrer l'erreur HTTP 429 RESOURCE_EXHAUSTED: Agent creation quota exceeded si le nombre d'appels d'enregistrement par jour dépasse le nombre de licences Standard distribuées. Assurez-vous que votre projet dispose d'un nombre suffisant de licences Standard avant de déployer plusieurs applications. Pour en savoir plus, consultez Quotas de création quotidiens.

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, Lorsqu'elle est sélectionnée, est définie par défaut.

   4. 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 les informations clés des factures importées pour les voyages d'affaires.
• 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". Ce nom de ressource peut être utilisé pour de 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 : emplacement multirégional de votre requête API. Spécifiez l'une des valeurs suivantes :
  • us pour l'emplacement multirégional US
  • eu pour l'emplacement multirégional EU
  • global pour l'emplacement mondial
  Pour en savoir plus, consultez Spécifier un emplacement multirégional pour votre datastore.
• PROJECT_ID : ID de votre projet Google Cloud .
• LOCATION : emplacement multirégional 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 : emplacement multirégional de votre requête API. Spécifiez l'une des valeurs suivantes :
  • us pour l'emplacement multirégional US
  • eu pour l'emplacement multirégional EU
  • global pour l'emplacement mondial
  Pour en savoir plus, consultez Spécifier un emplacement multirégional pour votre datastore.
• PROJECT_ID : ID de votre projet Google Cloud .
• LOCATION : emplacement multirégional 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 répertoriant les agents connectés à votre application.

Mettre à jour un agent Dialogflow

Tous les champs fournis lors de l'enregistrement de l'agent peuvent être mis à jour. Les champs suivants sont obligatoires lors du processus de mise à jour :

• displayName
• description
• reasoning_engine

Lors de la mise à jour d'un champ, tous les champs et leurs valeurs doivent être redéfinis dans la requête de mise à jour, même si aucune modification n'est apportée à 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 d'agent à mettre à jour.
• DISPLAY_NAME : nom à afficher de l'agent.
• DESCRIPTION : description de l'agent affichée dans Gemini Enterprise. La description n'est utile qu'à 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 dans 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 : emplacement multirégional de votre requête API. Spécifiez l'une des valeurs suivantes :
  • us pour l'emplacement multirégional US
  • eu pour l'emplacement multirégional EU
  • global pour l'emplacement mondial
  Pour en savoir plus, consultez Spécifier un emplacement multirégional pour votre datastore.
• PROJECT_ID : ID de votre projet Google Cloud .
• LOCATION : emplacement multirégional 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 répertoriant les agents connectés à votre application.

Exemple de commande et résultat

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://global-discoveryengine.googleapis.com/v1alpha/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/assistants/default_assistant/agents/12345678901234567890"

{
  "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/assistants/default_assistant/agents/12345678901234567890/operations/delete-agent-12345678901234567890",
  "done": true
}