翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# データソースを同期する
<a name="kb-managed-sync"></a>

ナレッジベースを作成したら、データを取り込むか同期して、クエリできるようにします。取り込みは、データソースの raw データをベクトル埋め込みに変換します。

取り込みの開始前に、データソースが次の条件を満たしていることを確認してください。
+ データソースの接続情報が設定されている。[「データソースの接続](kb-managed-connect-ds.md)」を参照してください。データソースの設定は、ナレッジベースの作成過程で行います。
+ 選択したベクトル埋め込みモデルを設定しました。[サポートされているベクトル埋め込みモデル](kb-managed-create.md#kb-managed-embedding-models)を参照してください。ベクトル埋め込みの設定は、ナレッジベースの作成過程で行います。
+ ファイルがサポート対象の形式である。詳細については、[「サポートされているドキュメント形式](https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-ds.html#kb-ds-supported-doc-formats-limits)」を参照してください。
+ ファイルは、「 AWS 全般のリファレンス」の[「サービスクォータ](kb-managed-quotas.md)とクォータ」で指定された**取り込みジョブファイルのサイズ**を超えません。

データソースからファイルを追加、変更、または削除するたびに、ナレッジベースでファイルのインデックスが再作成されるように、データソースを同期する必要があります。同期は増分処理であるため、前回の同期以降に追加、変更、または削除されたドキュメントだけが処理されます。

データをナレッジベースに取り込み、最新のデータと同期する方法を確認するには、任意の方法のタブを選択してステップを実行してください。

------
#### [ Console ]

**データをナレッジベースに取り込み、最新のデータと同期するには**

1. にサインイン AWS マネジメントコンソール し、Amazon Bedrock AgentCore > **組み込みツール** > **ナレッジベース**に移動します。

1. ナレッジベースを選択します。

1. **[データソース]** セクションで **[同期]** を選択して、データの取り込み (データインジェスト) または最新データの同期を開始します。同期中のデータソースを停止するには、**[停止]** を選択します。停止できるのは、同期中のデータソースだけです。**[同期]** をもう一度選択すると、残りのデータを取り込むことができます。

1. データインジェストが正常に完了すると、緑色の成功バナーが表示されます。

1. データソースを選択して、そのデータソースの **[同期履歴]** を表示することができます。**[警告を表示]** を選択すると、データインジェストジョブが失敗した理由を確認できます。

------
#### [ API ]

ナレッジベースにデータを取り込み、最新のデータと同期するには、[Amazon Bedrock エージェントのビルドタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)で [StartIngestionJob](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_StartIngestionJob.html) リクエストを送信します。`knowledgeBaseId` と `dataSourceId` を指定してください。[StopIngestionJob](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_StopIngestionJob.html) リクエストを送信することで、実行中のデータインジェストジョブを停止することもできます。`dataSourceId`、`ingestionJobId`、および `knowledgeBaseId` を指定します。停止できるのは、実行中のデータインジェストジョブのみです。準備ができたら、`StartIngestionJob` リクエストを再送信して、残りのデータを取り込むことができます。

レスポンスで返された `ingestionJobId` を使用して、[Amazon Bedrock エージェントのビルドタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)で [GetIngestionJob](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetIngestionJob.html) リクエストを送信し、取り込みジョブのステータスを追跡します。また、`knowledgeBaseId` と `dataSourceId` も指定します。
+ 取り込みジョブが完了すると、レスポンス内の `status` は `COMPLETE` になります。
+ レスポンス内の `statistics` オブジェクトは、データソース内のドキュメントの取り込みが成功したかどうかに関する情報を返します。

また、[Amazon Bedrock エージェントのビルドタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)で [ListIngestionJobs](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListIngestionJobs.html) リクエストを送信することで、データソースのすべての取り込みジョブに関する情報を確認することもできます。`dataSourceId` と、データの取り込み先のナレッジベースの `knowledgeBaseId` を指定してください。
+ 検索するステータスを `filters` オブジェクトで指定して、結果をフィルタリングします。
+ `sortBy` オブジェクトを指定して、ジョブの開始時間またはジョブのステータスでソートします。昇順または降順で並べ替えることができます。
+ レスポンスで返す結果の最大数を `maxResults` フィールドで設定します。設定した数よりも結果の件数が多い場合は、`nextToken` が返されます。これを別の [ListIngestionJobs](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListIngestionJobs.html) リクエストで送信して、ジョブの次のバッチを確認できます。

------