排解 Conversational Analytics API 錯誤

如果您在使用對話式數據分析 API 時遇到問題,請參閱下表,瞭解可能的解決方案。

錯誤 錯誤原因 HTTP 狀態碼 gRPC 狀態碼 解析度
AlreadyExistsException ALREADY_EXISTS 409 Conflict 6 資源已存在 (例如您正在建立重複的項目)。請使用其他 ID,或確認資源不存在後再建立。
BadRequestException INVALID_ARGUMENT 400 Bad Request 3 輸入內容無效或格式錯誤。請先驗證輸入內容或酬載,再傳送要求。
BadRequestException (搜尋範圍) INVALID_ARGUMENT 400 Bad Request 3 要求中的 BigQuery 搜尋範圍無效。如要修正錯誤,請按照收到的錯誤訊息指示操作:
  • At least one of include_project_ids or include_dataset_references must be provided in search_scope.

    請至少指定一個資料集或專案。

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

    最多可指定 100 個資料集和 100 項專案。

  • Elements in search_scope.include_project_ids must not be blank.、Elements in search_scope.include_project_ids must be valid BigQuery project IDs. 或開頭為 Each dataset reference in search_scope.include_dataset_references must have 的錯誤

    請僅指定專案 ID 和資料集 ID,不含前置字元、空格或引號。例如,指定 my-project,而非 projects/my-project。

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

    在無狀態對話要求的 inline_context 物件中指定搜尋範圍,而非在資料代理中指定。

詳情請參閱「連結至 BigQuery 資料集和專案」。
ForbiddenException PERMISSION_DENIED 403 Forbidden 7 您已通過驗證,但無法存取資源。請檢查使用者角色和權限。如有需要,請與管理員聯絡。
PermissionDenied (組織政策) PERMISSION_DENIED 403 Forbidden 7 要求違反組織政策限制,例如位置限制或 CMEK 規定。查看回應主體中的錯誤訊息,找出違反的限制。詳情請參閱「排解違反政策的問題」。
FailedPreconditionException FAILED_PRECONDITION 400 Bad Request 9 要求違反系統狀態 (例如嘗試刪除非空白資料夾)。檢查前置條件並修正邏輯。
NotFoundException NOT_FOUND 404 Not Found 5

找不到資源。驗證資源 ID 或網址。嘗試存取資源前,請先確認資源存在。

如需更多疑難排解資訊,請參閱對話式數據分析 API 常見問題。

ServiceUnavailableException UNAVAILABLE 503 Service Unavailable 14 伺服器發生暫時性問題,請稍後再試,並在每次嘗試之間採用指數輪詢。如果錯誤仍未解決,請提交錯誤報告。
Connection reset by peer (串流期間) UNAVAILABLE 503 Service Unavailable 14

如果您使用標準 HTTP 或 REST 用戶端呼叫串流 :chat 端點,伺服器可能會在串流期間發生嚴重錯誤 (例如逾時或權限遭拒)。由於 HTTP 標頭已傳送,因此真正的錯誤代碼會放在 HTTP/2 結尾,標準 REST 用戶端無法剖析,導致通訊端停止運作。

建議您使用官方 Google Cloud gRPC 用戶端程式庫 (例如 Python SDK) 呼叫串流端點。這些程式庫會剖析結尾標頭,並顯示真正的錯誤原因。

Internal error encountered (串流期間) INTERNAL 500 Internal Server Error 13

如果您使用標準 HTTP 或 REST 用戶端呼叫串流 :chat 端點,伺服器可能在串流期間發生嚴重錯誤。由於 HTTP 標頭已傳送,因此真正的錯誤代碼會放在 HTTP/2 結尾,標準 REST 用戶端無法剖析,導致通訊端停止運作。

建議您使用官方 Google Cloud gRPC 用戶端程式庫 (例如 Python SDK) 呼叫串流端點。這些程式庫會剖析結尾標頭,並顯示真正的錯誤原因。

UnauthenticatedException UNAUTHENTICATED 401 Unauthorized 16 需要驗證,或驗證失敗。確認您使用的是正確的登入憑證、API 金鑰或權杖。
UnimplementedException UNIMPLEMENTED 501 Not Implemented 12 要求的功能無法使用或不支援。請避免呼叫這個 API,或等待實作。

其他資源

如需其他疑難排解提示和常見問題解答,請參閱「對話式數據分析 API 常見問題」頁面。

如需有效向 對話式數據分析 API 提問的指引,請參閱「提出有效問題」說明文件頁面。