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 implementar y, luego, registrar tu agente. El registro de 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 estos pasos:

Registra un agente de Dialogflow con Gemini Enterprise

Puedes registrar tu agente de Dialogflow con Gemini Enterprise mediante la Google Cloud consola 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 Google Cloud consola de, sigue estos pasos:

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

    Ir a Gemini Enterprise

  2. Elige tu proyecto.

  3. Haz clic en el nombre de la app con 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 con Gemini Enterprise. Se abrirá el panel Configuración.

  6. Para configurar tu agente, sigue estos pasos:

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

    2. Ingresa una descripción en el campo Describe tu agente. 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 quieres registrar con 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. 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 con valores:

  • PROJECT_ID: el ID de tu Google Cloud proyecto.
  • APP_ID: el ID de tu app de Gemini Enterprise.
  • DISPLAY_NAME: el nombre fácil de usar para tu agente que se muestra en Gemini Enterprise.
  • DESCRIPTION: una breve explicación de lo que hace tu agente que es visible para los usuarios 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 ícono que se muestra junto a tu nombre de agente de Dialogflow. También puedes proporcionar una imagen codificada en Base64 en icon.content.
  • DIALOGFLOW_PROJECT_ID: el ID del 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 muestra todos los campos del recurso del agente de Dialogflow recién creado, 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 con valores:

  • ENDPOINT_LOCATION: Es la región múltiple para tu solicitud a la API. Especifica 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: el ID de tu Google Cloud proyecto.
  • LOCATION: la multirregión de tu app: global, us o eu.
  • APP_ID: el ID de tu app de Gemini Enterprise.

Si Google no creó 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 de acceso. 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",
...
}

Consulta los detalles de un agente de Dialogflow

En la 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 con valores:

  • ENDPOINT_LOCATION: Es la región múltiple para tu solicitud a la API. Especifica 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: el ID de tu Google Cloud proyecto.
  • LOCATION: la multirregión de tu app: global, us o eu.
  • APP_ID: el ID de tu app de Gemini Enterprise.
  • AGENT_ID: el ID del agente. Puedes encontrar el ID del agente mediante la enumeración de 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 volver a definirse 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 con valores:

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

Borra un agente de Dialogflow

En la siguiente muestra de código, se muestra cómo puedes 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 con valores:

  • ENDPOINT_LOCATION: Es la región múltiple para tu solicitud a la API. Especifica 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: el ID de tu Google Cloud proyecto.
  • LOCATION: la multirregión de tu app: global, us o eu
  • APP_ID: el ID de tu app de Gemini Enterprise.
  • AGENT_ID: el ID del agente. Puedes encontrar el ID del agente mediante la enumeración de los agentes conectados a tu app.