ヘルプ / マニュアル
Help & Manual — Allygence Admin Panel
ナレッジベース (Knowledge Base)
ナレッジベース (KB) は Allygence がユーザーの質問に回答する際に参照するドキュメント群です。
対応ファイル形式
- PDF — 自動 OCR + テキスト抽出してインデックスします。
- Word (.docx) — テキストを抽出してインデックスします。
- HTML — 本文テキストを抽出してインデックスします。
- 画像 (JPEG / PNG / WebP 等) — Gemini Vision で OCR を実行します。
- プレーンテキスト / Markdown (.txt / .md) — そのままインデックスします。
インデックスに非対応の形式はアップロードのみ可能です (RAG 検索に使用されません)。
ファイルのアップロード手順
- 「ファイルをアップロード」ボタンをクリックします。
- ファイルを選択します (Ctrl/Shift で複数選択可)。
- 必要に応じて保存先フォルダを指定します。
- アップロードと同時に RAG インデックスが自動で実行されます。
- ステータスが「Done」になれば利用可能です。
URL からのアップロード
「URL からアップロード」では外部 URL のドキュメントを直接取り込めます。
- ソース URL を入力します。
- 保存先フォルダとファイル名 (省略可) を指定します。
- 「Fetch & Upload」をクリックすると Celery ワーカーがバックグラウンドで処理します。
ファイルの検索
検索ボックスにファイル名の一部を入力すると絞り込み表示されます。クリア (×) で元のツリー表示に戻ります。
ファイルのプレビュー
各行の 👁 ボタン をクリックするとプレビューダイアログが開きます。
- 画像: インライン表示
- PDF: iFrame 表示
- テキスト / Markdown / JSON: コードビュー
- その他: ダウンロードボタンが表示されます
再処理 (Reprocess)
アップロード後にインデックスが失敗した場合や KB の内容を更新した場合は「Reprocess」ボタンで再インデックスできます。
OCR アップロード (任意)
画像/PDF の OCR テキストを手動で確認・編集してから KB に保存したい場合は「OCR Upload」セクションを使用してください。
- ファイルを選択し「Run OCR」を実行します。
- 抽出テキストを確認・編集します。
- 「Save to KB」で保存し、「Index to Qdrant」でインデックスします。
アシスタント (Assistants)
アシスタントはユーザーが会話する AI キャラクターです。複数作成可能で、ナレッジベースの内容と紐づきます。
アシスタントの作成・編集
- 「Assistants」メニューから「Create」をクリックします。
- 名前・ペルソナ設定 (システムプロンプト) を入力します。
- 状態 (Active / Inactive) を設定します。Active にするとキオスク端末で使用可能になります。
- 「Save」をクリックします。
注意事項
- Active なアシスタントが複数ある場合、キオスク側は設定画面で選択されたアシスタントを使用します。
- 削除は論理削除 (Soft Delete) です。削除したアシスタントは非表示になりますがデータは残ります。
スタンス (Stances)
スタンスとはアシスタントの応答スタイルや特定トピックへの態度を定義するプリセットです。
スタンスの作成・適用
- 「Stances」メニューから「Create」をクリックします。
- スタンス名と説明、プロンプトの追加指示を入力します。
- アシスタント設定でスタンスを割り当てます。
チャット履歴 (Chat History)
ユーザーとアシスタントの会話ログが一覧表示されます。
機能
- セッション・ソース・質問内容・日時を確認できます。
- 行をクリックすると質問と回答の詳細が表示されます。
- 「Delete」で論理削除できます (データは保持されます)。
設定 (Settings)
キオスク端末の動作設定を管理します。
主な設定項目
- アシスタント選択 — キオスクに表示するアシスタントを指定します。
- 言語設定 — デフォルト表示言語を設定します。
- 音声設定 — PTT (Push-to-Talk) の有効/無効を切り替えます。
- RAG 設定 — topK・minScore など検索精度パラメータを調整します。
辞書 (Lexemes)
Lexemes は AI が特定の語彙を正しく解釈するための補助辞書です。
- 業界固有の略語や商品名を登録することで回答精度が向上します。
- 読み仮名の登録により音声認識の精度も改善されます。
よくある操作
KB を更新したのに回答が変わらない
ファイルのステータスが「Done」になっているか確認してください。「Pending」または「Processing」の場合はしばらくお待ちください。「Failed」の場合は「Reprocess」ボタンで再実行してください。
ファイルの日付が「-」と表示される
古いファイル (created_at が記録されていないもの) は日付を取得できないため「-」と表示されます。再アップロードすると日付が記録されます。
アシスタントがキオスクに表示されない
アシスタントの状態が「Active」であることと、設定画面でそのアシスタントが選択されていることを確認してください。
サポート
技術的な問題が発生した場合は、管理者またはシステム担当者にお問い合わせください。