Mit der 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 Runtime erfolgt diese Registrierung automatisch oder erfordert einen Konfigurationsschritt zur Aktivierung während der Bereitstellung.
In diesem Dokument wird erläutert, wie Sie die Erkennung für Agenten auf unterstützten Runtimes aktivieren. Wenn Sie einen Agenten extern oder auf einer nicht unterstützten Runtime hosten, siehe Manuelle Registrierung verwenden.
Die Metadaten und A2A-Skills, die während der Registrierung aus einem Agenten extrahiert werden, hängen vom Protokoll des Agenten ab. Weitere Informationen finden Sie unter Agenten registrieren.
Hinweis
Bevor Sie Agenten registrieren, richten Sie die Agent Registry ein. 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 eingerichtet haben.
Agenten aus der Agent Runtime registrieren
Wenn Sie Agenten mit der Agent Runtime auf der 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 Fähigkeiten 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 Agenten 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-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 Agenten werden aufgenommen und können in Ihrer Registry erkannt werden.
Agenten aus GKE registrieren
Sie können Agenten registrieren, die in
Google Kubernetes Engine (GKE)
bereitgestellt wurden, indem Sie Ihren
Bereitstellungen das Label registry.gke.io/functional-type: "AGENT" hinzufügen. Dieses Label kennzeichnet die Bereitstellung als KI-Agenten, sodass die Agent Registry eine Introspektionsprüfung durchführen kann.
Wenn Sie die automatische Erkennung der Skills des Agenten aktivieren möchten, müssen Sie auch die Annotation a2a-protocol.org/agent-card angeben. Der Aufnahmesteuerung verwendet diese Annotation, um die A2A-Agentenkarte abzufragen.
Das folgende Beispiel zeigt ein GKE-Manifest für die Bereitstellung von Agenten mit diesen Konfigurationen. Weitere Informationen finden Sie unter KI-Agenten 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 die Bereitstellung angewendet wird, versucht der GKE-Cluster automatisch, Metadaten vom Agenten abzurufen und sie direkt mit dem Datenmodell der Agent Registry zu synchronisieren.
Agenten aus Cloud Run registrieren
Sie können Agenten registrieren, die in
Cloud Run bereitgestellt wurden, indem Sie
die --functional-type=agent und --identity-type=agent-identity Flags
während der Bereitstellung angeben. Das Flag --functional-type=agent kennzeichnet die Cloud Run-Arbeitslast als KI-Agenten und nicht als standardmäßige containerisierte Anwendung, sodass die Agent Registry eine Introspektionsprüfung durchführen kann.
Für Arbeitslasten, die mit --functional-type=agent konfiguriert wurden, muss das Flag --identity-type=agent-identity angegeben werden. Bei der Bereitstellung mit einem anderen Identitätstyp tritt ein Fehler auf.
Sie können Agenten als Cloud Run-Dienste oder -Jobs bereitstellen. Informationen zum Bereitstellen eines Agenten als Dienst oder Job in Cloud Run finden Sie unter Agent Platform-Funktionen für Cloud Run konfigurieren.
Die Agent Registry versucht automatisch, Metadaten vom Agenten abzurufen.
Bei Agenten, die dem Agent2Agent-Protokoll (A2A) entsprechen, wird der
/.well-known/agent-card.json Endpunkt gescannt, um die Registry mit den
Agenten- A2A-Skills zu füllen. Weitere Informationen finden Sie unter
A2A-Agenten in Cloud Run bereitstellen.
Bei der automatischen Registrierung werden nur Ressourcen erkannt, die im selben Google Cloud Projekt bereitgestellt wurden. Informationen zum Registrieren von Agenten, die in verschiedenen Projekten bereitgestellt wurden, finden Sie unter Manuelle Registrierung.
Registrierung bestätigen
Sie können prüfen, ob die Agent Registry Ihre Agenten erfolgreich registriert hat, indem Sie sie auflisten:
Console
Rufen Sie in der Google Cloud Console die Seite 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 Agenten aus.
Auf der Seite wird eine Liste aller registrierten Agenten und ihrer Details angezeigt, z. B. Name, ID, Beschreibung, Runtime und Standort.
Filtern Sie die Liste nach dem Standort des Agenten oder seiner Runtime-Ressource:
- Wenn Sie nach Standort filtern möchten, klicken Sie auf das Menü Standort , wählen Sie die Standorte aus, nach denen Sie filtern möchten, und klicken Sie auf Anwenden.
- Wenn Sie nach Runtime filtern möchten, klicken Sie auf das Menü Runtime , wählen Sie die Runtimes aus, nach denen Sie filtern möchten, und klicken Sie auf Anwenden.
Auf der Seite wird eine gefilterte Liste der registrierten Agenten für die ausgewählten Bedingungen angezeigt.
gcloud
Sie können die Liste nach den Metadaten des Agenten filtern. Prüfen Sie, ob Sie Ihre Google Cloud CLI-Umgebung für die Agent Registry eingerichtet haben , 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-RegionFILTER_EXPRESSION: der Filterausdruck für die Agenten, nach denen Sie filtern möchten Wenn Sie beispielsweise nach Anzeigenamen filtern möchten, können Sie verwendendisplayName='DISPLAY_NAME'. Wenn Sie nach der global eindeutigen ID (URN) filtern möchten, können SieagentId='urn:agent:AGENT_URN'verwenden.
Integrierte Google-Agenten verwenden ein URN-Format, das davon abhängt, wo der Agent bereitgestellt wird. Sie können beispielsweise integrierte Google Workspace-Agenten erkennen, indem Sie Ihre Liste mit
nach dem Herausgeber googleapis.com filtern
--filter="agentId:'urn:agent:googleapis.com:*'".
Terraform
Verweisen Sie in anderen Terraform-Konfigurationen auf Ihren registrierten Agenten, indem Sie die Datenquelle google_agent_registry_agent verwenden:
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-RegionDISPLAY_NAME: der für Menschen lesbare Anzeigename des Agenten