Se usó la API de Cloud Translation para traducir esta página.

Registra y administra agentes de A2A

Agent-to-Agent (A2A) es un protocolo de comunicación abierto y un lenguaje universal para los agentes. Permite que los agentes de diferentes creadores y plataformas se descubran, colaboren y deleguen tareas de forma segura. En este documento, se explica cómo los administradores de Gemini Enterprise pueden conectar agentes creados con A2A y alojados en cualquier plataforma a Gemini Enterprise, lo que los pone a disposición de los usuarios en la app web de Gemini Enterprise.

Antes de comenzar

Asegúrate de tener lo siguiente:

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
Una app de Gemini Enterprise existente. Para crear una app, consulta Cómo crear una app.
Es un agente que usa el protocolo A2A.

Configura los detalles de autorización

Crea credenciales de OAuth 2.0 para que el agente acceda a los recursos de Google Cloud , como las tablas de BigQuery, en nombre de un usuario.

Obtén detalles de la autorización

Sigue estos pasos para obtener los detalles de la autorización.

En la consola de Google Cloud , en la página APIs y servicios, ve a la página Credenciales.

Ir a Credenciales
Selecciona el proyecto Google Cloud que tiene la fuente de datos a la que quieres que acceda el agente. Por ejemplo, selecciona el proyecto que contiene el conjunto de datos de BigQuery que deseas que consulte el agente.
Haz clic en Crear credenciales y, luego, selecciona ID de cliente OAuth.
En Tipo de aplicación, selecciona Aplicación web.
En la sección URIs de redireccionamiento autorizados, agrega los siguientes URIs:
- https://vertexaisearch.cloud.google.com/oauth-redirect
- https://vertexaisearch.cloud.google.com/static/oauth/oauth.html
Haz clic en Crear.
En el panel Se creó el cliente de OAuth, haz clic en Descargar JSON. El archivo JSON descargado incluye Client ID, Authorization URI, Token URI y Client secret para el proyectoGoogle Cloud seleccionado. Necesitas estos detalles para crear un recurso de autorización:

Agrega un recurso de autorización a Gemini Enterprise

Ejecuta el siguiente comando para registrar un recurso de autorización con Gemini Enterprise:

REST

curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/authorizations?authorizationId=AUTH_ID" \
   -d '{
      "name": "projects/PROJECT_ID/locations/LOCATION/authorizations/AUTH_ID",
      "serverSideOauth2": {
         "clientId": "OAUTH_CLIENT_ID",
         "clientSecret": "OAUTH_CLIENT_SECRET",
         "authorizationUri": "OAUTH_AUTH_URI",
         "tokenUri": "OAUTH_TOKEN_URI"
      }
   }'

Reemplaza lo siguiente:

PROJECT_ID: el ID de tu proyecto.
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.
LOCATION: Es la multirregión de tu almacén de datos: global, us o eu.
AUTH_ID: Es el ID del recurso de autorización. Es un ID alfanumérico arbitrario que defines. Deberás hacer referencia a este ID más adelante cuando registres un agente que requiera compatibilidad con OAuth.
OAUTH_CLIENT_ID: Es el identificador de cliente de OAuth 2.0 que obtuviste cuando creaste las credenciales de OAuth.
OAUTH_CLIENT_SECRET: Es el secreto del cliente de OAuth 2.0 que obtuviste cuando creaste las credenciales de OAuth.
OAUTH_AUTH_URI: Es el URI de autorización que obtuviste cuando creaste las credenciales de OAuth. Tiene el siguiente formato: https://accounts.google.com/o/oauth2/v2/auth?client_id=CLIENT_ID&redirect_uri=https%3A%2F%2Fvertexaisearch.cloud.google.com%2Fstatic%2Foauth%2Foauth.html&scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fbigquery&include_granted_scopes=true&response_type=code&access_type=offline&prompt=consent
OAUTH_TOKEN_URI: Es el URI del token que obtuviste cuando creaste las credenciales de OAuth.

Registra un agente de A2A con Gemini Enterprise

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

Console

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

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

Gemini Enterprise
Haz clic en el nombre de la app en la que quieres registrar el agente.
Haz clic en Agentes > Agregar agentes.
En la sección Elige un tipo de agente, haz clic en Agregar para Agente personalizado a través de A2A.

En el campo JSON de la tarjeta del agente, ingresa los detalles de la tarjeta del agente en formato JSON. Para obtener una lista completa de los campos disponibles, consulta la Especificación oficial del protocolo Agent2Agent (A2A). En el siguiente ejemplo, solo se usan los campos obligatorios.

Por ejemplo:

{
  "protocolVersion": "v1.0",
  "name": "Hello World Agent",
  "description": "Just a hello world agent",
  "url": "https://example.com/myagent",
  "iconUrl": "data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iOTkiIGhlaWdodD0iOTkiIHN0eWxlPSJiYWNrZ3JvdW5kLWNvbG9yOmdyYXk7IiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjxwYXRoIGQ9Ik0zMyAwaDMzdjMzSDMzeiBNMCAzM2gzM3YzM0gweiBNNjYgMzNoMzN2MzNINjZ6IE0zMyA2NmgzM3YzM0gzM3oiIGZpbGw9ImJsdWUiLz48L3N2Zz4=",
  "version": "1.0.0",
  "capabilities": {
  },
  "skills": [
    {
      "id": "data-analysis",
      "name": "Data Analysis",
      "description": "Data analysis",
      "tags": []
    }
  ],
  "defaultInputModes": [
    "text/plain"
  ],
  "defaultOutputModes": [
    "text/plain"
  ]
}

Haz clic en Preview agent details > Next.
Completa la configuración con uno de los siguientes métodos:
- Si quieres que el agente acceda a Google Cloud recursos en tu nombre, sigue estos pasos:
  1. Ingresa el ID de cliente, el secreto de cliente, el URI de autorización y el URI de token que generaste en la sección Obtén detalles de autorización.
  2. Ingresa los alcances.
  3. Haz clic en Finalizar.
- Si no quieres que el agente acceda a los recursos en tu nombre, haz clic en Omitir y finalizar. Google Cloud

REST

Para crear y registrar un agente con Gemini Enterprise, usa el método agents.create. El siguiente comando solo usa los campos obligatorios. Para obtener una lista completa de los campos disponibles, consulta la Especificación oficial del protocolo Agent2Agent (A2A).

Ejecuta este comando para registrar tu agente A2A en Gemini Enterprise:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant/agents \
-d '
{
  "name": "AGENT_NAME",
  "displayName": "AGENT_DISPLAY_NAME",
  "description": "AGENT_DESCRIPTION",
  "a2aAgentDefinition": {
    "jsonAgentCard": "{\"protocolVersion\":\"PROTOCOLVERSION\",\"name\":\"AGENT_NAME\",\"description\":\"AGENT_DESCRIPTION\",\"url\":\"AGENT_URL\",\"version\":\"AGENT_VERSION\",\"defaultInputModes\":[\"INPUT_MODE\"],\"defaultOutputModes\":[\"OUTPUT_MODE\"],\"capabilities\":{ CAPABILITIES },\"skills\":[SKILLS]}"
  },
  "authorizationConfig": {
    "agentAuthorization": "projects/PROJECT_ID/locations/LOCATION/authorizations/AUTH_ID"
  }
}
'

Reemplaza lo siguiente:

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.
LOCATION: Es la multirregión de tu almacén de datos: global, us o eu.
PROJECT_ID: el ID de tu proyecto.
APP_ID: Es el ID de la app con la que deseas registrar el agente.
AGENT_NAME: Es el identificador único del agente.
AGENT_DISPLAY_NAME: Es el nombre del agente que se muestra en la app web.
AGENT_DESCRIPTION: Es la descripción de lo que puede hacer el agente.
PROTOCOLVERSION: Es la versión del protocolo A2A que admite el agente. Para obtener más información sobre las versiones compatibles, consulta las notas de la versión de A2A.
AGENT_URL: Es la URL del extremo del agente.
AGENT_VERSION: Es la versión del agente.
INPUT_MODE: Es el tipo de medio de entrada predeterminado. Por ejemplo, application/json o text/plain.
OUTPUT_MODE: Es el tipo de medio de salida predeterminado. Por ejemplo, text/plain" o image/png.
CAPABILITIES: Es un objeto JSON que contiene las funciones de A2A compatibles. Por ejemplo, \"streaming\": true o \"pushNotifications\": false.
SKILLS: Es una lista del objeto AgentSkill que ofrece el agente.
authorizationConfig: Si obtuviste los detalles de autorización y quieres que el agente acceda a los recursos de Google Cloud en nombre del usuario, agrega el campo authorization_config a tu recurso JSON.
- AUTH_ID: Es el valor que usaste para AUTH_ID en la sección Agrega un recurso de autorización a Gemini Enterprise.

Ejemplo de comando y resultado

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://global-discoveryengine.googleapis.com/v1alpha/projects/123456/locations/global/collections/default_collection/engines/my-app/assistants/default_assistant/agents \
-d '
{
  "name": "Hello World Agent",
  "displayName": "Hello World Agent",
  "description": "Just a hello world agent",
  "a2aAgentDefinition": {
    "jsonAgentCard": "{\"protocolVersion\":\"0.3.0\",\"name\":\"Hello World Agent\",\"description\":\"Just a hello world agent\",\"url\":\"https://example.com/myagent\",\"version\":\"1.0.0\",\"defaultInputModes\":[\"text\"],\"defaultOutputModes\":[\"text\"],\"capabilities\":{},\"skills\":[{\"description\":\"Chat with the Gemini agent.\",\"examples\":[\"Hello, world!\"],\"id\":\"chat\",\"name\":\"Chat Skill\",\"tags\":[\"chat\"]}]}"
  }
}
'

{
  "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/assistants/default_assistant/agents/12345678901234567890",
  "displayName": "Hello World Agent",
  "description": "Just a hello world agent",
  "createTime": "2025-10-20T20:53:35.490600996Z",
  "state": "ENABLED",
  "a2aAgentDefinition": {
    "jsonAgentCard": "{\"protocolVersion\":\"0.3.0\",\"name\":\"Hello World Agent\",\"description\":\"Just a hello world agent\",\"url\":\"https://example.com/myagent\",\"version\":\"1.0.0\",\"capabilities\":{},\"defaultInputModes\":[\"text\"],\"defaultOutputModes\":[\"text\"],\"skills\":[{\"id\":\"chat\",\"name\":\"Chat Skill\",\"description\":\"Chat with the Gemini agent.\",\"tags\":[\"chat\"],\"examples\":[\"Hello, world!\"]}]}"
  }
}

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",
...
}

Ejemplo de comando y resultado

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

{
  "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/assistants/default_assistant/agents/12345678901234567890",
  "displayName": "Hello World Agent",
  "description": "Just a hello world agent",
  "createTime": "2025-10-20T20:53:35.490600996Z",
  "state": "ENABLED",
  "a2aAgentDefinition": {
    "jsonAgentCard": "{\"name\":\"Hello World Agent\",\"description\":\"Just a hello world agent\",\"url\":\"https://example.com/myagent\",\"version\":\"1.0.0\",\"capabilities\":{},\"default_input_modes\":[\"text\"],\"default_output_modes\":[\"text\"],\"skills\":[{\"id\":\"chat\",\"name\":\"Chat Skill\",\"description\":\"Chat with the Gemini agent.\",\"tags\":[\"chat\"],\"examples\":[\"Hello, world!\"]}]}"
  }
}

Cómo ver los detalles de un agente de A2A

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.

Ejemplo de comando y resultado

curl -X GET \
-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",
  "displayName": "Hello World Agent",
  "description": "Just a hello world agent",
  "createTime": "2025-10-20T20:53:35.490600996Z",
  "state": "ENABLED",
  "a2aAgentDefinition": {
    "jsonAgentCard": "{\"name\":\"Hello World Agent\",\"description\":\"Just a hello world agent\",\"url\":\"https://example.com/myagent\",\"version\":\"1.0.0\",\"capabilities\":{},\"default_input_modes\":[\"text\"],\"default_output_modes\":[\"text\"],\"skills\":[{\"id\":\"chat\",\"name\":\"Chat Skill\",\"description\":\"Chat with the Gemini agent.\",\"tags\":[\"chat\"],\"examples\":[\"Hello, world!\"]}]}"
  }
}

Actualiza un agente de A2A

Puedes modificar los detalles de un agente de A2A existente registrado en Gemini Enterprise con la consola de Google Cloud o la API de REST.

Console

Para actualizar un agente de A2A con la consola de Google Cloud , sigue estos pasos:

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

Gemini Enterprise
Haz clic en el nombre de la app que incluye el agente que deseas actualizar.
Haz clic en Agentes.
Haz clic en el nombre del agente de A2A (personalizado) que deseas actualizar y, luego, en Editar.

En el campo JSON de la tarjeta del agente, actualiza los detalles de la tarjeta del agente en formato JSON. Para obtener una lista completa de los campos disponibles, consulta la Especificación oficial del protocolo Agent2Agent (A2A). En el siguiente ejemplo, solo se usan los campos obligatorios.

Por ejemplo:

{
  "protocolVersion": "v3.0",
  "name": "Hello World Agent",
  "description": "Just a hello world agent",
  "url": "https://example.com/myagent",
  "iconUrl": "data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iOTkiIGhlaWdodD0iOTkiIHN0eWxlPSJiYWNrZ3JvdW5kLWNvbG9yOmdyYXk7IiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjxwYXRoIGQ9Ik0zMyAwaDMzdjMzSDMzeiBNMCAzM2gzM3YzM0gweiBNNjYgMzNoMzN2MzNINjZ6IE0zMyA2NmgzM3YzM0gzM3oiIGZpbGw9ImJsdWUiLz48L3N2Zz4=",
  "version": "1.1.0",
  "capabilities": {
  },
  "skills": [
    {
      "id": "data-analysis",
      "name": "Data Analysis",
      "description": "Data analysis",
      "tags": []
    }
  ],
  "defaultInputModes": [
    "text/plain"
  ],
  "defaultOutputModes": [
    "text/plain"
  ]
}

Haz clic en Guardar.

REST

Para actualizar los detalles de un agente de A2A registrado en Gemini Enterprise, usa el método agents.patch. El siguiente comando solo usa los campos obligatorios. Para obtener una lista completa de los campos disponibles, consulta la Especificación oficial del protocolo Agent2Agent (A2A).

Ejecuta este comando para actualizar tu agente de A2A con Gemini Enterprise:

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant/agents/AGENT_ID \
-d '
{
  "name": "AGENT_NAME",
  "displayName": "AGENT_DISPLAY_NAME",
  "description": "AGENT_DESCRIPTION",
  "a2aAgentDefinition": {
    "jsonAgentCard": "{\"protocolVersion\":\"PROTOCOLVERSION\",\"name\":\"AGENT_NAME\",\"description\":\"AGENT_DESCRIPTION\",\"url\":\"AGENT_URL\",\"version\":\"AGENT_VERSION\",\"defaultInputModes\":[\"INPUT_MODE\"],\"defaultOutputModes\":[\"OUTPUT_MODE\"],\"capabilities\":{ CAPABILITIES },\"skills\":[SKILLS]}"
  },
  "authorizationConfig": {
    "agentAuthorization": "projects/PROJECT_ID/locations/LOCATION/authorizations/AUTH_ID"
  }
}
'

Reemplaza lo siguiente:

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.
LOCATION: Es la multirregión de tu almacén de datos: global, us o eu.
PROJECT_ID: el ID de tu proyecto.
APP_ID: Es el ID de la app en la que deseas registrar el agente.
AGENT_ID: ID del agente Puedes encontrar el ID del agente enumerando los agentes conectados a tu app.
AGENT_NAME: Es el identificador único del agente.
AGENT_DISPLAY_NAME: Es el nombre del agente que se muestra en la app web.
AGENT_DESCRIPTION: Es la descripción de lo que puede hacer el agente.
PROTOCOLVERSION: Es la versión del protocolo A2A que admite el agente. Para obtener más información sobre las versiones compatibles, consulta las notas de la versión de A2A.
AGENT_URL: Es la URL del extremo del agente.
AGENT_VERSION: Es la versión del agente.
INPUT_MODE: Es el tipo de medio de entrada predeterminado. Por ejemplo, application/json o text/plain.
OUTPUT_MODE: Es el tipo de medio de salida predeterminado. Por ejemplo, text/plain o image/png.
CAPABILITIES: Es un objeto JSON que contiene las funciones de A2A compatibles. Por ejemplo, \"streaming\": true o \"pushNotifications\": false.
SKILLS: Es una lista del objeto AgentSkill que ofrece el agente.
authorizationConfig: Si obtuviste los detalles de autorización y quieres que el agente acceda a los recursos de Google Cloud en nombre del usuario, agrega el campo authorization_config a tu recurso JSON.
- AUTH_ID: Es el valor que usaste para AUTH_ID en la sección Agrega un recurso de autorización a Gemini Enterprise.

Ejemplo de comando y resultado

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://global-discoveryengine.googleapis.com/v1alpha/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/assistants/default_assistant/agents/12345678901234567890 \
-d '
{
  "name": "Hello World Agent",
  "displayName": "Hello World Agent",
  "description": "Just a hello world agent",
  "a2aAgentDefinition": {
    "jsonAgentCard": "{\"protocolVersion\":\"0.3.0\",\"name\":\"Hello World Agent\",\"description\":\"Just a hello world agent\",\"url\":\"https://example.com/myagent\",\"version\":\"1.1.0\",\"defaultInputModes\":[\"text\"],\"defaultOutputModes\":[\"text\"],\"capabilities\":{  },\"skills\":[{\"description\":\"Chat with the Gemini agent.\",\"examples\":[\"Hello, world!\"],\"id\":\"chat\",\"name\":\"Chat Skill\",\"tags\":[\"chat\"]}]}"
  }
}
'

{
  "name": "projects/my-project-123/locations/global/collections/default_collection/engines/my-app/assistants/default_assistant/agents/12345678901234567890",
  "displayName": "Hello World Agent",
  "description": "Just a hello world agent",
  "createTime": "2025-10-20T20:53:35.490600996Z",
  "state": "ENABLED",
  "a2aAgentDefinition": {
    "jsonAgentCard": "{\"name\":\"Hello World Agent\",\"description\":\"Just a hello world agent\",\"url\":\"https://example.com/myagent\",\"version\":\"1.0.0\",\"capabilities\":{},\"defaultInputModes\":[\"text\"],\"defaultOutputModes\":[\"text\"],\"skills\":[{\"id\":\"chat\",\"name\":\"Chat Skill\",\"description\":\"Chat with the Gemini agent.\",\"tags\":[\"chat\"],\"examples\":[\"Hello, world!\"]}]}"
  }P
}

Borra un agente de A2A

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.

Ejemplo de comando y resultado

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
}

¿Qué sigue?

Usa el agente que registraste con Gemini Enterprise en la app web.

Registra y administra agentes de A2A Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Antes de comenzar

Configura los detalles de autorización

Obtén detalles de la autorización

Agrega un recurso de autorización a Gemini Enterprise

REST

Registra un agente de A2A con Gemini Enterprise

Console

REST

Ejemplo de comando y resultado

Enumera los agentes conectados a una app

REST

Ejemplo de comando y resultado

Cómo ver los detalles de un agente de A2A

REST

Ejemplo de comando y resultado

Actualiza un agente de A2A

Console

REST

Ejemplo de comando y resultado

Borra un agente de A2A

REST

Ejemplo de comando y resultado

¿Qué sigue?

Registra y administra agentes de A2A