Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Automatische Registrierung verwenden

In Agent Registry können Agenten registriert werden, die auf unterstützten Google Cloud Runtimes gehostet werden, ohne dass Sie die Agent Registry API manuell aufrufen müssen. Je nach Laufzeit erfolgt die Registrierung automatisch oder erfordert einen Konfigurationsschritt während der Bereitstellung.

In diesem Dokument wird beschrieben, wie Sie die Erkennung für Agents in unterstützten Runtimes aktivieren. Wenn Sie einen Agenten extern oder in einer nicht unterstützten Laufzeitumgebung hosten, lesen Sie den Abschnitt Manuelle Registrierung verwenden.

Die Metadaten und Skills, die während der Registrierung eines Agents extrahiert werden, hängen vom Protokoll des Agents ab. Weitere Informationen finden Sie unter Agents registrieren.

Hinweis

Bevor Sie Agenten registrieren, müssen Sie die Agent Registry einrichten. Sie benötigen Ihre Projekt-ID, um die Registrierung zu bestätigen.

Wenn Sie die Google Cloud CLI-Befehle in diesem Dokument verwenden möchten, müssen Sie Ihre gcloud CLI-Umgebung einrichten.

KI-Agenten über Agent Runtime registrieren

Wenn Sie Agenten mit der Agent Runtime on Gemini Enterprise Agent Platform entwickeln und bereitstellen, erfolgt die Registrierung in der Agent Registry automatisch.

Das Agent2Agent-Protokoll (A2A) ist ein offener Standard, mit dem Agenten ihre Funktionen und Identität deklarieren können. Das folgende Beispiel zeigt, wie Sie einen Agenten, der das A2A-Protokoll implementiert, in der Agent Runtime bereitstellen. Weitere Informationen finden Sie unter Agent bereitstellen.

# 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]"],
    },
)

Wenn Sie Ihren Agenten in Agent Runtime aktualisieren oder löschen, werden diese Änderungen automatisch mit Agent Registry synchronisiert.

Integrierte Google-KI-Agenten registrieren

Integrierte Google-Agenten wie Google Workspace- und Gemini Enterprise-Agenten werden automatisch in der Agent Registry registriert. Sie müssen keine Konfigurations- oder Bereitstellungsschritte ausführen. Diese Agents werden aufgenommen und sind in Ihrer Registry auffindbar.

KI-Agenten aus GKE registrieren

Sie können Agenten, die in der Google Kubernetes Engine (GKE) bereitgestellt werden, registrieren, indem Sie Ihren Deployments die Annotation apphub.cloud.google.com/functional-type: "AGENT" hinzufügen. Mit dieser Annotation wird das Deployment als KI-Agent identifiziert, sodass die Agent Registry einen Introspektionsscan durchführen kann.

Das folgende Beispiel zeigt ein Manifest für die Bereitstellung des GKE-Agents. Weitere Informationen finden Sie unter KI-Agents bereitstellen und orchestrieren.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-agent
  annotations:
    # Identifies the deployment 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

Wenn die Bereitstellung angewendet wird, versucht der GKE-Cluster automatisch, Metadaten vom Agent abzurufen und direkt mit dem Datenmodell der Agent Registry zu synchronisieren.

Registrierung bestätigen

Sie können prüfen, ob Ihre Agenten erfolgreich in der Agent Registry registriert wurden, indem Sie sie auflisten:

Console

Rufen Sie in der Google Cloud Console die Agent Registry auf:

Zur Agent Registry
Wählen Sie in der Projektauswahl das Google Cloud Projekt aus, in dem Sie die Agent Registry eingerichtet haben.
Wählen Sie den Tab Agents aus.

Auf der Seite wird eine Liste aller registrierten Agents und ihrer Details angezeigt, z. B. Name, Kennung, Beschreibung, Laufzeit und Speicherort.
Filtern Sie die Liste nach dem Standort des Kundenservicemitarbeiters oder seiner Laufzeitressource:
- Wenn Sie nach Standort filtern möchten, klicken Sie auf das Menü Standort, wählen Sie die gewünschten Standorte aus und klicken Sie auf Übernehmen.
- Wenn Sie nach Laufzeit filtern möchten, klicken Sie auf das Menü Laufzeit, wählen Sie die gewünschten Laufzeiten aus und klicken Sie auf Übernehmen.
Auf der Seite wird eine gefilterte Liste der registrierten Kundenservicemitarbeiter für die ausgewählten Bedingungen angezeigt.

gcloud

Sie können die Liste nach den Metadaten des Agents filtern. Richten Sie Ihre Google Cloud CLI-Umgebung für die Agent Registry ein und führen Sie dann Folgendes aus:

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

Ersetzen Sie Folgendes:

PROJECT_ID: die Projekt-ID
REGION: Die Registry-Region.
FILTER_EXPRESSION: Der Filterausdruck für die Agents, die Sie filtern möchten. Wenn Sie beispielsweise nach dem Anzeigenamen filtern möchten, können Sie displayName='DISPLAY_NAME' verwenden. Wenn Sie nach der global eindeutigen Kennung (URN) filtern möchten, können Sie agentId='urn:agent:AGENT_URN' verwenden.

Integrierte Google-Agents verwenden ein URN-Format, das davon abhängt, wo der Agent bereitgestellt wird. Sie können beispielsweise integrierte Google Workspace-Agents finden, indem Sie Ihre Liste nach dem Publisher googleapis.com filtern und dabei --filter="agentId:'urn:agent:googleapis.com:*'" verwenden.

Terraform

Verweisen Sie in anderen Terraform-Konfigurationen mit der Datenquelle google_agent_registry_agent auf Ihren registrierten Agent:

data "google_agent_registry_agent" "my_agent" {
  location = "REGION"
  filter = "displayName=\"DISPLAY_NAME\""
}

output "agent_urn" {
  value = data.google_agent_registry_agent.my_agent.urn
}