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

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

Este guia de início rápido mostra como registrar manualmente um agente simulado no Agent Registry usando o Google Cloud console. 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.

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 do 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 personalizados papéis ou outros predefinidos papéis.

Registrar um agente simulado

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

Siga estas etapas para registrar o agente:

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

    Acessar o Agent Registry

  2. No seletor de projetos, selecione o Google Cloud projeto 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 card de agente de exemplo:

    {
  "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, encontre o agente simulado na lista.
  2. Clique no nome do agente para conferir 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, encontre 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