Fehlerbehebung
Kommende Namespace-Migration
AWS Agent Registry befindet sich derzeit in der öffentlichen Vorschauversion unter dem Bedrock-Agentcore-Namespace. Ab dem 6. August 2026 wird der Dienst in den Agent-Registry-Namespace verschoben. Wenn Sie AWS Agent Registry verwenden, müssen Sie Ihre Endpoints, IAM-Richtlinien, SDK-Clients, CLI-Skripts und Registrierungsdaten aktualisieren. Weitere Informationen zur Migration aus der öffentlichen Vorschauversion finden Sie unter Umfassender Anleitung zur Registrierungsmigration.
Schemavalidierungsfehler
Wenn Sie verschiedene Arten von Datensätzen erstellen, wird möglicherweise eine Gültigkeitsausnahme für die Deskriptoren angezeigt. Gültige Schemas finden Sie im Abschnitt Unterstützte Datensatztypen.
Häufige Fehler:
-
„Schemaversion '0.3.0' wird für den Deskriptortyp 'a2a' nicht unterstützt.“ — Der Feldwert SchemaVersion sollte
0.3anstelle von sein.0.3.0Dies entspricht der offiziellen Versionsbeschreibung des A2A-Protokolls: „Verwenden Sie die neueste unterstützte Nebenversion pro Hauptversion“. -
„Die Schemavalidierung ist fehlgeschlagen: Der Inhalt entspricht nicht der Schemaversion '0.3' für den Deskriptortyp 'a2a'.“ — Das Schema finden Sie unter Unterstützte Datensatztypen. Beachten Sie, dass der Inhalt anhand von #/ definitions/AgentCard im JSON-Schema validiert wird.
Synchronisationsfehler aufzeichnen
Wenn Sie einen Datensatz mithilfe der Synchronisationsfunktion erstellen oder aktualisieren, kann der Datensatz in den Status CREATE_FAILED oder UPDATE_FAILED übergehen, wobei erklärt wird, was passiert iststatusReason.
Auf oberster Ebene können Fehler in folgende Kategorien eingeteilt werden: Berechtigungsfehler, Verbindungsfehler, Validierungsfehler und serverseitige Fehler.
Berechtigungsfehler
Die Synchronisationskonfiguration ist falsch oder abgelaufen:
-
„Es konnte keine Verbindung zum MCP-Server hergestellt werden, da die Anruferanmeldedaten abgelaufen sind.“ — Der Aufrufer der Create or Update API hat abgelaufene Anmeldeinformationen. Sie können es erneut mit der UpdateRegistryRecord API versuchen.
-
„Ausnahme von GetWorkloadAccessToken API empfangen:<detailed message>" — Die Registrierung ruft die GetWorkloadAccessTokenAPI im Namen des Aufrufers auf. Weitere Informationen zu dem Fehler finden Sie in der ausführlichen Meldung. Wenn Sie die Ausnahme „Zugriff verweigert“ sehen, finden Sie weitere Informationen unter Datensätze aus externen Quellen synchronisieren.
-
„Der ARN des Anmeldeinformationsanbieters konnte nicht analysiert werden:<arn>" — Der ARN des Anmeldeinformationsanbieters ist falsch formatiert. Dies muss ein gültiger Anmeldeinformationsanbieter-ARN sein, der aus AgentCore Identity erstellt wurde.
-
„Ausnahme von GetResourceOauth2Token API empfangen:<detailed message>" — Die Registrierung ruft die GetResourceOauth2TokenAPI im Namen des Aufrufers auf. Weitere Informationen zu dem Fehler finden Sie in der ausführlichen Meldung. Wenn Sie die Ausnahme „Zugriff verweigert“ sehen, finden Sie weitere Informationen unter Datensätze aus externen Quellen synchronisieren.
-
„Die angegebene IAM-Rolle für die MCP-Serverautorisierung konnte nicht übernommen werden.“ — Die Registrierung ruft die AssumeRole API im Namen des Aufrufers auf. Informationen zu den erwarteten IAM-Berechtigungen finden Sie unter Synchronisieren von Datensätzen aus externen Quellen, z. B. muss der Anrufer über eine entsprechende Berechtigung verfügen.
iam:PassRole
Verbindungsfehler
Der Server kann nicht erreicht werden:
-
„Fehler beim Abrufen der Agentenkarte von der URL: %s“ — A2A IOException
-
„Der MCP-Server hat HTTP zurückgegeben<code>" — eine 200/202 Nicht-HTTP-Antwort vom MCP-Server. Bitte überprüfen Sie, ob die URL korrekt ist und ob eine Verbindung zum MCP-Server hergestellt werden kann.
-
„Die angegebene URL wird zu einer nicht öffentlichen IP-Adresse aufgelöst“ — Registry unterstützt nur Verbindungen zu öffentlichen IP-Adressservern.
-
„Verbindung zum MCP-Server konnte nicht hergestellt werden“ — Fehler IOException/connection
-
„Ungültige MCP-Server-URL“ — falsch formatierte URL
-
„Die MCP-Verbindung konnte nicht initialisiert werden“ — Ausnahme für die Initialisierung der Anfrage
-
„Fehler beim Senden der initialisierten Benachrichtigung“ — Ausnahme bei der Benachrichtigung
-
„Tools vom MCP-Server konnten nicht aufgelistet werden“ — Ausnahme tools/list
-
„Timeout bei der tools/list MCP-Server-Paginierung“ — Die Registrierung unterstützt beim Paginieren von Tools vom MCP-Server aus nur maximal 30 Sekunden. Wenden Sie sich an den AWS Support, wenn Ihr MCP-Server mehr Zeit für die Synchronisation benötigt.
Validierungsfehler
Der Server hat geantwortet, aber der Inhalt wird nicht unterstützt:
-
„Fehler beim Parsen der Agenten-Karten-JSON“ — Leerer A2A-Inhalt oder falsch formatiertes JSON
-
„Die Agentenkarte überschreitet die maximale Größenbeschränkung“ — A2A-Antwort zu groß
-
„Fehler beim Parsen der MCP-Serverantwort JSON“ — Der MCP-Inhalt ist leer oder falsch formatiert
-
„Der MCP-Server hat eine ungültige Antwort zurückgegeben: fehlendes Ergebnis“ — MCP-Ergebnis fehlt JSON-RPC
-
„Die Antwort des MCP-Servers überschreitet die maximal zulässige Größe“ — Die MCP-Antwort ist zu groß
-
„Deskriptortyp %s unterstützt keine URL-Synchronisierung“ — Deskriptortyp wird nicht unterstützt
Serverseitige Fehler
-
„Unbekannter Fehler“ — Dies ist ein serverseitiger Fehler. Bitte versuchen Sie es später erneut oder wenden Sie sich an den AWS Support, um Hilfe zu erhalten.