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

Registrar un agente lo transforma de una carga de trabajo aislada a un componente detectable dentro de Agent Registry. Cuando publicas las habilidades de tu agente, permites que otros desarrolladores y agentes orquestadores de tu organización encuentren y reutilicen tu trabajo, lo que acelera el desarrollo de la IA.

En esta guía de inicio rápido, se muestra cómo registrar manualmente un agente simulado en Agent Registry con la Google Cloud consola de. Para obtener más información sobre los mecanismos de registro de agentes en Agent Registry, consulta Registra agentes.

Antes de comenzar

Antes de comenzar, configura Agent Registry. Necesitas el ID del proyecto para realizar estas tareas.

Roles obligatorios

Para obtener los permisos que necesitas para registrar agentes en Agent Registry, pídele a tu administrador que te otorgue el rol de IAM Editor de la API de Agent Registry (roles/agentregistry.editor) en el proyecto. 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 Agent Registry, puedes registrar manualmente un agente simulado pegando una tarjeta de agente de Agent2Agent (A2A) de muestra.

Sigue estos pasos para registrar el agente:

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

    Ve a Agent Registry

  2. En el selector de proyectos, selecciona el Google Cloud proyecto 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:

    • Nombre visible: Mock Travel Agent
    • Descripción: A mock agent that plans travel itineraries.
    • Ubicación: Selecciona global.
    • Tipo de agente: Selecciona A2A.

  6. En la sección Especificación del agente, selecciona la pestaña Pegar JSON.

  7. Copia y pega el siguiente contenido de la tarjeta de agente de muestra:

    {
  "schemaVersion": "0.3",
  "agent": {
    "name": "mock-travel-agent",
    "description": "A mock agent that plans travel itineraries.",
    "skills": [
      {
        "name": "BookFlight",
        "description": "Books a flight to a destination."
      },
      {
        "name": "SearchHotels",
        "description": "Searches for hotels in a destination city."
      }
    ]
  }
}

  8. Haz clic en Guardar.

Agent Registry procesa la tarjeta de agente y registra el agente.

Verifica el registro

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

  1. En la pestaña Agentes, busca Mock Travel Agent en la lista.
  2. Haz clic en Mock Travel Agent para ver sus detalles.
  3. Verifica que las habilidades BookFlight y SearchHotels se muestren en la pestaña Descripción general.

Limpia

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

  1. En la pestaña Agentes, busca Mock Travel Agent en la lista.
  2. Haz clic en el Más opciones menú junto a Mock Travel Agent y selecciona Borrar.
  3. En el diálogo de confirmación, haz clic en Borrar.

¿Qué sigue?