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

KI-Agenten verwalten

Für eine effektive Verwaltung Ihrer Agentenflotte muss die Registrierung genau sein. Dazu müssen Sie die Details der Agenten ansehen und aktualisieren, wenn sich Ihr KI-Ökosystem weiterentwickelt, Metadaten überschreiben oder nicht mehr verwendete Agenten entfernen.

In diesem Dokument wird beschrieben, wie Sie die Details und die Konfiguration Ihres registrierten Agenten ansehen und ändern.

Hinweis

Bevor Sie Agenten verwalten, müssen sie in der Agent Registry registriert sein. Außerdem benötigen Sie Ihre Projekt-ID , um diese Aufgaben auszuführen.

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

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die Agent Registry API Editor (roles/agentregistry.editor) IAM-Rolle für das Projekt zu erteilen, um die Berechtigungen zu erhalten, die Sie zum Verwalten registrierter Agenten in der 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 Agenten entdecken

Nach der Registrierung von Agenten können Sie sie in Ihrer Umgebung finden und ihre detaillierten Konfigurationen ansehen, z. B. ihre Endpunkte, Fähigkeiten und zugehörigen Metadaten.

Alle Agenten auflisten und ansehen

Sie können alle in Ihrer Umgebung registrierten Agenten auflisten und ihre detaillierten Konfigurationen ansehen, z. B. ihre Endpunkte, Fähigkeiten und zugehörigen Metadaten:

Console

Rufen Sie in der Google Cloud Console Agent Registry auf:

Zu 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 Agenten angezeigt. Die Liste enthält den Namen, die ID, den Typ, die Beschreibung, die Version, die Laufzeit und den Standort des Agenten.
Klicken Sie auf den Namen des Agenten, um alle Details zu sehen.

gcloud

Verwenden Sie den Befehl agents list, um alle Agenten an einem bestimmten Standort aufzulisten:

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

Ersetzen Sie Folgendes:

PROJECT_ID: Die Projekt-ID.
REGION: Die Region der Registrierung.

Registrierte 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 Agent Registry auf:

Zu 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 Agenten angezeigt. Die Liste enthält den Namen, die ID, den Typ, die Beschreibung, die Version, die Laufzeit und den Standort des Agenten.
Filtern Sie die Liste nach dem Standort des Agenten 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 Anwenden.
- Wenn Sie nach Laufzeit filtern möchten, klicken Sie auf das Menü Laufzeit , wählen Sie die Laufzeiten 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

Filtern Sie die Liste der Agenten, um nur Ressourcen zurückzugeben, die bestimmten Metadaten entsprechen. Verwenden Sie dazu das Flag --filter:

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

Ersetzen Sie FILTER_EXPRESSION durch den 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.
Verwenden Sie agentId='urn:agent:AGENT_URN', um nach der global eindeutigen Kennung (URN) zu suchen.

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 Region der Registrierung.
DISPLAY_NAME: Der für Menschen lesbare Name des Agenten, nach dem gefiltert werden soll, z. B. Support Agent.

Details eines Agenten ansehen

Sehen Sie sich Details zu einem bestimmten Agenten an, einschließlich seiner Protokolle, Fähigkeiten und Identität:

Console

Rufen Sie in der Google Cloud Console Agent Registry auf:

Zu 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 Agenten angezeigt. Die Liste enthält den Namen, die ID, den Typ, die Beschreibung, die Version, die Laufzeit und den Standort des Agenten.
Klicken Sie auf den Namen des Agenten, den Sie ansehen möchten.

Die Detailseite enthält Tabs für die Details des Agenten.
Klicken Sie auf den entsprechenden Tab, um bestimmte Details des Agenten anzusehen.

Die Verfügbarkeit der Funktion hängt von Ihrer Laufzeit ab. Tabs wie Sessions, Playground, Memories und Evaluation sind spezifische Funktionen, die für Agenten angezeigt werden, die auf verwalteten Laufzeiten wie Agent Runtime on Gemini Enterprise Agent Platform basieren:
- Übersicht: Wichtige Details des Agenten, einschließlich Name, ID, Standort, Beschreibung und Laufzeit. In der Übersicht werden auch Fähigkeiten und der Ressourcen-URI angezeigt, die Sie zum Erstellen von Abfragen im Topologiediagramm benötigen.
- Beobachtbarkeit: Anwendungsbezogene Informationen wie Latenz, Traffic, Fehler und Token-Ausgaben. Auf diesem Tab sind Google Cloud Observability-Tools integriert, um Leistungsmesswerte in Echtzeit und die Auslastung auf Systemebene anzuzeigen. So können Sie Kosten und Nutzerfreundlichkeit verwalten. Weitere Informationen finden Sie in der Übersicht zur Beobachtbarkeit.
- Traces: Der genaue Pfad eines Gesprächs Schritt für Schritt, einschließlich detaillierter Formatierung von Eingabe- und Assistentennachrichten, um komplexe Reasoning-Loops mit mehreren Agenten oder Fehler bei der Tool-Aufrufung in Echtzeit zu beheben. Weitere Informationen finden Sie unter Agent-Traces ansehen.
- Sicherheit: Ergebnisse von Model Armor und Security Command Center, einschließlich Verstößen gegen die Inhaltsrichtlinie, Risiken für Datenlecks und Compliance-Bewertungen. Weitere Informationen zur Sicherheit finden Sie unter Sicherheitsergebnisse ansehen.
- Topologie: Eine visuelle Darstellung der Beziehungen und Traffic-Flüsse zwischen einem Agenten, seinem zugewiesenen Agent Gateway und den MCP Servern, mit denen er interagiert. Weitere Informationen zum Agent Gateway finden Sie in der Übersicht zum Agent Gateway. Weitere Informationen zur Topologie finden Sie unter Diagramme für einen registrierten Agenten ansehen.
- Identität: Das Agent-Principal das für die Richtlinienerzwingung verwendet wird. Mit dieser Identität können Sie beispielsweise Bindungen für Authentifizierungsanbieter für die Authentifizierung bei Tools und Ressourcen konfigurieren.
- Sitzungen: Permanenter Gesprächsverlauf und Tracking aktiver Interaktionen mit dem Agenten.
- Playground: Eine direkte Chat-Oberfläche zum Testen des Verhaltens des Agenten.
- Memories: Langfristige Personalisierungsfunktionen, mit denen Details aus früheren Gesprächen mit dem Agenten generiert oder abgerufen werden, um den Kontext über alle Interaktionen hinweg beizubehalten.
- Evaluation: Details zu allen Aufgaben zur Agentenbewertung. Auf diesem Tab können Sie neue Bewertungsaufgaben erstellen, Messwerte hochladen und die kognitive Leistung und Modellzuverlässigkeit des Agenten anhand von Live-Traffic oder synthetischen Simulationen bewerten.

gcloud

Verwenden Sie den Befehl agents describe, um die detaillierten Metadaten eines bestimmten Agenten anzusehen:

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

Ersetzen Sie AGENT_NAME durch den Namen Ihres Agenten, z. B. my-custom-agent.

Terraform

Wenn Sie Details zu einem bestimmten registrierten 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 Region der Registrierung.
AGENT_ID: Die eindeutige ID Ihres Agenten, z. B. my-custom-agent.

Agentenmetadaten und -endpunkte aktualisieren

Wenn sich die Laufzeit-URL Ihres Agenten ändert oder Sie seinen Anzeigenamen, seine Beschreibung oder seine Spezifikation überschreiben möchten, können Sie die Agentenmetadaten aktualisieren.

Für die Agent Registry API werden Agent-Ressourcen für die Suche verwendet. Daher müssen Sie die registrierte Service-Ressource direkt aktualisieren.

Console

Aktualisieren Sie die verfügbaren Agentendetails in der Google Cloud Console:

Rufen Sie in der Google Cloud Console Agent Registry auf:

Zu 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 Agenten angezeigt. Die Liste enthält den Namen, die ID, den Typ, die Beschreibung, die Version, die Laufzeit und den Standort des Agenten.
Klicken Sie auf den Namen des Agenten, den Sie aktualisieren möchten.
Klicken Sie auf dem Tab Übersicht des Agenten auf Bearbeiten.
Geben Sie im Bereich Dienst bearbeiten die aktualisierten Informationen zu Ihrem Agenten ein, z. B. den neuen Namen oder die neue Beschreibung.
Klicken Sie auf Speichern.

gcloud

Verwenden Sie die gcloud CLI mit bestimmten Flags, um die Parameter des Agenten zu ändern:

Anzeigenamen und Beschreibung aktualisieren: Verwenden Sie die --display-name und --description Flags, z. B.:
```
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 Agenten, z. B. my-support-agent.
- PROJECT_ID: Die Projekt-ID.
- REGION: Die Region der Registrierung.
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:
- ENDPOINT_URL: Die neue Endpunkt-URL des Agenten, z. B. https://new-api.example.com/agent.
- PROTOCOL: Die Protokollbindung für den Endpunkt. Gültige Werte sind HTTP_JSON, GRPC oder JSONRPC.
Spezifikation des 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
```
Ersetzen Sie AGENT_SPEC durch den Namen der neuen Spezifikationsdatei des Agenten, 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 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 Region der Registrierung.
AGENT_NAME: Der eindeutige Name, den Sie Ihrem Agenten geben möchten, z. B. my-support-agent.
ENDPOINT_URL: Die API-Endpunkt-URL des Agenten, z. B. https://api.remote-service.com/v1/agents/1234.
PROTOCOL: Die Protokollbindung für den Endpunkt. Gültige Werte sind HTTP_JSON, GRPC oder JSONRPC.

Agent entfernen

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

Wenn Sie einen manuell registrierten Agenten aus der Registrierung entfernen möchten, müssen Sie die zugrunde liegende Service-Ressource löschen. 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 Agent Registry auf:

Zu 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 Agenten angezeigt. Die Liste enthält den Namen, die ID, den Typ, die Beschreibung, die Version, die Laufzeit und den Standort des Agenten.
Klicken Sie auf den Namen des Agenten, den Sie entfernen möchten.
Klicken Sie auf dem Tab Übersicht des Agenten auf Löschen.
Geben Sie im Bestätigungsdialogfeld LÖSCHEN ein, um die Aktion zu bestätigen.
Klicken Sie auf Löschen.

gcloud

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

Ersetzen Sie Folgendes:

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

Terraform

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

Nächste Schritte

Informationen zum Ansehen von Agentenbeziehungen mithilfe eines Topologiediagramms
Informationen zum Suchen nach Agenten und Tools mit Abfragen in natürlicher Sprache

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

Hinweis

Erforderliche Rollen

Verfügbare Agenten entdecken

Alle Agenten auflisten und ansehen

Console

gcloud

Registrierte Agenten filtern

Console

gcloud

Terraform

Details eines Agenten ansehen

Console

gcloud

Terraform

Agentenmetadaten und -endpunkte aktualisieren

Console

gcloud

Terraform

Agent entfernen

Console

gcloud

Terraform

Nächste Schritte

KI-Agenten verwalten