> For the complete documentation index, see [llms.txt](https://docs.allganize.ai/alli-llm-app-market/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.allganize.ai/alli-llm-app-market/first/start-guide/document-and-knowledge-base.md).

# 3. ドキュメント・ナレッジベースの登録

RAG型アプリの**回答品質は、ここで登録する素材で決まります**。最初は1件ずつで問題ありません。\
まずは動作するアプリを完成させることを優先しましょう。

{% hint style="info" %}
&#x20;LLM実行型アプリのみ作成される場合は、本章をスキップ → [5章 ハンズオンB](/alli-llm-app-market/first/start-guide/hands-on-b-llm-app.md#id-5-1-konodesuruapuri)へお進みください。
{% endhint %}

## 3-1. ドキュメントとQ\&Aの違い <a href="#document-vs-qa" id="document-vs-qa"></a>

<table><thead><tr><th width="179">項目</th><th>ドキュメント</th><th>ナレッジベース（Q&#x26;A）</th></tr></thead><tbody><tr><td>入れるもの</td><td>PDF・Word・Excel・PowerPoint等のファイル</td><td>質問文と回答文のペア</td></tr><tr><td>適したシーン</td><td>社内資料を根拠にしたい</td><td>想定問答が明確で、固定の回答内容を提示したい</td></tr><tr><td>検索方式</td><td>質問内容に応じて関連ページを抽出<br>（デフォルトの設定では最大10ページを抽出）</td><td>質問内容の類似度スコア（信頼度）が高いQ＆A</td></tr><tr><td>最初に作るなら</td><td>★★★ まずはこちらから</td><td>★★☆ 後から追加でOK</td></tr></tbody></table>

詳細な使い分け・登録上限などの仕様は、以下をご参照ください。\
・ドキュメント：[ユーザーガイド > ドキュメント](/alli-llm-app-market/manual/document.md)\
・Q＆A：[ユーザーガイド > ナレッジベース](https://docs.allganize.ai/alli-llm-app-market/manual/knowledge-base)&#x20;

***

## 3-2. ドキュメントを1つ登録する（最短手順） <a href="#register-document" id="register-document"></a>

ここでは「動くRAGアプリを作るための最小ステップ」のみ実行します。\
※アクセス権限の細かい設定は、4章でアプリができた後に見直しても問題ありません。

{% stepper %}
{% step %}

## ドキュメントメニューを開く <a href="#open-document-menu" id="open-document-menu"></a>

1. 左サイドメニューから **「ドキュメント」** をクリック
   {% endstep %}

{% step %}

## フォルダを作成する <a href="#create-folder" id="create-folder"></a>

1. 画面右上の **\[＋フォルダ]** をクリック
2. **フォルダ名を入力**して、**\[保存]**&#x3092;押す

<figure><img src="/files/hwXikrtr9eetjgQG0rtK" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/bGLDvQ8NeO8MLzkl2VoB" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
フォルダを作成してドキュメントを格納すると、ドキュメントの運用管理や権限調整、アプリでの出し分けが円滑になります。
{% endhint %}
{% endstep %}

{% step %}

## ファイルをアップロードする <a href="#upload-file" id="upload-file"></a>

1. 画面右上の **\[アップロード]** をクリック

<figure><img src="/files/FZ0bkfT2lzsCitkNAQYh" alt=""><figcaption></figcaption></figure>

2. 試したいPDFまたはWord等の**ファイルを1つ選択**（またはドラッグ&ドロップ）し、**\[アップロード]**&#x30DC;タンをクリック

<figure><img src="/files/WHdbbSpSBitPMEw59wYs" alt=""><figcaption></figcaption></figure>

3. 処理中のステータスが完了になるまで待つ\
   ※処理時間はファイルサイズ・OCR要否等によって異なります（数十秒〜数分）

<figure><img src="/files/uYDwCznjrqA8Pbb8T8EM" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**zip形式での一括アップロードも可能：**\
複数ドキュメントを一括登録される場合は、zipファイルでまとめてアップロードできます。\
詳細は[ユーザーガイド > ドキュメント](/alli-llm-app-market/manual/document.md#id-2appurdonodokyumentoyaforudawozipfairushiteappurdosuru) をご参照ください。
{% endhint %}
{% endstep %}
{% endstepper %}

***

## 3-3. Q\&Aを1つ登録する（任意） <a href="#register-qa" id="register-qa"></a>

Q\&A（FAQ）も追加される場合のみ実行してください。スキップしても4章には進めます。

{% stepper %}
{% step %}

## Q＆Aメニューを開く <a href="#open-qa-menu" id="open-qa-menu"></a>

1. 左サイドメニューから **「ナレッジベース 」** をクリックし、**「Q＆A」**&#x30E1;ニューを表示する
   {% endstep %}

{% step %}

## Q\&Aを追加 <a href="#add-qa" id="add-qa"></a>

1. **\[Q\&A追加]**&#x3092;クリックし、**\[Q＆A直接入力]**&#x3092;選択

<figure><img src="/files/2IrlIgjZX9WqFpZYqX6G" alt=""><figcaption></figcaption></figure>

2. 入力項目を記入し、\[登録]を押す

* **質問**：想定される質問文（例：「有給休暇は何日取得できますか？」）
* **回答**：固定で返したい回答
* **ハッシュタグ**（任意）：Q\&Aに対して、カテゴリなどの情報をラベリングするための機能

  ※ハッシュタグを付与することで  、特定のハッシュタグの範囲内からFAQを検索する機能が利用できます。

<figure><img src="/files/5gGJrg3KT51gVykXzPlq" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Q＆Aの一括アップロード：**\
Q＆Aはxlsxファイルで一括アップロードすることも可能です。\
詳細は[ユーザーガイド > Q＆A > Q＆Aデータの準備](/alli-llm-app-market/manual/knowledge-base/qa/qa-data-preparation.md) をご参照ください
{% endhint %}
{% endstep %}
{% endstepper %}

***

## 3-4. 後から見直す項目（アプリリリース前） <a href="#items-to-review-later" id="items-to-review-later"></a>

アプリの展開前は、必要に応じて以下の整理・見直しを行ってください。

* ドキュメント／Q\&Aの **アクセス権限設定**（誰が閲覧・編集できるか）
* **ハッシュタグやフォルダ指定の運用**（アプリ単位やフロー単位で検索範囲を絞る）

***

## ✅この章のチェックリスト <a href="#checklist" id="checklist"></a>

* [ ] ドキュメントを1つアップロードし、**「公開」ステータス**になった
* [ ] （任意）Q\&Aを1つ登録した


---

# 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.allganize.ai/alli-llm-app-market/first/start-guide/document-and-knowledge-base.md?ask=<question>&goal=<endgoal>
```

`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.
