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

Ao registrar um agente, ele passa de um componente isolado para uma parte detectável e integrada do seu ecossistema de IA no Agent Registry. Ao publicar as habilidades do seu agente, você permite que outros desenvolvedores e agentes de orquestração na sua organização encontrem e reutilizem seu trabalho, acelerando o desenvolvimento geral de IA.

Neste guia de início rápido, mostramos como registrar manualmente um agente simulado no Registro de agentes 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

Antes de começar, configure o Agent Registry. Você precisa do ID do projeto para realizar essas tarefas.

Ative a API Agent Registry:

Console

Funções necessárias para ativar APIs

Para ativar as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin), que contém a permissão serviceusage.services.enable. Saiba como conceder papéis.

Ativar a API

gcloud

Ative a API Agent Registry no projeto:

gcloud services enable agentregistry.googleapis.com \
    --project=PROJECT_ID

Substitua PROJECT_ID pelo ID do projeto.

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. 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 Agent Registry, registre manualmente um agente simulado colando um exemplo de card do agente Agent2Agent (A2A).

Siga estas etapas para registrar o agente:

  1. No console do Google Cloud , acesse Registro de agentes:

    Acessar o Agent Registry

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

  2. No seletor de projetos, escolha o projeto 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. Copie e cole o seguinte conteúdo de exemplo do cartão do 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 do agente e o registra.

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 habilidades 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 EXCLUIR para confirmar a ação.
  4. Clique em Excluir.

A seguir