Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

KI-Agenten verwalten

Mit Agent Registry können Sie registrierte KI-Agenten prüfen, aktualisieren und entfernen, damit die Registry die aktiven Funktionen in Ihrem KI-Ökosystem genau widerspiegelt. Sie können alle registrierten KI-Agenten auflisten und ansehen, die Metadaten oder den Endpunkt manuell registrierter KI-Agenten aktualisieren und nicht mehr verwendete KI-Agenten entfernen.

Hinweis

Agent Registry einrichten
Rufen Sie für eine Einrichtung mit einem einzelnen Projekt die Projekt-ID des Governance-Projekts ab, in dem die Agent Registry aktiviert ist. Wenn Sie eine Verwaltungsgrenze für mehrere Projekte konfiguriert haben, verwenden Sie die Projekt-ID Ihres Verwaltungsprojekts für die grenzübergreifende Erkennung und Registrierung oder geben Sie eine Mitgliedsprojekt-ID für Vorgänge in einem einzelnen Projekt an.
Registrieren Sie Ihre KI-Agenten in Agent Registry.
Wenn Sie die Google Cloud CLI-Befehle in diesem Dokument verwenden möchten, richten Sie Ihre gcloud CLI-Umgebung ein.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Agent Registry API Editor (roles/agentregistry.editor) für das Governance-Projekt zuzuweisen, in dem Agent Registry aktiviert ist, um die Berechtigungen zu erhalten, die Sie zum Verwalten registrierter Agenten in Agent Registry benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Verfügbare KI-Agenten entdecken

Nachdem Sie Agenten registriert haben, können Sie sie in Ihrer Umgebung finden und ihre detaillierten Konfigurationen wie Endpunkte, A2A-Skills und zugehörige Metadaten ansehen.

Alle KI-Agenten auflisten und ansehen

Sie können alle in Ihrer Umgebung registrierten Agenten auflisten und ihre detaillierten Konfigurationen wie Endpunkte, A2A-Skills und zugehörige Metadaten aufrufen.

Wenn Sie eine Verwaltungsgrenze konfiguriert haben, können Sie KI-Agenten aus mehreren Mitgliedsprojekten in Ihrem Verwaltungsprojekt auflisten.

So listen Sie Agenten auf:

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 Agent Registry eingerichtet haben.
Wählen Sie den Tab KI-Agenten aus.

Auf der Seite wird eine Liste aller registrierten KI-Agenten angezeigt. Die Liste enthält den Namen, die ID, den Typ, die Beschreibung, die Version, die Laufzeit und den Standort des KI-Agenten.
Wenn Sie die vollständigen Details eines KI-Agenten aufrufen möchten, klicken Sie auf den Namen des KI-Agenten.

gcloud

Führen Sie den Befehl gcloud agent-registry agents list aus, um alle Agenten an einem bestimmten Standort aufzulisten:

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

Ersetzen Sie Folgendes:

PROJECT_ID: Projekt-ID. Wenn Sie eine Verwaltungsgrenze konfiguriert haben, geben Sie die ID Ihres Verwaltungsprojekts an, um Agenten am angegebenen Standort in allen Mitgliedsprojekten innerhalb der Grenze aufzulisten. In jedem zurückgegebenen Ressourcennamen wird die ID des KI-Agenten beibehalten und das in der Anfrage angegebene Projekt verwendet.
REGION: der Standort der Registry, z. B. us-central1, eu oder global. Wenn Sie in einem Verwaltungsprojekt einen Standort angeben, werden KI-Agenten an diesem Standort über alle Mitgliedsprojekte in der Grenze hinweg zusammengefasst.

Registrierte KI-Agenten filtern

Wenn Sie mehrere Agenten haben oder die Registrierung eines bestimmten Agenten bestätigen möchten, können Sie die Liste nach den Metadaten des Agenten filtern:

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 KI-Agenten aus.

Auf der Seite wird eine Liste aller registrierten KI-Agenten angezeigt. Die Liste enthält den Namen, die ID, den Typ, die Beschreibung, die Version, die Laufzeit und den Standort des KI-Agenten.
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 Standorte aus, nach denen Sie filtern möchten, 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 Agents für die ausgewählten Bedingungen angezeigt.

gcloud

Wenn Sie die Agentenliste so filtern möchten, dass nur Ressourcen zurückgegeben werden, die mit bestimmten Metadaten übereinstimmen, übergeben Sie das Flag --filter an den Befehl gcloud agent-registry agents list:

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

Ersetzen Sie Folgendes:

PROJECT_ID: Projekt-ID.
REGION: die Registry-Region.
FILTER_EXPRESSION: der Filterausdruck für die Agenten, die Sie filtern möchten. Sie können beispielsweise die folgenden Filter verwenden:
- Verwenden Sie displayName='DISPLAY_NAME', um nach Anzeigenamen zu filtern.
- Wenn Sie nach der global eindeutigen Agent-Kennung (URN) suchen möchten, verwenden Sie agentId='urn:agent:AGENT_URN'.
- Wenn Sie ein Verwaltungsprojekt abfragen, können Sie mit project_id=MEMBER_PROJECT_ID nach einem bestimmten Mitgliedsprojekt filtern.

Terraform

Wenn Sie einen bestimmten registrierten Agenten abrufen möchten, indem Sie nach seinen Metadaten filtern, konfigurieren Sie die Datenquelle google_agent_registry_agent mit dem Argument filter:

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

Ersetzen Sie Folgendes:

REGION: die Registry-Region.
DISPLAY_NAME: Der menschenlesbare Name des KI-Agenten, nach dem gefiltert werden soll, z. B. Support Agent.

Details eines KI-Agenten ansehen

Details zu einem bestimmten Agenten ansehen, einschließlich seiner Protokolle, A2A-Fähigkeiten und Identität:

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 KI-Agenten aus.

Auf der Seite wird eine Liste aller registrierten KI-Agenten angezeigt. Die Liste enthält den Namen, die ID, den Typ, die Beschreibung, die Version, die Laufzeit und den Standort des KI-Agenten.
Klicken Sie auf den Namen des KI-Agenten, den Sie sich ansehen möchten.

Die Detailseite enthält Tabs für die Agentendetails.
Klicken Sie auf den entsprechenden Tab, um Details zu einem bestimmten KI-Agenten aufzurufen.

Die Verfügbarkeit von Funktionen hängt von Ihrer Laufzeit ab. Tabs wie Sitzungen, Playground, Memory und Bewertung sind spezifische Funktionen, die für Agenten angezeigt werden, die auf verwalteten Laufzeiten erstellt wurden, z. B. Agent Runtime auf der Gemini Enterprise Agent Platform:
- Übersicht: Wichtige Details zum KI-Agenten, einschließlich Name, ID, Standort, Beschreibung und Laufzeit. In der Übersicht werden auch A2A-Fähigkeiten und die Laufzeitreferenz angezeigt, die Sie zum Erstellen von Abfragen im Topologie-Diagramm benötigen.
- Beobachtbarkeit: anwendungsorientierte Informationen wie Latenz, Traffic, Fehler und Token-Ausgaben. Dieser Tab ist in Google Cloud Observability-Tools eingebunden, um Echtzeit-Leistungsmesswerte und die Auslastung auf Systemebene anzuzeigen. So können Sie Kosten und Nutzerfreundlichkeit verwalten. Weitere Informationen finden Sie in der Beobachtbarkeitsübersicht.
- Traces: Der genaue Pfad einer Unterhaltung wird Schritt für Schritt dargestellt, einschließlich detaillierter Formatierung von Eingabe- und Assistentennachrichten, um komplexe Reasoning Loops mit mehreren Agenten oder Fehler bei Toolaufrufen in Echtzeit zu beheben. Weitere Informationen finden Sie unter Agent-Traces ansehen.
- Sicherheit: Ergebnisse von Model Armor und Security Command Center, einschließlich Richtlinienverstößen, Risiken von Datenlecks und Compliance-Bewertungen. Weitere Informationen zur Sicherheit finden Sie unter Sicherheitsergebnisse ansehen.
- Topologie: Eine visuelle Darstellung der Beziehungen und Trafficflüsse zwischen einem KI-Agenten, dem zugewiesenen Agent Gateway und den MCP-Servern, mit denen er interagiert. Weitere Informationen zum KI-Agenten-Gateway finden Sie in der Übersicht über das KI-Agenten-Gateway. Weitere Informationen zur Topologie finden Sie unter Diagramme für einen registrierten Agenten ansehen.
- Identität: Der Agenten-Prinzipal, der für die Richtlinienerzwingung verwendet wird. Sie verwenden diese Identität beispielsweise, um Bindungen für Authentifizierungsanbieter für die Authentifizierung bei Tools und Ressourcen zu konfigurieren.
- Sitzungen: persistenter Unterhaltungsverlauf und Tracking aktiver Interaktionen mit dem KI-Agenten.
- Playground: Eine direkte Chat-Oberfläche, um das Verhalten des KI-Agenten zu testen.
- Gemerkte Informationen: Langfristige Personalisierungsfunktionen, die Details aus früheren Unterhaltungen mit dem Agenten generieren oder abrufen, um den Kontext über Interaktionen hinweg beizubehalten.
- Bewertung: Details zu allen Aufgaben zur Bewertung von KI-Agenten. Auf diesem Tab können Sie neue Bewertungsaufgaben erstellen, Messwerte hochladen und die kognitive Leistung des KI-Agenten sowie die Zuverlässigkeit des Modells anhand von Live-Traffic oder synthetischen Simulationen bewerten.

gcloud

Führen Sie den Befehl gcloud agent-registry agents describe aus, um die detaillierten Metadaten eines bestimmten KI-Agenten aufzurufen:

gcloud agent-registry agents describe AGENT_NAME \
    --project=PROJECT_ID \
    --location=REGION

Ersetzen Sie Folgendes:

AGENT_NAME: der Name Ihres KI-Agenten, z. B. my-custom-agent.
PROJECT_ID: Projekt-ID. In einer Verwaltungsgrenze können Sie entweder die Projekt-ID des Verwaltungsprojekts oder die Projekt-ID des Mitgliedsprojekts angeben, in dem der Agent bereitgestellt wird. Der zurückgegebene Ressourcenname behält die ID des Agenten bei und verwendet das in Ihrer Anfrage angegebene Projekt.
REGION: die Registry-Region.

Terraform

Wenn Sie Details zu einem bestimmten registrierten KI-Agenten anhand seiner ID abrufen möchten, konfigurieren Sie die Datenquelle google_agent_registry_agent:

data "google_agent_registry_agent" "my_agent" {
  location = "REGION"
  agent_id = "AGENT_ID"
}

output "agent_create_time" {
  description = "The timestamp when the agent was registered."
  value       = data.google_agent_registry_agent.my_agent.create_time
}

output "agent_update_time" {
  description = "The timestamp when the agent was last updated."
  value       = data.google_agent_registry_agent.my_agent.update_time
}

Ersetzen Sie Folgendes:

REGION: die Registry-Region.
AGENT_ID: die eindeutige Kennung Ihres Agenten, z. B. my-custom-agent.

Agentenmetadaten und ‑endpunkte aktualisieren

Wenn sich die Laufzeit-URL Ihres KI-Agenten ändert oder Sie den Anzeigenamen, die Beschreibung oder die Spezifikation überschreiben möchten, können Sie die Metadaten des KI-Agenten aktualisieren.

In der Agent Registry sind Agent-Ressourcen schreibgeschützte Erkennungsressourcen. Wenn Sie einen manuell registrierten Agent aktualisieren möchten, müssen Sie die beschreibbare Service-Ressource direkt aktualisieren. Geben Sie dazu die Projekt-ID an, unter der die Service-Ressource registriert wurde. Aktualisieren Sie automatisch registrierte Agenten in der zugrunde liegenden Laufzeit, damit die Agent Registry die Änderungen synchronisiert.

Console

So aktualisieren Sie die verfügbaren Details des KI-Agenten über die Google Cloud 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 KI-Agenten aus.

Auf der Seite wird eine Liste aller registrierten KI-Agenten angezeigt. Die Liste enthält den Namen, die ID, den Typ, die Beschreibung, die Version, die Laufzeit und den Standort des KI-Agenten.
Klicken Sie auf den Namen des KI-Agenten, den Sie aktualisieren möchten.
Klicken Sie auf dem Tab Übersicht des KI-Agenten auf Bearbeiten.
Geben Sie im Bereich Dienst bearbeiten die aktualisierten Informationen für Ihren Agent ein, z. B. den neuen Namen oder die neue Beschreibung.
Klicken Sie auf Speichern.

gcloud

Führen Sie den Befehl gcloud agent-registry services update mit bestimmten Flags aus, um die Parameter des Agents zu ändern:

Anzeigenamen und Beschreibung aktualisieren: Verwenden Sie die Flags --display-name und --description, zum Beispiel:
```
gcloud agent-registry services update AGENT_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --display-name="New display name" \
    --description="Updated description of the agent's purpose."
```
Ersetzen Sie Folgendes:
- AGENT_NAME: der Name Ihres KI-Agenten, z. B. my-support-agent.
- PROJECT_ID: Projekt-ID.
- REGION: die Registry-Region.
Endpunkt-URL aktualisieren: Verwenden Sie das Flag --interfaces, um den neuen Endpunkt anzugeben, z. B.:
```
gcloud agent-registry services update AGENT_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL
```
Ersetzen Sie Folgendes:
- AGENT_NAME: der Name Ihres KI-Agenten, z. B. my-support-agent.
- PROJECT_ID: Projekt-ID.
- REGION: die Registry-Region.
- ENDPOINT_URL: die neue Agent-Endpunkt-URL, z. B. https://new-api.example.com/agent.
- PROTOCOL: die Protokollbindung für den Endpunkt. Gültige Werte sind http-json, grpc und jsonrpc.
Spezifikation des KI-Agenten aktualisieren: Verwenden Sie das Flag --agent-spec-content, z. B. wenn Sie eine neue Agentenkarte haben:
```
gcloud agent-registry services update AGENT_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --agent-spec-content=AGENT_SPEC_FILE
```
Ersetzen Sie Folgendes:
- AGENT_NAME: der Name Ihres KI-Agenten, z. B. my-support-agent.
- PROJECT_ID: Projekt-ID.
- REGION: die Registry-Region.
- AGENT_SPEC_FILE: der Pfad zur neuen Agent-Spezifikationsdatei, z. B. new-agent-card.json. Die maximale Dateigröße für die Spezifikationsdatei beträgt 10 KB.

Terraform

Wenn Sie die Metadaten, die Endpunkt-URL oder die Spezifikation Ihres registrierten KI-Agenten aktualisieren möchten, ändern Sie die Parameter der vorhandenen google_agent_registry_service-Ressource in Ihrer Konfiguration und führen Sie dann terraform apply aus:

resource "google_agent_registry_service" "rest_agent" {
  location     = "REGION"
  service_id   = "AGENT_NAME"
  display_name = "New Display Name"
  description  = "Updated description of the agent's purpose."

  agent_spec {
    type = "NO_SPEC"
  }

  interfaces {
    url              = "ENDPOINT_URL"
    protocol_binding = "PROTOCOL"
  }
}

Ersetzen Sie Folgendes:

REGION: die Registry-Region.
AGENT_NAME: der eindeutige Name, den Sie Ihrem Agenten geben möchten, z. B. my-support-agent.
ENDPOINT_URL: die API-Endpunkt-URL des KI-Agenten, z. B. https://api.example.com/v1/agents/1234.
PROTOCOL: die Protokollbindung für den Endpunkt. Gültige Werte sind HTTP_JSON, GRPC und JSONRPC.

KI-Agenten entfernen

Wenn Sie KI-Agenten löschen möchten, die automatisch in Agent Registry registriert wurden, müssen Sie den zugrunde liegenden KI-Agenten in der jeweiligen Google Cloud -Laufzeit löschen. Der KI-Agent wird dann automatisch aus der Registry entfernt.

Wenn Sie einen manuell registrierten Agenten aus der Registry entfernen möchten, müssen Sie die zugehörige Service-Ressource löschen. Geben Sie dazu die Projekt-ID an, unter der die Service-Ressource registriert wurde. Dadurch wird der Agent aus den Suchergebnissen entfernt und ist für andere Tools nicht mehr auffindbar:

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 KI-Agenten aus.

Auf der Seite wird eine Liste aller registrierten KI-Agenten angezeigt. Die Liste enthält den Namen, die ID, den Typ, die Beschreibung, die Version, die Laufzeit und den Standort des KI-Agenten.
Klicken Sie auf den Namen des KI-Agenten, den Sie entfernen möchten.
Klicken Sie auf dem Tab Übersicht des KI-Agenten auf Löschen.
Geben Sie im Bestätigungsdialogfeld DELETE ein, um die Aktion zu bestätigen.
Klicken Sie auf Löschen.

gcloud

Führen Sie den Befehl gcloud agent-registry services delete aus:

gcloud agent-registry services delete AGENT_NAME \
    --project=PROJECT_ID \
    --location=REGION

Ersetzen Sie Folgendes:

AGENT_NAME: Der Name des KI-Agenten, den Sie entfernen möchten, z. B. my-support-agent.
PROJECT_ID: Projekt-ID.
REGION: die Registry-Region.

Terraform

Entfernen Sie die google_agent_registry_service-Ressource, die den Agent darstellt, aus Ihrer Terraform-Konfiguration und führen Sie dann terraform apply aus.

KI-Agenten verwalten Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Hinweis

Erforderliche Rollen

Verfügbare KI-Agenten entdecken

Alle KI-Agenten auflisten und ansehen

Console

gcloud

Registrierte KI-Agenten filtern

Console

gcloud

Terraform

Details eines KI-Agenten ansehen

Console

gcloud

Terraform

Agentenmetadaten und ‑endpunkte aktualisieren

Console

gcloud

Terraform

KI-Agenten entfernen

Console

gcloud

Terraform

Nächste Schritte

KI-Agenten verwalten