Fehler bei der Conversational Analytics API beheben

Wenn bei der Verwendung der konversationellen Analyse API Probleme auftreten, finden Sie in der folgenden Tabelle mögliche Lösungen.

Fehler Ursache des Fehlers HTTP-Statuscode gRPC-Statuscode Lösung
AlreadyExistsException ALREADY_EXISTS 409 Conflict 6 Die Ressource ist bereits vorhanden (z. B. erstellen Sie einen doppelten Eintrag). Verwenden Sie eine andere ID oder bestätigen Sie, dass die Ressource noch nicht vorhanden ist, bevor Sie sie erstellen.
BadRequestException INVALID_ARGUMENT 400 Bad Request 3 Die Eingabe ist ungültig oder fehlerhaft. Überprüfen Sie die Eingaben oder Nutzlasten, bevor Sie die Anfrage senden.
BadRequestException (Suchbereich) INVALID_ARGUMENT 400 Bad Request 3 Der BigQuery-Suchbereich in der Anfrage ist ungültig. Folgen Sie der Anleitung für die Fehlermeldung, die Sie erhalten, um den Fehler zu beheben:
  • At least one of include_project_ids or include_dataset_references must be provided in search_scope.

    Geben Sie mindestens ein Dataset oder Projekt an.

  • search_scope.include_dataset_references must not contain more than 100 elements. oder search_scope.include_project_ids must not contain more than 100 elements.

    Geben Sie bis zu 100 Datasets und bis zu 100 Projekte an.

  • Elements in search_scope.include_project_ids must not be blank., Elements in search_scope.include_project_ids must be valid BigQuery project IDs., oder ein Fehler, der mit Each dataset reference in search_scope.include_dataset_references must have beginnt

    Geben Sie nur die Projekt-ID und die Dataset-ID an, ohne Präfix, Leerzeichen oder Anführungszeichen. Geben Sie beispielsweise my-project anstelle von projects/my-project an.

  • Search scope is not supported in DataAgent. It is only supported for standalone conversations.

    Geben Sie den Suchbereich im inline_context-Objekt einer zustandslosen Chatanfrage anstelle eines KI-Datenagenten an.

Weitere Informationen finden Sie unter Verbindung zu BigQuery-Datasets und -Projekten herstellen.
ForbiddenException PERMISSION_DENIED 403 Forbidden 7 Sie sind authentifiziert, dürfen aber nicht auf die Ressource zugreifen. Prüfen Sie Ihre Nutzerrolle und Berechtigungen. Wenden Sie sich bei Bedarf an einen Administrator.
PermissionDenied (Organisationsrichtlinie) PERMISSION_DENIED 403 Forbidden 7 Die Anfrage verstößt gegen eine Einschränkung der Organisationsrichtlinie, z. B. eine Standorteinschränkung oder eine CMEK-Anforderung. Prüfen Sie die Fehlermeldung im Antworttext, um festzustellen, gegen welche Einschränkung verstoßen wurde. Weitere Informationen finden Sie unter Fehlerbehebung bei Richtlinienverstößen.
FailedPreconditionException FAILED_PRECONDITION 400 Bad Request 9 Die Anfrage verstößt gegen den Systemstatus (z. B. der Versuch, einen nicht leeren Ordner zu löschen). Überprüfen Sie die Vorbedingungen und korrigieren Sie die Logik.
NotFoundException NOT_FOUND 404 Not Found 5

Die Ressource wurde nicht gefunden. Prüfen Sie die Ressourcen-IDs oder ‑URLs. Achten Sie darauf, dass die Ressource vorhanden ist, bevor Sie versuchen, darauf zuzugreifen.

Weitere Informationen zur Fehlerbehebung finden Sie unter Häufig gestellte Fragen zur Conversational Analytics API.

ServiceUnavailableException UNAVAILABLE 503 Service Unavailable 14 Es liegt ein vorübergehendes Serverproblem vor. Warten Sie und wiederholen Sie den Vorgang mit exponentiellem Backoff zwischen den Versuchen. Wenn der Fehler weiterhin auftritt, reichen Sie einen Fehlerbericht ein.
Connection reset by peer (während des Streamings) UNAVAILABLE 503 Service Unavailable 14

Wenn Sie einen Standard-HTTP- oder REST-Client verwenden, um den Streaming-Endpunkt :chat aufzurufen, ist auf dem Server während des Streams möglicherweise ein schwerwiegender Fehler aufgetreten (z. B. eine Zeitüberschreitung oder eine Ablehnung der Berechtigung). Da HTTP-Header bereits gesendet wurden, wird der tatsächliche Fehlercode in HTTP/2-Trailern platziert, die von Standard-REST-Clients nicht geparst werden können. Dies führt zu einem Socket-Absturz.

Wir empfehlen, die offiziellen Google Cloud gRPC-Clientbibliotheken wie das Python SDK zu verwenden, um Streaming-Endpunkte aufzurufen. Diese Bibliotheken parsen diese nachgestellten Header und zeigen die tatsächliche Fehlerursache an.

Internal error encountered (während des Streamings) INTERNAL 500 Internal Server Error 13

Wenn Sie einen Standard-HTTP- oder REST-Client verwenden, um den Streaming-Endpunkt :chat aufzurufen, ist auf dem Server möglicherweise ein schwerwiegender Fehler während des Streams aufgetreten. Da HTTP-Header bereits gesendet wurden, wird der tatsächliche Fehlercode in HTTP/2-Trailern platziert, die von Standard-REST-Clients nicht geparst werden können. Dies führt zu einem Socket-Absturz.

Wir empfehlen, die offiziellen Google Cloud gRPC-Clientbibliotheken wie das Python SDK zu verwenden, um Streaming-Endpunkte aufzurufen. Diese Bibliotheken parsen diese nachgestellten Header und zeigen die tatsächliche Fehlerursache an.

UnauthenticatedException UNAUTHENTICATED 401 Unauthorized 16 Authentifizierung erforderlich oder Authentifizierung fehlgeschlagen. Achten Sie darauf, dass Sie die richtigen Anmeldedaten, den richtigen API-Schlüssel oder das richtige Token verwenden.
UnimplementedException UNIMPLEMENTED 501 Not Implemented 12 Die angeforderte Funktion ist nicht verfügbar oder wird nicht unterstützt. Rufen Sie diese API nicht auf oder warten Sie auf die Implementierung.

Zusätzliche Ressourcen

Weitere Tipps zur Fehlerbehebung und Antworten auf häufig gestellte Fragen finden Sie auf der Seite Häufig gestellte Fragen zur Conversational Analytics API.

Hinweise zum Stellen effektiver Fragen an die Conversational Analytics API finden Sie auf der Dokumentationsseite Effektive Fragen stellen.