Usar o registro automático

O Agent Registry pode descobrir e registrar agentes hospedados em tempos de execuçãoGoogle Cloud compatíveis sem que você precise chamar manualmente a API Agent Registry. Dependendo do ambiente de execução, esse processo de registro acontece automaticamente ou requer uma etapa de configuração de ativação durante a implantação.

Este documento explica como ativar a descoberta de agentes em runtimes compatíveis. Se você hospedar um agente externamente ou em um ambiente de execução não compatível, consulte Usar o registro manual.

Os metadados e as habilidades extraídos de um agente durante o registro dependem do protocolo dele. Para mais informações, consulte Registrar agentes.

Registrar agentes do Vertex AI Agent Engine

Se você desenvolver agentes com o Vertex AI Agent Engine e implantá-los usando o SDK da Vertex AI, o registro no Agent Registry será automático.

O protocolo Agent2Agent (A2A) é um padrão aberto que permite que os agentes declarem suas capacidades e identidade. O exemplo a seguir mostra como implantar um agente que implementa o protocolo A2A no Vertex AI Agent Engine. Para mais informações, consulte Implantar um agente.

# Create and deploy the agent
# This action automatically registers the agent in Agent Registry
remote_agent = client.agent_engines.create(
    agent=my_a2a_agent, # Your defined A2A object
    config={
        "display_name": "my-support-agent",
        "description": "An agent that handles support tickets.",
        "requirements": ["google-cloud-aiplatform[agent_engines,langchain]"],
    },
)

À medida que você atualiza ou exclui seu agente no Vertex AI Agent Engine, o Agent Registry sincroniza automaticamente essas mudanças.

Registrar agentes integrados do Google

Os agentes integrados do Google, como os do Google Workspace e do Gemini Enterprise, são integrados automaticamente ao Registro de agentes. Não é necessário realizar nenhuma etapa de configuração ou implantação. Esses agentes são ingeridos e estão disponíveis para descoberta no seu registro.

Registrar agentes do GKE

É possível registrar agentes implantados no Google Kubernetes Engine adicionando a anotação apphub.cloud.google.com/functional-type: "AGENT" às suas implantações. Essa anotação identifica a implantação como um agente de IA, permitindo que o Agent Registry faça uma verificação de introspecção.

O exemplo a seguir mostra um manifesto de implantação do agente do GKE. Para mais informações, consulte Implantar e orquestrar agentes de IA.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-agent
  annotations:
    # Identifies the workload as an AI agent
    apphub.cloud.google.com/functional-type: "AGENT"
spec:
  selector:
    matchLabels:
      app: my-agent
  template:
    metadata:
      labels:
        app: my-agent
    spec:
      containers:
      - name: server
        image: gcr.io/my-project/my-agent:1.0.0

Quando a implantação é aplicada, o cluster do GKE tenta buscar metadados do agente e os sincroniza diretamente no modelo de dados do registro de agentes.

Verificar o registro

Para verificar se o Agent Registry registrou seus agentes, liste-os:

Console

  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.

    A página mostra uma lista de todos os agentes registrados e os detalhes deles, como nome, identificador, descrição, tempo de execução e local.

  4. Filtre a lista pelo local do agente ou pelo recurso de tempo de execução dele:

    • Para filtrar por local, clique no menu Local, selecione os locais que você quer filtrar e clique em Aplicar.
    • Para filtrar por tempo de execução, clique no menu Tempo de execução, selecione os tempos que você quer filtrar e clique em Aplicar.

    A página mostra uma lista filtrada dos agentes registrados para as condições selecionadas.

gcloud

Se você tiver vários agentes ou quiser confirmar o registro de um agente específico, como um agente registrado automaticamente, filtre a lista pelos metadados do agente.

Para fazer isso, verifique se você configurou seu ambiente da Google Cloud CLI para o Agent Registry e execute:

gcloud alpha agent-registry agents list \
  --project=PROJECT_ID \
  --location=REGION \
  --filter="FILTER_EXPRESSION"

Substitua:

  • PROJECT_ID: o ID do projeto.
  • REGION: a região do registro.
  • FILTER_EXPRESSION: a expressão de filtro para os agentes que você quer filtrar. Por exemplo, para filtrar por nome de exibição, use displayName='DISPLAY_NAME'. Para filtrar pelo identificador (URN) globalmente exclusivo, use agentId='urn:agent:AGENT_URN'.

Os serviços integrados do Google usam um formato de URN que depende de onde o agente é implantado. Por exemplo, é possível descobrir agentes integrados do Google Workspace filtrando sua lista pelo editor googleapis.com usando --filter="agentId:'urn:agent:googleapis.com:*'".