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

Ao registrar um agente, ele deixa de ser um componente isolado e passa a ser uma parte detectável e integrada do seu ecossistema de IA no Agent Registry. Ao publicar as habilidades do agente, você permite que outros desenvolvedores e agentes orquestradores da 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:

    {
  "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. 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