In Agent Registry können Agenten registriert werden, die auf unterstütztenGoogle Cloud -Laufzeiten gehostet werden, ohne dass Sie die Agent Registry API manuell aufrufen müssen. Je nach Laufzeit erfolgt dieser Registrierungsprozess 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 Funktionen, die während der Registrierung für einen Agenten indexiert werden, hängen davon ab, ob der Agent das Agent2Agent-Protokoll (A2A) implementiert. 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 der Agent Runtime aktualisieren oder löschen, werden diese Änderungen automatisch mit der Agent Registry synchronisiert.
Integrierte Google-KI-Agenten registrieren
Integrierte Google-KI-Agenten wie Google Workspace- und Gemini Enterprise-KI-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 in Google Kubernetes Engine (GKE) bereitgestellte Agenten registrieren, indem Sie Ihren Deployments das Label registry.gke.io/functional-type: "AGENT" hinzufügen. Dieses Label kennzeichnet die Bereitstellung als KI-Agent-Arbeitslast. Der GKE-Cluster-Laufzeitcontroller wird dadurch angewiesen, einen In-Cluster-Introspektionsscan durchzuführen und den Agent in der Agent Registry zu registrieren.
Wenn Sie die automatische Erkennung der Fähigkeiten des Agenten aktivieren möchten, müssen Sie auch die Annotation a2a-protocol.org/agent-card angeben. Der GKE-Ingestion-Controller verwendet diese Annotation, um die A2A-Agentenkarte abzufragen.
Das folgende Beispiel zeigt ein Manifest für die Bereitstellung eines GKE-Agents mit diesen Konfigurationen. Weitere Informationen finden Sie unter KI-Agents bereitstellen und orchestrieren.
apiVersion: apps/v1
kind: Deployment
metadata:
name: my-agent
labels:
# GKE takes this label and registers the agent to Agent Registry
registry.gke.io/functional-type: "AGENT"
annotations:
# A2A protocol metadata annotation for automated Agent Card discovery
a2a-protocol.org/agent-card: |
card:
endpoint: /.well-known/agent-card.json
protocol: HTTP
port: 8080
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
ports:
- containerPort: 8080
env:
- name: PORT
value: "8080"
---
apiVersion: v1
kind: Service
metadata:
name: my-agent-service
labels:
app: my-agent
spec:
type: ClusterIP
ports:
- port: 8080
targetPort: 8080
protocol: TCP
name: http
selector:
app: my-agent
Wenn das Deployment angewendet wird, untersucht der GKE-Cluster-Laufzeitcontroller automatisch den Arbeitslastcontainer, fragt den in der Annotation deklarierten Agent Card-Endpunkt ab und synchronisiert die Metadaten und A2A-Skills des Agents direkt mit dem Datenmodell der Agent Registry.
KI-Agents aus Cloud Run registrieren
Sie können in Cloud Run bereitgestellte Agents registrieren, indem Sie bei der Bereitstellung die Flags --functional-type=agent und --identity-type=agent-identity angeben. Das Flag --functional-type=agent identifiziert die Cloud Run-Arbeitslast als KI-Agent anstelle einer standardmäßigen Containeranwendung. Cloud Run wird dadurch angewiesen, den Agent in der Agent Registry zu registrieren.
Für Arbeitslasten, die mit --functional-type=agent konfiguriert sind, muss das Flag --identity-type=agent-identity angegeben werden. Die Bereitstellung mit einem anderen Identitätstyp führt zu einem Fehler.
Sie können Agents als Cloud Run-Dienste oder -Jobs bereitstellen. Informationen zum Bereitstellen eines Agents als Dienst oder Job in Cloud Run finden Sie unter Agent Platform-Funktionen für Cloud Run konfigurieren.
Bei der Registrierung fügt Cloud Run der Registry automatisch den Namen und den Typ des Agents (AGENT) hinzu. Weitere Informationen zum Bereitstellen von A2A-Agenten in Cloud Run finden Sie unter A2A-Agenten in Cloud Run bereitstellen.
Bei der automatischen Registrierung werden nur Ressourcen erkannt, die im selbenGoogle Cloud Projekt bereitgestellt werden. Informationen zum Registrieren von Agents, die in verschiedenen Projekten bereitgestellt werden, finden Sie unter Manuelle Registrierung.
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:
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 Agents 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-IDREGION: 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 SiedisplayName='DISPLAY_NAME'verwenden. Wenn Sie nach der global eindeutigen Kennung (URN) filtern möchten, können SieagentId='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 mit --filter="agentId:'urn:agent:googleapis.com:*'" nach dem Publisher googleapis.com filtern.
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
}
Ersetzen Sie Folgendes:
REGION: Die Registry-Region.DISPLAY_NAME: Der für Menschen lesbare Anzeigename des Agenten.