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

Probleme mit der Agent-Registrierung beheben

Auf dieser Seite erfahren Sie, wie Sie Probleme mit der Agent Registry beheben.

API-Ratenkontingent überschritten

Dieses Problem kann auftreten, wenn Sie mit der Agent Registry API interagieren oder schnell durch die Agent Registry in Google Cloud der Console navigieren:

429 Too Many Requests

Implementieren Sie zur Behebung dieses Problems einen exponentiellen Backoff in Ihren API-Clients, um die Anfrageraten zu verwalten. Die Agent Registry API hat ein standardmäßiges Ratenkontingent von 1.200 Anfragen pro Minute weltweit und pro Region (20 Abfragen pro Sekunde).

Wenn beim Wechseln von Tabs in der Google Cloud Console eine Drosselung auftritt, warten Sie einige Augenblicke und versuchen Sie es noch einmal. Wenn Ihr programmatischer Anwendungsfall höhere Limits erfordert, fordern Sie eine Kontingenterhöhung an für die RequestsPerMinute Messwert.

Fehler bei der Nutzlastgröße während der manuellen Registrierung

Dieses Problem kann auftreten, wenn Sie einen Agenten oder MCP-Server manuell registrieren: Die API lehnt die Anfrage mit einem Fehler ab, der besagt, dass die Nutzlast zu groß ist.

Prüfen Sie, ob Ihre Datei agent-card.json oder toolspec.json kleiner als 10 KB ist, um dieses Problem zu beheben. Die Größen der Inhalte von AgentSpec und McpServerSpec sind auf 10 KB begrenzt. Minimieren Sie Ihre JSON-Dateien, entfernen Sie unnötige Leerzeichen oder fassen Sie Toolbeschreibungen zusammen, um dieses Limit einzuhalten. Weitere Informationen finden Sie unter JSON-Schemas.

Fehlende Agenten oder MCP-Server nach der Erstellung

Dieses Problem kann auftreten, wenn Sie einen Agenten oder MCP-Server in einem unterstützten Google Cloud Produkt wie Google Workspace oder Gemini Enterprise erstellen: Die Ressource wird beim Aufrufen der APIs ListAgents oder ListMcpServers nicht angezeigt.

Warten Sie, bis die Hintergrundsynchronisierung abgeschlossen ist, um dieses Problem zu beheben. Ihre Ressourcen werden in Echtzeit aktualisiert, andere Integrationen werden jedoch durch Offline-Batchjobs gefüllt, die regelmäßig ausgeführt werden. Wenn Ihre Ressource nach mehreren Stunden nicht angezeigt wird, prüfen Sie die Einstellungen zur Service Usage Ihres Projekts und stellen Sie sicher, dass die entsprechende API aktiviert ist.

Vorgänge mit langer Ausführungszeit scheinen festzuhängen

Dieses Problem kann auftreten, wenn Sie Agenten bereitstellen oder komplexe Bindungen konfigurieren: Der Vorgang dauert sehr lange und scheint festzuhängen.

Verwenden Sie zur Behebung dieses Problems das MCP-Tool get_operation oder den API-Endpunkt google.longrunning.Operations.GetOperation, um den Status des Vorgangs abzufragen. Für einige Agenten- und MCP-Backend-Erstellungen ist eine erhebliche Infrastrukturbereitstellung erforderlich, was zu Vorgängen mit langer Ausführungszeit führen kann, die bis zu 30 Minuten dauern können. Konfigurieren Sie die Timeout-Einstellungen Ihres Clients entsprechend und fragen Sie das boolesche Flag done ab, um den Abschluss zu prüfen.

Leere Ergebnisse beim Abrufen verfügbarer Bindungen

Dieses Problem kann auftreten, wenn Sie verfügbare Bindungen für einen Authentifizierungsanbieter abrufen: Die API gibt ein empty array oder einen Zugriffsfehler zurück, auch wenn Sie geprüft haben, dass die Bindung vorhanden ist.

Prüfen Sie, ob Ihr Prinzipal die richtigen IAM-Berechtigungen (Identity and Access Management) für die Zielressource AuthProvider hat, um dieses Problem zu beheben. Die API führt strenge IAM-Prüfungen durch und entfernt Binding-Objekte, die auf Authentifizierungsanbieter verweisen, auf die der Aufrufer keinen Zugriff hat. Prüfen Sie, ob Ihr Prinzipal den erforderlichen Zugriff auf den Authentifizierungsanbieter und die Rolle roles/agentregistry.viewer für das Projekt hat.

Download der Skill-Revision schlägt mit Fehler `302` fehl

Dieses Problem kann auftreten, wenn Sie versuchen, eine Skill-Revisionsnutzlast mit der API GetSkillRevision und dem Abfrageparameter ?alt=media herunterzuladen: Die Anfrage schlägt fehl und gibt einen Fehler ähnlich dem folgenden zurück:

{
  "error": {
    "code": 302,
    "message": "Unknown Error.",
    "status": "UNKNOWN"
  }
}

Prüfen Sie, ob Ihr HTTP-Client so konfiguriert ist, dass er Weiterleitungen automatisch folgt, um dieses Problem zu beheben. Für den Endpunkt ?alt=media ist eine 302-Weiterleitung erforderlich, um das Archiv des Skills herunterzuladen. Wenn Sie beispielsweise curl verwenden, fügen Sie Ihrem Befehl das Flag -L oder --location hinzu.

Validierung der Skill-Revision schlägt fehl oder zeigt den Status `FAILED` an

Dieses Problem kann auftreten, nachdem Sie eine neue Skill-Revision erstellt haben: Die Revision wechselt in den Status FAILED und kann nicht von Agenten geladen werden.

Prüfen Sie die Validierungsprotokolle oder die Inhalte der ZIP-Nutzlast, um dieses Problem zu beheben:

Das ZIP-Archiv muss eine Datei SKILL.md im Stammverzeichnis enthalten.
Die Datei SKILL.md muss einen gültigen YAML-Frontmatter-Block mit den Definitionen von name und description enthalten.
Die ZIP-Nutzlast darf die Größenlimits nicht überschreiten: Die komprimierte Größe muss weniger als 500 KB, die unkomprimierte Gesamtgröße weniger als 10 MB und die Größe der einzelnen Dateien weniger als 1 MB betragen.
Das Archiv darf keine symbolischen Links, Elemente zur Verzeichnisdurchquerung wie .. oder absolute Pfade enthalten.

Fehler bezüglich nicht gefundener Ressourceneinheit beim Verwalten von IAP-Richtlinien

Dieses Problem kann auftreten, wenn Sie gcloud iap web-Befehle verwenden, um Ausgehende-Richtlinien für Agent Registry-Ressourcen zu verwalten:

NOT_FOUND: Requested entity was not found

Prüfen Sie, ob das Ressourcenflag, das Sie an gcloud iap web übergeben, mit dem zugrunde liegenden untergeordneten Ressourcentyp der Agent Registry übereinstimmt, um dieses Problem zu beheben:

Verwenden Sie für Endpunkte wie externe APIs oder Google API-Ausgangspunkte das Flag --endpoint.
Verwenden Sie für MCP-Server (Model Context Protocol) das Flag --mcp-server.
Verwenden Sie für registrierte Agenten das Flag --agent.

Prüfen Sie die Ressourcen-URI, die von gcloud agent-registry [endpoints|mcp-servers|agents] list zurückgegeben wird, um festzustellen, ob der Ressourcenpfad /endpoints/, /mcpServers/ oder /agents/ enthält. Wenn Sie das falsche Ressourcenflag übergeben, z. B. --endpoint für eine MCP-Server-ID, wird ein NOT_FOUND-Fehler verursacht.

Berechtigung verweigert beim Anwenden von IAP-Web-IAM-Richtlinien

Dieses Problem kann auftreten, wenn Sie IAM-Richtlinien für Identity-Aware Proxy-Web für Agent Registry-Ressourcen anwenden oder ändern:

ERROR: (gcloud.iap.web.set-iam-policy) PERMISSION_DENIED

Prüfen Sie, ob Ihr aktiver Nutzer oder Ihr aktives Dienstkonto die erforderlichen Berechtigungen für das Projekt hat, in dem die Registry und das Gateway gehostet werden, um dieses Problem zu beheben:

Der Aufrufer muss die Rolle „IAP-Richtlinienadministrator“ (roles/iap.admin) oder „Projekt-IAM-Administrator“ (roles/resourcemanager.projectIamAdmin) für das zentrale Governance-Projekt haben.
Der Aufrufer muss die Berechtigungen iap.web.setIamPolicy und resourcemanager.projects.setIamPolicy haben.

Probleme mit der Agent-Registrierung beheben Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.