Docs Menu

Amazon Reduce のトラブルシューティング

このページでは、Atlas Vector Search を Amazon Bedrock と 統合する際に発生する可能性のある一般的な問題のトラブルシューティング方法について説明します。

このページに記載されていない問題をトラブルシューティングするには、MongoDBサポートにお問い合わせください。

一般的なトラブルシューティングのガイダンスについては、次の手順を参照してください。

知識ベースの作成時に問題が発生した場合は、以下の点を確認してください。

  • PrivateLink を使用する場合は、正しいホスト名を使用し、クラスターに -pl のサフィックスが含まれていることを確認してください。

    ホスト名は、接続文字列にある Atlas クラスターの URLです。ホスト名は次の形式を使用します。

    <clusterName>.mongodb.net
  • Atlasで指定した名前と同じデータベース、コレクション、およびベクトルインデックス名を指定してください。データベースユーザーがAtlasのデータベースにアクセスできることを確認してください。

  • Secrets Manager で正しいユーザー名とパスワードキーを指定し、ARN が正しいことを確認してください。詳しくは、AWS Secrets Manager の概念 を参照してください。

  • PrivateLink を使用している場合は、Amazon Bedrock で知識ベースを構成するときに正しい PrivateLink サービス名を入力してください。

    重要

    PrivateLink サービスのエンドポイントは、知識ベースと同じアカウント内になければなりません。

  • 権限関連の問題が発生した場合は、「Amazon Bedrock で知識ベース作成時に発生する権限エラーのトラブルシューティング方法」をご覧ください。

知識ベースからデータを同期または取得する際に問題が発生した場合は、以下を確認してください。

  • 取り込もうとするデータが、基盤モデルでサポートされている形式であることを確認してください。たとえば、テキストベースのモデルを使用している場合、データはテキスト形式にします。

  • クラスターに接続できること、認証情報とネットワークアクセスが変更されていないことを確認してください。

  • 選択した基礎モデルに対応する Atlas Vector Search インデックスの次元数を正しく指定していることを確認してください。

  • データをフィルターする場合は、メタデータフィールドをインデックス定義のプレフィルターとして定義し、それらがデータソースの実際のフィールドに対応していることを確認してください。

注意

データソースの S3 バケットからファイルを追加、変更、削除するたびに、データソースを同期して、知識ベースに再インデックス化する必要があります。同期はインクリメンタル方式なので、Amazon Bedrock は前回の同期以降に追加、変更、削除された S3 バケット内のオブジェクトのみを処理します。詳細については、Amazon Bedrock のドキュメントを参照してください。

エラーメッセージ
トラブルシューティングの手順

知識ベースを設定する際に:

AccessDeniedException: User ... is not authorized to perform: iam:CreateRole on resource ... because no identity-based policy allows the iam:CreateRole action

IAM ロールとポリシーを作成するには、IAM 権限を持っていることを確認してください。詳細については、Amazon Bedrock のドキュメントをご覧ください。

知識ベース用のデータソースを同期しようとした際に:

ConflictException: You cannot start an ingestion job on a knowledgeBase with status CREATING.

これは、作成途中の知識ベースのデータソースを同期しようとした際に発生します。データソースを同期する前に、知識ベースが Ready 状態であることを確認してください。

知識ベースのステータスを確認する方法については、Amazon Bedrock のドキュメントをご覧ください。

エージェントに知識ベースを追加しようとする際に:

You must save your agent with Agent Resource Role defined before adding a knowledge base.

これは、エージェントを保存する前に作成中の新しいエージェントに知識ベースを追加しようとした場合に発生します。まずエージェントを保存し、それから知識ベースをエージェントに追加する必要があります。

エージェントをテストする際に:

Access denied when calling Bedrock. Check your request permissions and retry the request.

このエラーは、アクセス権のない基盤モデルを使用しようとした場合に発生します。Amazon Bedrock モデルを使用するには、アクセスをリクエストする必要があります。モデルへのアクセスをリクエストまたは変更する方法については、Amazon Bedrock のドキュメントを参照してください。

Amazon Titan テキスト埋め込みモデルを使用する場合:

BSON field '$vectorSearch.queryVector.####' is the wrong type 'int', expected type 'double'

これは、このモデルで Atlas Vector Search を使用する場合の既知の問題です。この問題を解決するには、MongoDB サポートにお問い合わせください。