Registrar y gestionar agentes de Dialogflow

En esta página se describe cómo registrar y usar agentes de Dialogflow con Gemini Enterprise.

Información general

Para usar un agente de Dialogflow con Gemini Enterprise, primero debes desplegarlo y, después, registrarlo. Al registrar tu agente de Dialogflow, se vincula el agente implementado a Gemini Enterprise para que puedan comunicarse.

Antes de empezar

Antes de registrar tu agente de Dialogflow, debes asegurarte de que se han completado estos pasos:

Registrar un agente de Dialogflow en Gemini Enterprise

Puedes registrar tu agente de Dialogflow en Gemini Enterprise mediante laGoogle Cloud consola o la API REST. El registro hace que tu agente esté disponible para los usuarios de una aplicación de Gemini Enterprise.

Consola

Para registrar un agente de Dialogflow mediante la consola Google Cloud , sigue estos pasos:

  1. En la Google Cloud consola, ve a la página Gemini Enterprise.

    Ir a Gemini Enterprise

  2. Selecciona el proyecto.

  3. Haz clic en el nombre de la aplicación en la que quieras registrar el agente.

  4. Haz clic en Agentes > Añadir agentes. Aparecerá el panel Elige un tipo de agente.

  5. En la tarjeta Agente personalizado a través de Dialogflow, haz clic en Añadir para registrar tu agente de Dialogflow en Gemini Enterprise. Se abrirá el panel Configuración.

  6. Para configurar tu agente, sigue estos pasos:

    1. Escribe un nombre en el campo Nombre del agente. Este valor aparece en Gemini Enterprise como el nombre visible de tu agente.

    2. Escribe una descripción en el campo Describe tu agente. Un LLM usa este valor para determinar si debe invocar a tu agente en respuesta a una consulta de un usuario.

    3. Introduce la ruta del recurso del agente de Dialogflow que quieras registrar en Gemini Enterprise en el campo Fuente del agente de Dialogflow.

      Utiliza este formato: projects/{project}/locations/{location}/agents/{agent}

      La opción Disponibilidad del agente, Cuando se selecciona, está activada de forma predeterminada.

    4. En la sección Configuración de la herramienta, escribe una descripción en el campo Descripción de la herramienta. La LLM usa esta descripción para entender la finalidad de la herramienta y decidir cuándo usarla.

    5. Escribe el nombre en el campo Nombre del parámetro de entrada. Es el nombre del parámetro de la llamada a la función. Este nombre de parámetro da una pista al LLM sobre el tipo de contenido que se espera que contenga el parámetro, como un question, un command o un search_query.

    6. Introduce la descripción en el campo Descripción del parámetro de entrada. Es una descripción de los parámetros de la llamada a la función. Esta descripción proporciona al LLM más información sobre el parámetro, como el tipo de contenido que se espera que se transfiera y las acciones que se deben realizar.

    7. Haz clic en Crear.

curl

En este ejemplo de código se muestra cómo puedes registrar tu 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"
      }
    }'

Sustituye las variables por los valores correspondientes:

  • PROJECT_ID: el ID de tu proyecto de Google Cloud .
  • APP_ID: el ID de tu aplicación de Gemini Enterprise.
  • DISPLAY_NAME: el nombre fácil de usar de tu agente que se muestra en Gemini Enterprise.
  • DESCRIPTION: una breve explicación de lo que hace tu agente que los usuarios pueden ver en Gemini Enterprise. Por ejemplo, extraer información clave de las facturas subidas para viajes de negocios.
  • ICON_URI: el URI público de un icono que se muestra junto al nombre de tu agente de Dialogflow. También puedes proporcionar una imagen codificada en Base64 en icon.content.
  • DIALOGFLOW_PROJECT_ID: el ID de proyecto que identifica la ubicación de tu agente de Dialogflow. Google Cloud
  • DIALOGFLOW_LOCATION: la ubicación geográfica específica en la que se aloja tu agente de Dialogflow, como global o us-central1.
  • DIALOGFLOW_AGENT_ID: el identificador único de tu agente de Dialogflow.

La respuesta correcta a este comando devuelve todos los campos del recurso de agente de Dialogflow recién creado, incluido su nombre de recurso único en el campo name. Este nombre de recurso se puede usar en futuras actualizaciones o referencias.

Mostrar los agentes conectados a una aplicación

En el siguiente ejemplo de código se muestra cómo obtener los detalles de todos los agentes conectados a tu aplicación:

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"

Sustituye las variables por los valores correspondientes:

  • ENDPOINT_LOCATION-: la multirregión de tu solicitud a la API. Asigna uno de los siguientes valores:
    • us- para la multirregión de EE. UU.
    • eu- para la multirregión de la UE
    • global- para la ubicación global
    Para obtener más información, consulta el artículo sobre cómo especificar una multirregión para tu almacén de datos.
  • PROJECT_ID: el ID de tu proyecto de Google Cloud .
  • LOCATION: la multirregión de tu aplicación: global, us o eu.
  • APP_ID: el ID de tu aplicación de Gemini Enterprise.

Si Google no ha precompilado tu agente, la respuesta incluye un campo name en las primeras líneas. El valor de este campo contiene el ID del agente al final de la ruta. Por ejemplo, en la siguiente respuesta, el ID de agente es 12345678901234567890:

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

Ver los detalles de un agente de Dialogflow

En el siguiente código de ejemplo se muestra cómo puedes obtener los detalles de un agente que se ha registrado en 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"

Sustituye las variables por los valores correspondientes:

  • ENDPOINT_LOCATION-: la multirregión de tu solicitud a la API. Asigna uno de los siguientes valores:
    • us- para la multirregión de EE. UU.
    • eu- para la multirregión de la UE
    • global- para la ubicación global
    Para obtener más información, consulta el artículo sobre cómo especificar una multirregión para tu almacén de datos.
  • PROJECT_ID: el ID de tu proyecto de Google Cloud .
  • LOCATION: la multirregión de tu aplicación: global, us o eu.
  • APP_ID: el ID de tu aplicación de Gemini Enterprise.
  • AGENT_ID: el ID del agente. Puedes encontrar el ID del agente consultando la lista de agentes conectados a tu aplicación.

Actualizar un agente de Dialogflow

Se pueden actualizar todos los campos que se proporcionaron durante el registro del agente. Los siguientes campos son obligatorios durante el proceso de actualización:

  • displayName
  • description
  • reasoning_engine

Cuando actualice un campo, todos los campos y sus valores deben volver a definirse en la solicitud de actualización, aunque no se haga ningún cambio en un campo concreto.

En este código de ejemplo se muestra cómo puedes actualizar el registro de tu agente de 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"
      }
    }'

Sustituye las variables por los valores correspondientes:

  • PROJECT_ID: el ID de tu proyecto de Google Cloud .
  • AGENT_RESOURCE_NAME: nombre del recurso de la inscripción del agente que se va a actualizar.
  • DISPLAY_NAME:nombre visible del agente.
  • DESCRIPTION: la descripción del agente que se muestra en Gemini Enterprise. La descripción solo es para el usuario.
  • ICON_URI: el URI público de un icono que se muestra junto al nombre de tu agente de Dialogflow. También puedes proporcionar una imagen codificada en Base64 en icon.content.
  • REASONING_ENGINE_LOCATION: la ubicación en la nube del motor de razonamiento en el que estás creando un agente.
  • DIALOGFLOW_AGENT_ID: el identificador único de tu agente de Dialogflow.

Eliminar un agente de Dialogflow

En el siguiente ejemplo de código se muestra cómo puedes eliminar un agente que esté conectado a tu aplicación:

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"

Sustituye las variables por los valores correspondientes:

  • ENDPOINT_LOCATION-: la multirregión de tu solicitud a la API. Asigna uno de los siguientes valores:
    • us- para la multirregión de EE. UU.
    • eu- para la multirregión de la UE
    • global- para la ubicación global
    Para obtener más información, consulta el artículo sobre cómo especificar una multirregión para tu almacén de datos.
  • PROJECT_ID: el ID de tu proyecto de Google Cloud .
  • LOCATION: la multirregión de tu aplicación: global, us o eu
  • APP_ID: el ID de tu aplicación de Gemini Enterprise.
  • AGENT_ID: el ID del agente. Puedes encontrar el ID del agente consultando la lista de agentes conectados a tu aplicación.