Utilizzare la registrazione automatica

Agent Registry può rilevare e registrare gli agenti ospitati su runtimeGoogle Cloud supportati senza richiedere di chiamare manualmente l'API Agent Registry. A seconda del runtime, questa procedura di registrazione avviene automaticamente o richiede un passaggio di configurazione di attivazione durante il deployment.

Questo documento spiega come abilitare il rilevamento per gli agenti sui runtime supportati. Se ospiti un agente esternamente o su un runtime non supportato, consulta Utilizzare la registrazione manuale.

I metadati e le competenze estratti da un agente durante la registrazione dipendono dal protocollo dell'agente. Per ulteriori informazioni, consulta Registrare agenti.

Registrare gli agenti da Vertex AI Agent Engine

Se sviluppi agenti con Vertex AI Agent Engine ed esegui il deployment utilizzando l'SDK Vertex AI, la registrazione in Agent Registry è automatica.

Il protocollo Agent2Agent (A2A) è uno standard aperto che consente agli agenti di dichiarare le proprie funzionalità e la propria identità. L'esempio seguente mostra come eseguire il deployment di un agente che implementa il protocollo A2A in Vertex AI Agent Engine. Per saperne di più, consulta Eseguire il deployment di un 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]"],
    },
)

Quando aggiorni o elimini l'agente in Vertex AI Agent Engine, Agent Registry sincronizza automaticamente le modifiche.

Registrare gli agenti Google integrati

Gli agenti Google integrati, come gli agenti Google Workspace e Gemini Enterprise, sono integrati automaticamente con il registro degli agenti. Non è necessario eseguire passaggi di configurazione o deployment. Questi agenti vengono inseriti e sono disponibili per la scoperta all'interno del tuo registro.

Registra agenti da GKE

Puoi registrare gli agenti di cui è stato eseguito il deployment su Google Kubernetes Engine aggiungendo l'annotazione apphub.cloud.google.com/functional-type: "AGENT" ai tuoi deployment. Questa annotazione identifica il deployment come un agente AI, consentendo al servizio Agent Registry di eseguire una scansione di introspezione.

Il seguente esempio mostra un manifest di deployment dell'agente GKE. Per maggiori informazioni, consulta Esegui il deployment e l'orchestrazione degli agenti AI.

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 il deployment viene applicato, il cluster GKE tenta automaticamente di recuperare i metadati dall'agente e li sincronizza direttamente nelmodello dei datii del registro degli agenti.

Verifica la registrazione

Puoi verificare che Agent Registry abbia registrato correttamente i tuoi agenti elencandoli:

Console

  1. Nella console Google Cloud , vai a Registro agenti:

    Vai al registry degli agenti

  2. Nel selettore di progetti, seleziona il Google Cloud progetto in cui hai configurato Agent Registry.

  3. Seleziona la scheda Agenti.

    La pagina mostra un elenco di tutti gli agenti registrati e i relativi dettagli, ad esempio nome, identificatore, descrizione, runtime e posizione.

  4. Filtra l'elenco in base alla posizione dell'agente o alla sua risorsa di runtime:

    • Per filtrare in base alla località, fai clic sul menu Località, seleziona le località che vuoi filtrare e fai clic su Applica.
    • Per filtrare in base alla durata, fai clic sul menu Durata, seleziona le durate che vuoi filtrare e fai clic su Applica.

    La pagina mostra un elenco filtrato degli agenti registrati per le condizioni selezionate.

gcloud

Se hai più agenti o se vuoi confermare la registrazione di un agente specifico, ad esempio un agente registrato automaticamente, puoi filtrare l'elenco in base ai metadati dell'agente.

Per farlo, assicurati di aver configurato l'ambiente Google Cloud CLI per Agent Registry, quindi esegui:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto.
  • REGION: la regione del registro.
  • FILTER_EXPRESSION: l'espressione di filtro per gli agenti che vuoi filtrare. Ad esempio, per filtrare per nome visualizzato, puoi utilizzare displayName='DISPLAY_NAME'. Per filtrare in base all'identificatore (URN) univoco a livello globale, puoi utilizzare agentId='urn:agent:AGENT_URN'.

I servizi Google integrati utilizzano un formato URN che dipende dalla posizione in cui viene implementato l'agente. Ad esempio, puoi scoprire gli agenti Google Workspace integrati filtrando l'elenco in base all'editore googleapis.com utilizzando --filter="agentId:'urn:agent:googleapis.com:*'".