Usar o registro automático

Visualizar

Esse produto ou recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos gerais de serviço" dos Termos específicos de serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

O Agent Registry pode descobrir e registrar agentes hospedados em runtimes compatíveis sem que você precise chamar manualmente a API Agent Registry.Google Cloud Dependendo do runtime, esse processo de registro acontece automaticamente ou exige 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 runtime 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 seguinte exemplo 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 o 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 Agent Registry. Não é necessário realizar nenhuma etapa de configuração ou implantação. Esses agentes são ingeridos e ficam disponíveis para descoberta no registro.

Registrar agentes do GKE

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

O exemplo a seguir mostra um manifesto de implantação de 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 automaticamente os metadados do agente e os sincroniza diretamente no modelo de dados do Agent Registry.

Verificar o registro

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

Console

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.

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

4. Filtre a lista pelo local do agente ou pelo recurso de runtime:

   • Para filtrar por local, clique no menu Local , selecione os locais que você quer filtrar e clique em Aplicar.
   • Para filtrar por runtime, clique no menu Runtime , selecione os runtimes 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 registrado automaticamente, filtre a lista pelos metadados do agente.

Para fazer isso, verifique se você configurou o 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, você pode usar displayName='DISPLAY_NAME'. Para filtrar pelo identificador globalmente exclusivo (URN), 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 a lista pelo googleapis.com editor usando --filter="agentId:'urn:agent:googleapis.com:*'"