Beheben Sie Agentenfehler
Diese Referenz enthält kundenverträgliche Fehler, auf die ein Agent beim Verbinden, Anfordern einer menschlichen Prüfung und Warten reagieren kann. Interne, Authentifizierungs- und Berechtigungsfehler bleiben bewusst allgemein und geben keine Details preis.
REST-Antworten verwenden recoverWith; MCP-Tool-Fehler verwenden recoveryAction mit derselben sicheren Behebung.
{
"code": "result_not_ready",
"message": "Result is not ready.",
"retryable": true,
"recoverWith": "Follow the returned wait continuation and retry later without creating another request."
}Anfrage und Verbindung
| Code | Bedeutung | Behebung |
|---|---|---|
invalid_content_type | Die MCP-Anfrage hat keinen JSON-Inhalt angegeben. | Senden Sie Content-Type: application/json. |
invalid_accept_header | Der MCP-Accept-Header enthält nicht die erforderlichen Antworttypen. | Akzeptieren Sie application/json und text/event-stream und wiederholen Sie dieselbe Anfrage. |
unsupported_protocol_version | Die angeforderte MCP-Protokollversion wird nicht unterstützt. | Wiederholen Sie die Anfrage mit einer der im Fehler genannten unterstützten Versionen. |
request_too_large | Die Anfrage überschreitet die Größenbegrenzung des Endpunkts. | Verkleinern Sie die Nutzlast vor einem neuen Versuch unter die angegebene Grenze. |
parse_error | Der Anfragekörper ist kein gültiges JSON. | Korrigieren Sie die JSON-Syntax und wiederholen Sie dieselbe logische Anfrage. |
rate_limit_exceeded | Die Anfragerate liegt vorübergehend über der zulässigen Grenze. | Warten Sie die Zeit aus Retry-After ab und wiederholen Sie dieselbe Anfrage, ohne Arbeit zu duplizieren. |
oauth_reauthorization_required | Die OAuth-Identität besitzt diese gespeicherte Agentenverbindung nicht. | Autorisieren Sie RateLoop erneut mit dem Workspace-Inhaberkonto, das die Verbindung erstellt hat. |
connection_not_ready | Die Workspace-Verbindung hat ihre vom Inhaber genehmigte Einrichtung noch nicht abgeschlossen. | Schließen Sie die Verbindung in RateLoop ab oder genehmigen Sie sie und versuchen Sie es dann in derselben Agentenaufgabe erneut. |
invalid_tool_arguments | Die MCP-Tool-Argumente entsprechen nicht dem Tool-Vertrag. | Korrigieren Sie die genannten Argumente anhand des Tool-Schemas und versuchen Sie es erneut. |
workflow_not_allowed | Diese Integration darf den angeforderten Workflow nicht ausführen. | Verwenden Sie einen zulässigen Workflow oder bitten Sie den Workspace-Inhaber, den Workflow-Zugriff der Agentenversion zu ändern. |
Prüfungseinrichtung und -anfrage
| Code | Bedeutung | Behebung |
|---|---|---|
human_review_configuration_required | Der Workspace hat keine aktive Konfiguration für menschliche Prüfung für diese Anfrage. | Bitten Sie den Workspace-Inhaber, unter Agenten → Setup „KI-Prüfung starten“ zu wählen, was einen Klick dauert, oder eine Prüfungsrichtlinie für diese Agentenversion zu speichern, und versuchen Sie es erneut. |
human_review_configuration_action_required | Die gespeicherte Prüfungskonfiguration erfordert eine Aktion des Inhabers, bevor sie ausgeführt werden kann. | Bitten Sie den Workspace-Inhaber, die in RateLoop angezeigte Konfigurationsaktion abzuschließen, und versuchen Sie es erneut. |
invalid_review_opportunity | Die vorgeschlagene Prüfungsgelegenheit ist unvollständig oder ungültig. | Korrigieren Sie die im Fehler genannten Felder und bewerten Sie die Prüfungsgelegenheit erneut. |
review_opportunity_conflict | Der Opportunity-Schlüssel bezeichnet bereits andere Prüfungseingaben. | Verwenden Sie für diesen Schlüssel die ursprünglichen Eingaben oder bewerten Sie die geänderte Arbeit als neue Gelegenheit. |
review_opportunity_not_found | Die Prüfungsgelegenheit ist diesem Workspace unbekannt. | Verwenden Sie die bei der Bewertung zurückgegebene Opportunity-ID oder bewerten Sie die Arbeit erneut, wenn keine gespeichert wurde. |
source_payload_commitment_mismatch | Die Quellnutzlast entspricht nicht mehr den für die Prüfung bewerteten Bytes. | Senden Sie exakt die bewerteten Quellbytes oder erstellen Sie für die geänderte Quelle eine neue Prüfungsgelegenheit. |
suggestion_payload_commitment_mismatch | Die Vorschlagsnutzlast entspricht nicht mehr den für die Prüfung bewerteten Bytes. | Senden Sie exakt die bewerteten Vorschlagsbytes oder erstellen Sie für den geänderten Vorschlag eine neue Prüfungsgelegenheit. |
review_question_conflict | Die Prüfungsfrage unterscheidet sich von der für diese Gelegenheit festgeschriebenen Frage. | Verwenden Sie die festgeschriebene Frage oder bewerten Sie die geänderte Frage als neue Gelegenheit. |
approval_required | Der Workspace-Inhaber muss diese Prüfungsanfrage genehmigen. | Warten Sie auf die Entscheidung des Inhabers in RateLoop; senden Sie erst nach der Genehmigung und umgehen Sie sie nicht. |
review_not_required | Die festgeschriebene Richtlinienentscheidung erfordert keine menschliche Prüfung; eine KI-Bewertung kann noch ausstehen. | Fordern Sie keine menschliche Prüfung an. Wenn die Auswertung ratingAi zurückgab, lesen Sie den Hinweisstatus mit rateloop_get_rating_ai_result, bevor Sie ihn auslegen; eine ausgelassene Prüfung ist keine positive KI-Bewertung. |
review_not_requested | Für diese Prüfungsgelegenheit besteht noch keine Prüfungsanfrage. | Fordern Sie die erforderliche Prüfung einmal an und warten Sie dann anhand des zurückgegebenen Opportunity-Status. |
automatic_grant_inactive | Die automatische Prüfungsberechtigung ist für diese Gelegenheit nicht mehr aktiv. | Bitten Sie den Workspace-Inhaber, die Berechtigung zu erneuern oder die Anfrage per Inhabergenehmigung zu bearbeiten. |
workspace_stopped | Die Workspace-Stoppsteuerung blockiert neue Prüfungsaktivitäten. | Warten Sie, bis ein Workspace-Manager den Stopp aufhebt und den Agenten erneut berechtigt, bevor Sie es wieder versuchen. |
private_routing_configuration_required | Für den ausgewählten privaten Prüfungsweg ist kein vollständiges Reviewer-Routing eingerichtet. | Bitten Sie den Workspace-Inhaber, das genaue private Reviewer-Routing abzuschließen, und versuchen Sie es erneut. |
lane_not_implemented | Der ausgewählte Prüfungsweg ist in dieser Version nicht verfügbar. | Wählen Sie einen verfügbaren Prüfungsweg; wiederholen Sie den nicht verfügbaren Weg nicht unverändert. |
Warten und Ergebnis
| Code | Bedeutung | Behebung |
|---|---|---|
invalid_wait_cursor | Der Fortsetzungscursor für das Warten ist ungültig. | Verwenden Sie den zuletzt für diesen Vorgang zurückgegebenen Cursor oder lassen Sie ihn weg, um die Abfrage neu zu starten. |
invalid_wait_timeout | Die angeforderte Wartezeit oder das Abfrageintervall liegt außerhalb des zulässigen Bereichs. | Verwenden Sie den im Fehler genannten Bereich und wiederholen Sie denselben Wartevorgang. |
wait_cancelled | Der Aufrufer hat den Wartevorgang vor dem Abschluss abgebrochen. | Setzen Sie das Warten auf dieselbe Gelegenheit oder denselben Vorgang fort; erstellen Sie keine neue Anfrage. |
result_not_ready | Die Prüfung hat noch kein endgültiges Ergebnis. | Folgen Sie der zurückgegebenen Wartefortsetzung und versuchen Sie es später erneut, ohne eine weitere Anfrage zu erstellen. |
Sicher erneut versuchen
Setzen Sie bei wiederholbaren Warte- oder Ratenbegrenzungsfehlern dieselbe Anfrage beziehungsweise denselben Vorgang fort. Erstellen Sie nicht allein wegen eines ausstehenden Ergebnisses eine neue Prüfung oder Anfrage.