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

Registrar um agente o transforma de uma carga de trabalho isolada em um componente detectável no Agent Registry. Ao publicar as habilidades do seu agente, você permite que outros desenvolvedores e agentes orquestradores da sua organização encontrem e reutilizem seu trabalho, acelerando o desenvolvimento de IA.

Este guia de início rápido mostra 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.

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

  2. No seletor de projetos, selecione 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:

    • Nome de exibição: Mock Travel Agent
    • Descrição: A mock agent that plans travel itineraries.
    • Local: selecione global.
    • Tipo de agente: selecione A2A.

  6. Na seção Especificação do agente, 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 Agente de viagens simulado na lista.
  2. Clique em Agente de viagens simulado 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, localize Agente de viagens simulado na lista.
  2. Clique no menu Mais opções ao lado de Agente de viagens simulado e selecione Excluir.
  3. Na caixa de diálogo de confirmação, clique em Excluir.

A seguir