Registra y administra agentes de Dialogflow

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

Descripción general

Para usar un agente de Dialogflow con Gemini Enterprise, primero debes implementarlo y, luego, registrarlo. Registrar tu agente de Dialogflow vincula el agente implementado a Gemini Enterprise para que puedan comunicarse.

Antes de comenzar

Antes de registrar tu agente de Dialogflow, debes asegurarte de que se completen los siguientes pasos:

  • Implementa tu agente de Dialogflow. Para ver el panel de Dialogflow y los agentes conversacionales, consulta Agentes conversacionales.

  • El rol de administrador de Discovery Engine

  • Habilita la API de Discovery Engine. Para habilitar la API de Discovery Engine para el proyecto de Google Cloud, en la consola de Google Cloud, ve a la página de la API de Discovery Engine. Google Cloud

    Ir a la API de Discovery Engine

  • Crea una app de Gemini Enterprise. Para obtener más información, consulta Crea una app.

Registra un agente de Dialogflow en Gemini Enterprise

Puedes registrar tu agente de Dialogflow en Gemini Enterprise con la consola deGoogle Cloud o la API de REST. El registro hace que tu agente esté disponible para los usuarios dentro de una app de Gemini Enterprise.

Console

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

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

    Ir a Gemini Enterprise

  2. Elige tu proyecto.

  3. Haz clic en el nombre de la app en la que quieres registrar el agente.

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

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

  6. Para configurar tu agente, sigue estos pasos:

    1. Ingresa un nombre en el campo Tu nombre de agente. Este valor aparece en Gemini Enterprise como el nombre visible de tu agente.

    2. Ingresa una descripción en el campo Describe your agent. Un LLM usa este valor para determinar si debe invocar tu agente en respuesta a una consulta del usuario.

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

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

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

    4. En la sección Configuración de la herramienta, ingresa una descripción en el campo Descripción de la herramienta. El LLM usa esta descripción para comprender el propósito de la herramienta y decidir cuándo usarla.

    5. Ingresa el nombre en el campo Nombre del parámetro de entrada. Este es el nombre del parámetro para la llamada a función. El nombre de este parámetro le 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. Ingresa la descripción en el campo Input parameter description. Esta es una descripción del parámetro para la llamada a función. Esta descripción le proporciona al LLM más información sobre el parámetro, como qué tipo de contenido se espera que se pase y qué acciones se deben realizar.

    7. Haz clic en Crear.

curl

En esta muestra 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"
      }
    }'

Reemplaza las variables por valores:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • APP_ID: Es el ID de tu app de Gemini Enterprise.
  • DISPLAY_NAME: Es el nombre fácil de usar de tu agente que se muestra en Gemini Enterprise.
  • DESCRIPTION: Es una breve explicación de lo que hace tu agente, que los usuarios de Gemini Enterprise pueden ver. Por ejemplo, extrae información clave de las facturas subidas para viajes de negocios.
  • ICON_URI: Es el URI público de un ícono 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: Es el Google Cloud ID del proyecto que identifica la ubicación de tu agente de Dialogflow.
  • DIALOGFLOW_LOCATION: Es la ubicación geográfica específica en la que se aloja tu agente de Dialogflow, como global o us-central1.
  • DIALOGFLOW_AGENT_ID: Es el identificador único de tu agente de Dialogflow.

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

Enumera los agentes conectados a una app

En la siguiente muestra de código, se muestra cómo puedes obtener los detalles de todos los agentes conectados a tu 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"

Reemplaza las variables por valores:

  • ENDPOINT_LOCATION-: Es la región múltiple para 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 Cómo especificar una región múltiple para tu almacén de datos.
  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • LOCATION: Es la multirregión de tu app: global, us o eu.
  • APP_ID: Es el ID de tu app de Gemini Enterprise.

Si Google no creó previamente tu agente, la respuesta incluirá 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 del agente es 12345678901234567890:

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

Cómo ver los detalles de un agente de Dialogflow

En el siguiente muestra de código, se muestra cómo puedes recuperar los detalles de un agente que se registró 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"

Reemplaza las variables por valores:

  • ENDPOINT_LOCATION-: Es la región múltiple para 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 Cómo especificar una región múltiple para tu almacén de datos.
  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • LOCATION: Es la multirregión de tu app: global, us o eu.
  • APP_ID: Es el ID de tu app de Gemini Enterprise.
  • AGENT_ID: ID del agente. Puedes encontrar el ID del agente enumerando los agentes conectados a tu app.

Actualiza 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 actualizas un campo, todos los campos y sus valores deben redefinirse en la solicitud de actualización, incluso si no se realizan cambios en un campo en particular.

En esta muestra de código, 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"
      }
    }'

Reemplaza las variables por valores:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • AGENT_RESOURCE_NAME: Es el nombre del recurso del registro del agente que se actualizará.
  • DISPLAY_NAME:Es el nombre visible del agente.
  • DESCRIPTION: Es la descripción del agente que se muestra en Gemini Enterprise. La descripción es solo para el beneficio del usuario.
  • ICON_URI: Es el URI público de un ícono 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: Es la ubicación en la nube del motor de inferencia en el que creas un agente.
  • DIALOGFLOW_AGENT_ID: Es el identificador único de tu agente de Dialogflow.

Borra un agente de Dialogflow

En la siguiente muestra de código, se indica cómo borrar un agente conectado a tu 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"

Reemplaza las variables por valores:

  • ENDPOINT_LOCATION-: Es la región múltiple para 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 Cómo especificar una región múltiple para tu almacén de datos.
  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • LOCATION: Es la multirregión de tu app: global, us o eu.
  • APP_ID: Es el ID de tu app de Gemini Enterprise.
  • AGENT_ID: ID del agente Puedes encontrar el ID del agente enumerando los agentes conectados a tu app.