> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/jp/knowledge-base/data.md). # データ、プライバシーとメンテナンス ナレッジベースは、取り込んだ資料のホスティング用コピー、解析テキスト、Chunks、検索インデックスを保存します。データがローカル端末の外に出るかどうかは、解析、OCR、埋め込み、再ランキング、チャットの各工程で選択したサービスによります。 {% hint style="info" %} 元ファイルがローカルに残っていても、ナレッジベース全体の処理がオフラインとは限りません。どれか1つでも処理工程でクラウドサービスを使うと、タスク完了に必要なファイル、断片、またはクエリが送信される可能性があります。 {% endhint %} ## 取り込み後に保存されるもの | 内容 | 用途 | 更新方法 | | ----------------------- | --------------------- | --------------------------- | | ファイルまたはディレクトリ内のファイルのコピー | ナレッジベースが引き続き処理・表示するため | 元ファイル更新後に再追加または置換 | | Webページとノートのスナップショット | 取り込み時点の内容を保持 | ソース更新後に再取り込み | | 本文の解析とChunks | プレビューと検索 | 処理器または分割方法を変更後に再インデックス | | BM25 キーワードインデックス | 正確な語句検索 | 再インデックス時に再構築 | | ベクトルインデックス | 意味検索 | 埋め込みモデルを設定または変更した後に生成または再構築 |
包含多条已处理资料的员工差旅制度知识库

資料一覧の項目は、ナレッジベースがホスティングしインデックス化する対象であり、元ディレクトリのリアルタイム同期ビューではありません。

## 1回のクエリがまたぐ可能性のある境界
展示解析、关键词检索、向量检索、重排和回答之间数据流的知识库架构图

図中の解析、ベクトル、再ランキング、回答の各ノードは、ローカルまたはクラウドサービスを選択する可能性があります。データ境界を確定するには、項目ごとの確認が必要です。

| 選択した機能 | 受け取る可能性のある内容 | | ------------- | ------------------- | | クラウド文書処理器 | 解析用のファイル内容 | | クラウド埋め込みモデル | 資料の断片と検索クエリ | | クラウド再ランキングモデル | クエリと候補断片 | | クラウドチャットモデル | 質問、対話コンテキスト、召回された断片 | | ローカル対応機能 | ローカル端末で相応の処理を完了 | {% hint style="danger" %} APIキー、社内文書、個人情報を含むログは、公開スクリーンショットやフィードバックに含めるべきではありません。削除や共有の前に必ず匿名化してください。 {% endhint %} ## 完全なメンテナンスチェックを1回行う {% stepper %} {% step %} ### 1. 現在の設定を記録する ナレッジベース名、ファイル処理器、OCR、埋め込みモデル、再ランキングモデル、主要な分割設定を記録します。移行後にそれらで環境を照合します。 {% endstep %} {% step %} ### 2. 重複と旧バージョンを整理する 同一の制度は現行版のみを残します。履歴監査が必要な場合は、タイトルに年またはバージョンを明記して、検索時に競合しないようにします。 {% endstep %} {% step %} ### 3. 異常項目を確認する 【エラー】または長時間【処理中】の資料を処理し、本文とChunksを抜き取り確認します。アプリ中断によりインデックスが未完了の場合は、【再インデックス】を実行します。 {% endstep %} {% step %} ### 4. 適切なバックアップを作成する 【設定】→【データ】を開きます。端末を移行する場合や資料削除の準備をする場合は、ナレッジベースのデータファイルを含む完全バックアップを使用します。 {% endstep %} {% step %} ### 5. 目的の環境で復元して検収する 復元完了を確認するだけでは不十分です。ナレッジベース項目、本文、Chunksを確認し、固定の召回クエリを実行します。 {% endstep %} {% step %} ### 6. ロールバック可能な基準を残す 新しい処理器やモデルは、まず少量の資料で検証し、その後に分割して再インデックスします。新しい結果が安定するまでは、直近の完全バックアップを削除しないでください。 {% endstep %} {% endstepper %} ## 完全バックアップと簡易バックアップ | バックアップ方式 | 含まれる内容 | 適用シーン | 制限 | | -------- | ------------------------------------- | ----------------- | -------------------- | | 完全バックアップ | チャット、設定、ナレッジベースなどのデータファイル | 端末移行、削除前の保護、完全復元 | ファイルが大きく、時間がかかる | | 簡易バックアップ | 主にチャット履歴と設定。画像、ナレッジベースなどのデータファイルはスキップ | よく使う設定とチャットを素早く保持 | 完全なナレッジベースは個別に復元できない | {% hint style="warning" %} 簡易バックアップは、ナレッジベース削除前の復旧保証にはなりません。重要な移行では少なくとも1つの完全バックアップを保持し、目的の環境で実際に召回テストを完了してください。 {% endhint %} ## 更新と削除の扱い ### ソース内容の更新 1. 同名の資料を再追加する。 2. 旧バージョンを上書きしたい場合は【置換】を選択し、どうしても共存させる必要がある場合のみ【すべて保持】を選択します。 3. 資料が準備完了になるのを待つ。 4. 本文とChunksを抜き取り確認する。 5. 固定の召回回帰クエリを実行する。 ### 処理設定の更新 処理器、OCR、分割、またはモデル設定のみを変更した場合は、既存項目に対して【再インデックス】を実行します。設定を変更しただけでは、旧資料は自動では再処理されません。 ### 資料またはナレッジベースを削除する 削除するとナレッジベースがホストする内容とインデックスは消えますが、元のパス内のファイルや元ノートは削除されません。操作前に、元のソースがまだ見つけられること、完全バックアップが使えることを確認し、依然としてそのナレッジベースに紐づくAgentがないか確認してください。 ## 設定説明 | 項目 | 推奨の出発点 | 検収方法 | リスク | | -------- | --------------------- | ----------------- | --------------------------- | | 資料バージョン | 同じ用途では現行版のみを残す | 固定質問が正しい版のみにヒットする | 新旧ルールの混在 | | クラウドサービス | 機密レベルごとに項目単位で確認する | 処理器とモデルの設定を確認する | 文書または断片が外部サービスに送信される | | バックアップ | 大きな変更の前に完全バックアップを作成する | 復元後に項目と召回を確認する | 簡易バックアップにはナレッジベースファイルが含まれない | | 再インデックス | 代表的な資料を分割して処理する | 同じ質問セットで前後比較する | 一括再構築では使える基準を失う | ## ユーザー事例 小林さんは、チームの規程ライブラリを新しいPCに移行しようとしています。まず処理器とモデルの設定を記録し、完全バックアップを作成し、新しいPCで復元した後、3件の資料の本文とChunksを確認し、元の5つの召回クエリを繰り返しました。すべて合格してから、旧環境を整理しました。 完了条件は、資料数とタイトルが一致し、重要な質問が同じソースにヒットし続け、かつチームがすべてのクラウドサービスがデータ要件に適合していることを確認することです。 ## 完全オフライン確認チェックリスト * 文書解析とOCRは、システム、本地、またはセルフホストの機能を使用します。 * 埋め込みモデルはローカルで実行されます。 * クラウド再ランキングを使わないか、ローカル再ランキング機能を使用します。 * 対話とAgentはローカルチャットモデルを使用します。 * 内容を外部システムに送信するMCP、Web検索、またはチャネルは有効になっていません。 ## よくある質問
元ファイルを変更すると、ナレッジベースは自動的に更新されますか？ いいえ。ファイル、Webページ、ノートはすべて、取り込み時点の内容で資料が作成されます。再追加して置換するか、必要に応じて再インデックスしてください。
ローカル埋め込みモデルを使えば完全にオフラインになりますか？ 必ずしもそうではありません。解析、OCR、再ランキング、チャットのいずれかの工程でクラウドサービスを使うと、タスク完了に必要な内容が送信される可能性があります。
簡易バックアップでナレッジベースを復元できますか？ 完全なナレッジベースファイルは復元できません。移行や削除の前には完全バックアップを使用し、復元後に資料と召回を実際に検証してください。
## 続きを読む
ドキュメント解析とOCRローカル処理器とクラウド処理器の違いを理解する。/pages/4a183fc375a74312acee8cc1115baf07eeaacdf2
資料を追加・整理するソースを置き換えて資料バージョンを管理する。/pages/52419c0c8143ffa7c66f9f3048af576a7b985d6b
よくある質問失敗レベルごとに問題を素早く特定する。/pages/dc2f754740c26e611ee580046af16b3119732b27
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.cherryai.com.cn/docs/jp/knowledge-base/data.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.