> 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/ja/build/choose-channel/web-chat/citation-display.md).

# 引用元の表示

Web Chat の引用元表示：Agent がナレッジベースを引用して回答する際の出典の示し方、多言語とダークモードへの対応、表示位置、管理者設定について説明します。

本ページでは、Web Chat のチャットウィンドウにおける引用元表示の最適化機能について、多言語サポートと視覚表現の改善を含めてご紹介します。

## 引用元表示とは？ <a href="#what-is-citation-display" id="what-is-citation-display"></a>

Agent が質問に回答する際、その回答がナレッジベース内の特定のファイルやデータに基づいている場合、システムは回答の下に「引用元」を表示し、エンドユーザーに情報の出典をお知らせします。

この機能は、情報の出典を示す必要がある場面に特に適しています。例えば次のようなケースです。

* 法令照会アシスタント：条文の出典を表示
* 政策相談アシスタント：政策文書の出典を表示
* 製品カスタマーサポートアシスタント：製品マニュアルや公式文書を表示
* 医療情報アシスタント：医学文献の出典を表示

## 引用元の表示位置 <a href="#citation-display-location" id="citation-display-location"></a>

Agent の回答でナレッジベースが使われた場合、引用情報は次の 3 か所に表示されます。

| 場所                                                 | 表示される内容                                                                                                                                                                                                                                                                              |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 回答の下の <mark style="color:blue;">使用したナレッジベース</mark> | この回答で参照したナレッジベース                                                                                                                                                                                                                                                                     |
| 回答の下の <mark style="color:blue;">引用</mark> リスト      | 引用されたファイル名。<mark style="color:blue;">引用ノードを表示</mark> をクリックするとダイアログが開き、実際に引用された段落（引用ノード）が一覧表示されます                                                                                                                                                                                     |
| 回答文中の引用マーク                                         | マウスを重ねると小さなカードが表示され、ファイル名、<mark style="color:blue;">ページ番号</mark>（ソースにページ区切りがない場合は「ソースにページ区切りなし」と表示）、<mark style="color:blue;">関連度</mark>のパーセンテージ、そしてその段落の <mark style="color:blue;">原文</mark>／<mark style="color:blue;">キーワードをハイライト</mark> の 2 種類の表示を確認できます。元のファイルを直接ダウンロードすることもできます |

「引用ノードを表示」ダイアログ内の各ノードの項目：

| 項目                                                                               | 意味                                                |
| -------------------------------------------------------------------------------- | ------------------------------------------------- |
| <mark style="color:blue;">類似度スコア</mark>／<mark style="color:blue;">関連度</mark>     | この段落と質問との意味的な類似度です。高いほど、回答の根拠である可能性が高いことを示します     |
| <mark style="color:blue;">ヒット回数</mark>                                           | 今回の検索でこの段落がヒットした回数です。多いほど、関連性が高いと繰り返し判定されたことを示します |
| <mark style="color:blue;">文字数</mark>                                             | このノードの長さです                                        |
| <mark style="color:blue;">原文</mark>／<mark style="color:blue;">キーワードをハイライト</mark> | プレーンテキスト表示と、質問に関連するキーワードに色を付ける表示を切り替えます           |

表示するかどうかは、管理者が [機能設定](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/platform-settings/function-settings.md#ai-interaction)で決定します。管理画面の対話ビューアーで確認できる対応する情報は、[対話ビューアー：ナレッジベースの引用トラッキング](https://docs.maiagent.ai/maiagent-user-guide/ja/serve/daily-operations/reply/conversation-viewer.md#knowledge-base-citation-tracking)をご参照ください。

## 多言語サポート <a href="#multilingual-support" id="multilingual-support"></a>

### 自動言語適応 <a href="#automatic-language-adaptation" id="automatic-language-adaptation"></a>

Web Chat の引用元表示は、多言語の自動適応に対応しました。エンドユーザーが言語を切り替えると、引用元のインターフェース上のテキストも自動的に対応する言語へ切り替わります。

#### 対応言語 <a href="#supported-languages" id="supported-languages"></a>

* **繁体字中国語**：引用來源、參考資料
* **簡体字中国語**：引用来源、参考资料
* **英語**：Citation、References

### 言語切り替えのタイミング <a href="#language-switch-timing" id="language-switch-timing"></a>

Web Chat は以下の状況に応じて自動的に言語を切り替えます。

1. **ブラウザの言語設定**：初回読み込み時に、ユーザーのブラウザの言語に応じて自動的に表示します
2. **手動切り替え**：ユーザーが Web Chat 内で言語を切り替えると、引用元のテキストも同時に更新されます
3. **サイトの言語環境**：お客様のサイトが多言語に対応している場合、Web Chat は自動的にサイトの言語設定に合わせます

{% hint style="info" %}
Web Chat の言語設定方法については、こちらをご参照ください：[Web Chat 紹介の概要](https://docs.maiagent.ai/maiagent-user-guide/ja/build/choose-channel/web-chat.md)
{% endhint %}

## 視覚表現の最適化 <a href="#visual-presentation-optimization" id="visual-presentation-optimization"></a>

多言語サポートに加えて、引用元の視覚表現も最適化され、情報がより明確で読みやすくなりました。

### 最適化項目 <a href="#optimization-items" id="optimization-items"></a>

1. **余白の調整**：引用元と回答内容の間の余白がより適切になり、視覚的な階層がより明確になりました
2. **フォントスタイル**：引用元には異なるフォントスタイルを使用し、本文と区別しています
3. **色の調整**：引用元には薄めの色を使用し、本文の読みやすさを妨げないようにしています
4. **アイコンによる表示**：統一されたアイコンで引用元を示し、識別しやすくしています

## ダークモード対応 <a href="#dark-mode-support" id="dark-mode-support"></a>

引用元表示はダークモードにも対応しています。エンドユーザーのデバイスでダークテーマが使われている場合、引用元の文字色と背景色が自動的に調整され、暗い背景でもはっきり表示されます。

### ダークモードの対応項目 <a href="#dark-mode-adaptation-items" id="dark-mode-adaptation-items"></a>

* 文字色が自動的に明るい色に調整されます
* 背景色がダークテーマに合わせて調整されます
* 本文とのコントラストが維持されます

{% hint style="success" %}
ダークモードはユーザーのデバイス設定に応じて自動的に有効になるため、手動で設定する必要はありません。
{% endhint %}

## 活用シーン <a href="#use-cases" id="use-cases"></a>

### 🏛️ 行政の政策相談プラットフォーム <a href="#government-policy-consultation" id="government-policy-consultation"></a>

**利用シーン**： 住民が補助金制度の申請条件を問い合わせた際、Agent は回答を提供するだけでなく、政策告示の出典へのリンクも表示します。

**メリット**：

* 情報の信頼性が高まります
* 住民が告示の全文をさらに確認できます
* 情報の正確性に対する住民の不安を軽減できます

### ⚖️ 法律相談アシスタント <a href="#legal-consultation-assistant" id="legal-consultation-assistant"></a>

**利用シーン**： ユーザーがある法令の規定について質問すると、Agent は条文の出典と条番号を表示します。

**メリット**：

* 法的根拠を余すところなく提示できます
* ユーザーが原文の条文を確認できます
* 相談サービスの専門性が高まります

### 🏥 医療情報プラットフォーム <a href="#medical-information-platform" id="medical-information-platform"></a>

**利用シーン**： 患者が病気に関する情報を問い合わせると、Agent はその情報がどの医学文献や健康教育の記事に基づくものかを示します。

**メリット**：

* 情報の出典を透明化できます
* 患者が情報の信頼性を理解できます
* 医療情報の提供に求められる基準に適合します

## 管理者設定 <a href="#admin-settings" id="admin-settings"></a>

### 引用元表示を有効にする <a href="#enable-citation-display" id="enable-citation-display"></a>

引用元表示機能は、デフォルトで有効になっています。設定を変更したい場合は、次の手順で行います。

1. 「AI アシスタント」の設定ページを開きます
2. 「回答設定」を選択します
3. 「引用元を表示」オプションを見つけます
4. スイッチを切り替えて、有効または無効にします

### 引用元の形式をカスタマイズする <a href="#customize-citation-format" id="customize-citation-format"></a>

ナレッジベースのファイルにメタデータを追加して、引用元の表示形式をカスタマイズできます。

* **ファイルタイトル**：引用元に表示されるファイル名
* **章番号**：具体的な章やページ番号を表示
* **公開日**：ファイルの公開日または更新日を表示
* **外部リンク**：元のファイルへのリンクを提供

{% hint style="info" %}
ナレッジベースのメタデータの設定方法については、こちらをご参照ください：[ファイル管理：タグとメタデータ](https://docs.maiagent.ai/maiagent-user-guide/ja/build/knowledge-base/tags-and-metadata.md)
{% endhint %}

## よくある質問 <a href="#faq" id="faq"></a>

### Q1：引用元には参照したすべてのファイルが表示されますか？ <a href="#faq-show-all-referenced-documents" id="faq-show-all-referenced-documents"></a>

必ずしもそうではありません。情報過多を避けるため、システムは「最も関連性の高い」引用元を表示し、通常は 3〜5 件以内です。

### Q2：引用元を非表示にできますか？ <a href="#faq-hide-citation" id="faq-hide-citation"></a>

はい、できます。Agent の設定で「引用元を表示」オプションをオフにしてください。

### Q3：引用元の言語を特定の言語に固定できますか？ <a href="#faq-fix-citation-language" id="faq-fix-citation-language"></a>

引用元は Web Chat の言語設定に自動的に合わせて表示されます。特定の言語に固定したい場合は、Web Chat の設定で言語オプションを固定してください。

### Q4：引用元のリンクはクリックできますか？ <a href="#faq-citation-clickable-link" id="faq-citation-clickable-link"></a>

はい、できます。ナレッジベースのファイルに外部リンクを設定している場合、引用元はクリック可能なリンクとして表示されます。

### Q5：ダークモードで引用元が見づらい場合はどうすればよいですか？ <a href="#faq-citation-dark-mode-visibility" id="faq-citation-dark-mode-visibility"></a>

システムはダークモード向けに最適化されています。それでも問題がある場合は、ブラウザのキャッシュが原因の可能性がありますので、キャッシュを削除するか、ページを再読み込みしてください。


---

# 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.maiagent.ai/maiagent-user-guide/ja/build/choose-channel/web-chat/citation-display.md?ask=<question>&goal=<user_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.
