> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/km/km-basic-settings.md). # ナレッジベースの作成方法：基本設定 ## 基本設定 ### 一般情報以下のページで、ナレッジベースの名称を自由に定義し、説明を追加できます。

#### 検索チャンク検索チャンク数とは、AI アシスタントが回答する際に参照する資料チャンクの上限数を指します。システムの初期値は「12」で、毎回の回答時に AI アシスタントが最も関連性の高い 12 個のチャンクを検索して回答することを意味します。そのため、検索するチャンク数を増減させることで、AI アシスタントが回答時に参照する情報量を調整できます。 ### 解析ツール（Parser）とは？解析ツール（Parser）は、システムがアップロードされたファイル内のコンテンツを「理解」できるようにし、検索・編集・他のフォーマットへの変換ができるようにするものです。 #### ファイル解析ツール PDF や Word などのファイルをアップロードする際は、以下の 4 種類の解析ツールから選択できます。 * **MaiAgent Parser（初期設定）**：低コストかつ高速で、テキストのみのファイルに適しており、22 種類のフォーマットに対応 * **MaiAgent Parser（Online）**：LLM を使用し、画像内の文字を OCR で解析可能、20 種類のフォーマットに対応 * **MaiAgent Parser（Offline）**：OCR + AI による画像の意味理解で、構造保持が最も優れており、オンプレミス展開が可能、20 種類のフォーマットに対応 * **Vision Parser**：AI 視覚理解により、画像解析の効果が最も優れており、7 種類のフォーマットに対応 #### 音声テキスト変換解析ツール音声ファイルをアップロードする際は、以下の 4 種類の音声テキスト変換解析ツールから選択できます。 * **Azure Speech**：リアルタイム文字起こしで、精度が高い * **Whisper（Groq）**：最速かつ低コスト * **Whisper（OpenAI）**：安定して信頼できるクラウドソリューション * **Whisper（Offline）**：完全にローカル展開され、無料でデータプライバシーを保護音声の解析が完了すると、「ファイルを表示」から文字起こしを確認でき、TXT または SRT フォーマットの文字起こしファイルのダウンロードにも対応しています。

{% hint style="info" %} 各解析ツールの詳細な比較については、以下を参照してください：[技術者マニュアル - Parser 解析ツール](https://docs.maiagent.ai/tech/quickstart/parser) {% endhint %} データの解析中に問題が発生した場合は、\[再解析] アイコンをクリックすることで、解析ツールにデータを再整理させることもできます。

### 検索モデルの設定ナレッジベースの設定では、使用したい Embedding モデルおよび Reranker モデルを自由に選択できます。

#### Embedding モデル Embedding とは、人間の言語を AI が理解できる「数字の言語」に翻訳するようなもので、コンピューターが文章の本当の意味を理解できるようにします。このプロセスを「ベクトル化」と呼びます。Embedding モデルにはそれぞれ異なる特性（得意とする言語、対応する展開環境など）があり、ナレッジベース内の異なるモデル設定は、ナレッジベースのファイルをアップロードする際のベクトル化処理の効果を調整するために使用できます。さまざまなシーンに応じて、最も適した Embedding モデルを選択できます。複数の Embedding モデルから自由に選択できます。 {% hint style="info" %} Embedding モデルの違いについては、以下を参照してください：[技術者マニュアル—Embedding モデル](https://docs.maiagent.ai/tech/quickstart/embedding#maiagent-zhi-yuan-de-embedding-mo-xing) {% endhint %}

#### Reranker モデル Reranker は専門の審査員のようなもので、初期検索結果の中から、どの資料が顧客の質問に最も適切に回答できるかを再評価します。Reranker を使用する場合としない場合では、どのような効果の違いがあるのでしょうか？顧客が「初心者に適したテントは？予算 8000 円以下」と質問した場合： **Reranker なし：** ``` AI は次のように回答する可能性があります：「さまざまな価格帯のテントをご用意しております。8000円の製品には...」（上級者向けのモデルに言及する可能性があり、初心者のニーズに十分対応できていない） ``` **Reranker あり：** ``` AI の回答：「初心者の方に特におすすめのこちらの 8000 円以下のテントを...」（初心者+予算+製品推薦に的確に対応） ``` 検索結果の再ランク付け（Reranking）を有効にすると、AI アシスタントは検索したナレッジベースのコンテンツチャンクを再度並べ替え、最も関連性の高いファイルに基づいて回答します。 {% hint style="info" %} Reranker モデルについては、以下を参照してください：[技術者マニュアル—Reranker モデル](https://docs.maiagent.ai/tech/quickstart/reranker#maiagent-ti-gong-de-reranker-mo-xing) {% endhint %}

以上をまとめると、Embedding と Reranker を組み合わせて使用することで、AI アシスタントは提供されたナレッジを理解し、チャンクを検索した後に再度コンテンツの重要性を確認し、質問に最も関連性の高いナレッジで回答できるようになります。 *** ### AI アシスタントの関連付け #### 複数の AI アシスタントでナレッジベースを共有する AI アシスタントの関連付けとは、このナレッジベースをどの AI アシスタントに使用許可するかを指定することです。たとえば、2 つの AI アシスタントがあるとします： * **製品カスタマーサポート AI** * **注文カスタマーサポート AI** 両方とも返品に関する質問に回答する必要がある場合、「返品ポリシー」のナレッジベース設定で、上記の 2 つの AI アシスタントを一度に関連付けることができます。

1. 関連付けたい AI アシスタントを選択します

2. AI アシスタントを追加をクリックします追加すると、選択済み AI アシスタント領域に表示されます。右下の「保存」をクリックすると関連付けが完了します。

関連付けると、2 つの AI アシスタントは「返品ポリシー」のナレッジベースを共有でき、同じコンテンツに基づいて回答できます。その後のメンテナンスでは、**1 つのナレッジベースを更新するだけ**で、AI アシスタントが常に最新のデータを使用することを保証できます。 #### 1 つの AI アシスタントで複数のナレッジベースを使用するナレッジベースの共有に加え、1 つの AI アシスタントで複数のナレッジベースを使用することもできます。 1. AI アシスタントページに入り、設定したい AI アシスタントを選択して、設定をクリックします

2. モデル設定に入り、「ナレッジベースを選択」をクリックします

3. 使用したいナレッジベースを選択して確認を押すと、選択したナレッジベースがリストに表示されます

4. 最後に「保存」を押すと、AI アシスタントが複数のナレッジベースを使用できるようになります --- # 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.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/km/km-basic-settings.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.