Guia de início rápido: registrar um agente

Ao registrar um agente no Agent Registry, você transforma um componente isolado em uma parte detectável do seu ecossistema de IA. Ao publicar as habilidades de A2A do seu agente, você ajuda outros desenvolvedores e agentes orquestradores da sua organização a encontrar e reutilizar seu trabalho.

Neste guia de início rápido, você vai registrar manualmente um agente simulado no Agent Registry usando o console do Google Cloud . Para mais informações sobre os mecanismos de registro de agentes no Agent Registry, consulte Registrar agentes.

Antes de começar

  1. Configure o Agent Registry.
  2. Consiga o ID do projeto para o projeto de governança em que o Agent Registry está ativado.

Funções exigidas

Para receber as permissões necessárias para registrar agentes no Agent Registry, peça ao administrador para conceder a você o papel do IAM de Editor da API Agent Registry (roles/agentregistry.editor) no projeto de governança em que o Agent Registry está ativado. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Registrar um agente simulado

Para testar o Registro de Agentes, você pode registrar manualmente um agente simulado colando um exemplo de card de agente Agent2Agent (A2A).

Siga estas etapas para registrar o agente:

  1. No console do Google Cloud , acesse Agent Registry:

    Acessar o Agent Registry

    Se solicitado, clique em Ativar para ativar a API Agent Registry.

  2. No seletor de projetos, selecione o projeto do Google Cloud em que você configurou o Agent Registry.

  3. Selecione a guia Agentes.

  4. Clique em Adicionar agente.

  5. No painel Detalhes do agente, insira os seguintes detalhes:

    • Tipo: selecione A2A.
    • Região: selecione global (Global).

  6. Selecione a guia Colar JSON.

  7. Cole o seguinte exemplo de conteúdo do card 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. Clique em Salvar.

O Agent Registry processa o card de agente e registra o agente.

Verificar o registro

Para confirmar se o agente simulado foi registrado, faça o seguinte:

  1. Na guia Agentes, localize o agente simulado na lista.
  2. Clique no nome do agente para ver os detalhes.
  3. Verifique se as skills de A2A BookFlight e SearchHotels aparecem na guia Visão geral.

Limpar

Para evitar deixar recursos simulados no projeto, exclua o agente registrado:

  1. Na guia Agentes, localize o agente simulado na lista.
  2. Clique no menu Mais opções na coluna Ações do agente simulado e selecione Excluir.
  3. Na caixa de diálogo de confirmação, digite DELETE para confirmar a ação.
  4. Clique em Excluir.

A seguir