> 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/practice/apuri/category-search-ga.md).
# 【アプリ例】カテゴリー選択→ドキュメントから回答生成を行う
このガイドでは「カテゴリー(部署)選択」→「カテゴリー(部署)のドキュメントから回答生成」へと繋がるアプリの作成方法を解説します。
このアプリは社内問い合わせ業務の工数削減などで多くのお客様が利用していますので、ガイドを参考に自社に合わせた形にアレンジしてみてください。
## 全体図
大まかな流れとしては下記の2つです。
**①カテゴリーで人事を選択→人事領域のドキュメントから回答生成→同じカテゴリーで再検索(人事ドキュメントから回答生成) or TOPのカテゴリー選択に戻る**
**②カテゴリーで総務を選択→総務領域のドキュメントから回答生成→同じカテゴリーで再検索(総務ドキュメンとから回答生成) or TOPのカテゴリー選択に戻る**
## フローの構築
### カテゴリー選択をするボタンを作成する
エンドユーザーに最初に何かしらのカテゴリーを選択させるようなボタンを作成する場合、「会話・質問応答ノード」を使用します。
会話・質問応答ノード内を下記の手順に沿って設定します。
1. **メッセージ欄：**ユーザーに表示するメッセージを入力してください
2. **応答追加：**ユーザーに選択させるボタンなどを作成する場合、チェックを入れてください。
3. **応答を入力してください。：**「応答追加」にチェックを入れると応答の種類を選択できます。\
ボタンを作成する場合「ボタン」を選択してください。
4. **オプションを追加：**ユーザーにボタンを表示する際のボタン名を設定できます。
オプションを追加ボタンを押すとオプションタイプを選択する画面が表示されますので「一般」をクリックしてください。
クリック後、ボタン名を設定できる画面に遷移しますので、回答オプションにボタン名を入力し、適用ボタンを押してください。
今回のフローでは「人事」「総務」の2つのボタンを用意しますので４.を繰り返して「総務」ボタンも作成してください。
### カテゴリー(部署)のドキュメントから検索
※選択したカテゴリーからドキュメントを検索させたい場合、事前にドキュメントをフォルダで分けておくか、ドキュメントに任意のハッシュタグを付与する必要があります。
ユーザーにカテゴリーを選択させ、その先でカテゴリーの範囲でドキュメントから回答生成を行う場合、「回答生成ノード」を使用します。
カテゴリーの範囲でドキュメントから回答生成を行う場合、「回答生成ノード」を使用します。
回答生成ノード内を下記の手順に沿って設定します。
1. **質問の入力方式：**「メンバー入力」を選択します。
2. **質問：**ユーザーに表示するメッセージを設定します。
3. **ベースモデル：**回答生成で使用するLLMモデルを選択します。\
モデルによって精度が変わりますので事前に検証されることをおすすめします。
4. **エージェント：**回答生成をする際のエージェントを選択します。RAG Agent V2は弊社側でご用意した標準のエージェントになりますので基本的にはそちらをご利用ください。
5. **検索ソース：**回答生成をする際に回答のソースとして利用したいものを選択します。\
例では事前にアップロードされた社内ドキュメントを回答ソースとして設定しています。
6. **フォルダの適用範囲 / ドキュメントの適用範囲：**カテゴリーの範囲でドキュメントから回答生成を行う場合、対象範囲に任意のドキュメントフォルダ、またはハッシュタグを設定してください。\
※カテゴリーごとに回答生成ノードを作成する場合、設定箇所が異なるのはこちらの部分のみです。\ この例では、「人事」カテゴリーを選択した後に繋がる「回答生成ノード」は対象範囲を「人事フォルダ」、「総務」カテゴリーを選択した後に繋がる「回答生成ノード」は対象範囲を「総務総務フォルダ」と設定しています。
7. **回答生成後：**回答が生成された後のアクションを選択できます。ここでは回答生成後に同じ領域で再検索 or TOPのカテゴリー選択に戻るボタンのノードに繋ぐため、「次のノードへ」を選択します。
このノードはカテゴリーの数だけ作成します。この例では「人事」「総務」で2つ作成しています。\
※ノードは複製(コピー)できますので、コピー機能をご利用ください。\ ※カテゴリーごとに「適用範囲(フォルダ、ハッシュタグ)」を変更するのを忘れずに設定してください。
ここまでの手順で3つのノードが作成できますので、下記のように矢印で繋ぎます。
### カテゴリー(部署)のドキュメントから検索→同じ領域で再検索 or TOPのカテゴリー選択に戻るボタンを作成する
カテゴリーそれぞれの範囲で回答生成が完了した後に、同じ領域で再検索 or TOPのカテゴリー選択に戻るボタンを用意します。
ボタンを作成する場合、「会話・質問応答ノード」を使用します。
ボタンの作成方法は[カテゴリー選択をするボタンを作成する](#category_button)と同様の手順で作成してください。
～完成イメージ～
このノードはカテゴリーの数だけ作成します。ノードは複製(コピー)できますので、コピー機能をご利用ください。
ここまで作成が完了したら下記の手順でフローを繋いでください。
1. 各カテゴリーの回答生成ノードの「回答生成に成功した場合」の分岐から「同じ領域で再検索 or TOPのカテゴリー選択に戻るボタン」のある質問応答ノードへ矢印を繋ぐ(黒色の矢印)
2. 「同じカテゴリーで検索」のボタンから直前の「各カテゴリーの回答生成ノード」に矢印を繋ぐ(緑色の矢印)
3. 「TOPに戻る」のボタンから最初の「カテゴリー(部署)を選択するボタンがある質問応答ノード」に矢印を繋ぐ(赤色の矢印)
### 回答生成に失敗した場合のエラーメッセージを表示する
回答生成ノードでは「通信エラー」が発生する場合があります。その場合、「回答生成ノード」の「回答生成に失敗した場合」の分岐に進むので、その場合にエラーメッセージを表示するフローを作成します。
エンドユーザーにエラーメッセージを表示する場合「会話質問応答ノード」を使用します。
ユーザーに表示するメッセージを設定してください。\
この例では「エラーが発生しました。もう一度最初からやり直してください。」と設定しています。
ここまで作成が完了したら下記の手順でフローを繋いでください。
1. 各カテゴリーのドキュメントから回答生成ノードの「回答生成に失敗した場合」の分岐からエラーメッセージの会話応答ノードへ矢印を繋ぐ(青色の矢印)
2. エラーメッセージを表示する「会話応答ノード」からTOPのカテゴリー選択をする「質問応答ノード」へ矢印を繋ぐ(赤色の矢印)
以上でアプリは完成です。
---
# 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.allganize.ai/alli-llm-app-market/practice/apuri/category-search-ga.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
