Conversational Analytics API エラーのトラブルシューティング

会話型分析 API の使用中に問題が発生した場合は、次の表で解決策を確認してください。

エラー エラーの原因 HTTP ステータス コード gRPC ステータス コード 解決策
AlreadyExistsException ALREADY_EXISTS 409 Conflict 6 リソースがすでに存在しています(重複するエントリを作成しているなど)。別の識別子を使用するか、リソースを作成する前に、リソースがまだ存在していないことを確認してください。
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.

    少なくとも 1 つのデータセットまたはプロジェクトを指定してください。

  • 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 のみを指定します。たとえば、projects/my-project ではなく 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 または URL を確認します。リソースにアクセスする前に、リソースが存在していることを確認してください。

トラブルシューティングの詳細については、会話分析 API に関するよくある質問をご覧ください。

ServiceUnavailableException UNAVAILABLE 503 Service Unavailable 14 一時的なサーバーの問題が発生しています。指数バックオフを利用して、待機と再試行を繰り返してください。エラーが解決しない場合は、バグレポートを提出してください。
Connection reset by peer(ストリーミング中) UNAVAILABLE 503 Service Unavailable 14

標準の HTTP または REST クライアントを使用してストリーミング :chat エンドポイントを呼び出すと、ストリーム中にサーバーで致命的なエラー(タイムアウトや権限の拒否など)が発生することがあります。HTTP ヘッダーはすでに送信されているため、実際のエラーコードは HTTP/2 トレーラーに配置されます。標準の REST クライアントはこれを解析できないため、ソケット クラッシュが発生します。

ストリーミング エンドポイントを呼び出すには、Python SDK などの公式の Google Cloud gRPC クライアント ライブラリを使用することをおすすめします。これらのライブラリは、これらの末尾のヘッダーを解析して、エラーの真の原因を特定します。

Internal error encountered(ストリーミング中) INTERNAL 500 Internal Server Error 13

標準の HTTP または REST クライアントを使用してストリーミング :chat エンドポイントを呼び出すと、ストリーム中にサーバーで致命的なエラーが発生することがあります。HTTP ヘッダーはすでに送信されているため、実際のエラーコードは HTTP/2 トレーラーに配置されます。標準の REST クライアントはこれを解析できないため、ソケット クラッシュが発生します。

ストリーミング エンドポイントを呼び出すには、Python SDK などの公式の Google Cloud gRPC クライアント ライブラリを使用することをおすすめします。これらのライブラリは、これらの末尾のヘッダーを解析して、エラーの真の原因を特定します。

UnauthenticatedException UNAUTHENTICATED 401 Unauthorized 16 認証が必要であるか、認証に失敗しました。正しいログイン認証情報、API キー、トークンを使用していることを確認してください。
UnimplementedException UNIMPLEMENTED 501 Not Implemented 12 リクエストされた機能は利用できないか、サポートされていません。この API の呼び出しを避けるか、実装を待機してください。

参考情報

トラブルシューティングのヒントやよくある質問への回答については、会話分析 API に関するよくある質問ページをご覧ください。

会話分析 API への効果的な質問については、効果的な質問をするドキュメント ページをご覧ください。