Guía de inicio rápido: Registra un agente

Registrar un agente en Agent Registry te permite convertir un componente aislado en una parte detectable de tu ecosistema de IA. Cuando publicas las habilidades de A2A de tu agente, ayudas a otros desarrolladores y agentes de organización de tu organización a encontrar y reutilizar tu trabajo.

En esta guía de inicio rápido, registrarás de forma manual un agente simulado en el Registro de agentes con la consola de Google Cloud . Para obtener más información sobre los mecanismos de registro de agentes en el Registro de agentes, consulta Registra agentes.

Antes de comenzar

  1. Configura el Registro de agentes.
  2. Obtén el ID del proyecto para el proyecto de administración en el que está habilitado el Registro de agentes.

Roles obligatorios

Para obtener los permisos que necesitas para registrar agentes en el Registro de agentes, pídele a tu administrador que te otorgue el rol de IAM de editor de la API de Agent Registry (roles/agentregistry.editor) en el proyecto de administración en el que está habilitado el Registro de agentes. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Registra un agente simulado

Para probar el Registro de agentes, puedes registrar manualmente un agente de prueba pegando una tarjeta de agente de Agent2Agent (A2A) de ejemplo.

Sigue estos pasos para registrar el agente:

  1. En la consola de Google Cloud , ve a Agent Registry:

    Ir al registro de agentes

    Si se te solicita, haz clic en Habilitar para habilitar la API de Agent Registry.

  2. En el selector de proyectos, elige el proyecto de Google Cloud en el que configuraste Agent Registry.

  3. Selecciona la pestaña Agentes.

  4. Haz clic en Agregar agente.

  5. En el panel Detalles del agente, ingresa los siguientes detalles:

    • Tipo: Selecciona A2A.
    • Región: Selecciona global (Global).

  6. Selecciona la pestaña Pegar JSON.

  7. Pega el siguiente contenido de ejemplo de la tarjeta de agente:

    {
  "supportedInterfaces": [
    {
      "url": "https://example.com/mock-travel-agent",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0.0"
    }
  ],
  "name": "mock-travel-agent",
  "description": "A mock agent that plans travel itineraries.",
  "version": "1.0.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "defaultInputModes": ["text/plain"],
  "defaultOutputModes": ["text/plain"],
  "skills": [
    {
      "id": "BookFlight",
      "name": "BookFlight",
      "description": "Books a flight to a destination.",
      "tags": ["travel", "booking"]
    },
    {
      "id": "SearchHotels",
      "name": "SearchHotels",
      "description": "Searches for hotels in a destination city.",
      "tags": ["travel", "accommodation"]
    }
  ]
}

  8. Haz clic en Guardar.

Agent Registry procesa la tarjeta del agente y lo registra.

Verifica el registro

Para confirmar que tu agente simulado se registró correctamente, haz lo siguiente:

  1. En la pestaña Agentes, busca el agente simulado en la lista.
  2. Haz clic en el nombre del agente para ver sus detalles.
  3. Verifica que los intents de A2A BookFlight y SearchHotels aparezcan en la pestaña Descripción general.

Realiza una limpieza

Para evitar dejar recursos simulados en tu proyecto, borra el agente registrado:

  1. En la pestaña Agentes, busca el agente simulado en la lista.
  2. Haz clic en el menú Más opciones en la columna Acciones del agente simulado y selecciona Borrar.
  3. En el cuadro de diálogo de confirmación, ingresa DELETE para confirmar la acción.
  4. Haz clic en Borrar.

¿Qué sigue?