# アノテーション返信

アノテーションリプライ機能は、手動編集されたアノテーションを通じて、アプリケーションにカスタマイズされた高品質なQ\&Aリプライ能力を提供します。

適用シーン：

* **特定分野のカスタマイズ回答：** 企業や政府などのカスタマーサービスやナレッジベースQ\&Aのシーンで、特定の問題に対してシステムが明確な結果を提供することを望む場合、特定の問題についてカスタマイズされた出力結果が必要です。例えば、特定の問題に対する「標準回答」や、特定の問題に対する「回答不可」の設定などが挙げられます。
* **POCやデモ製品の迅速なチューニング：** プロトタイプ製品を迅速に構築する際に、アノテーションリプライを通じて実現されたカスタマイズ回答は、Q\&Aの生成結果の予期を効率的に向上させ、顧客満足度を高めることができます。

アノテーションリプライ機能は、LLM (大規模言語モデル) の生成プロセスをスキップし、RAG (Retrieval-Augmented Generation) の生成幻覚問題を回避するための別の検索強化システムを提供するものです。

### 使用プロセス

1. アノテーションリプライ機能を有効にすると、LLMの対話リプライ内容に対してアノテーションを行うことができます。LLMがリプライした高品質な回答を直接アノテーションとして追加することもできますし、必要に応じて高品質な回答を手動で編集することもできます。これらの編集されたアノテーション内容は永続化保存されます。
2. ユーザーが再度類似の質問をした場合、その質問をベクトル化し、類似するアノテーションをクエリします。
3. マッチング項目が見つかった場合、そのアノテーションに対応する回答を直接返し、LLMやRAGのプロセスを経由せずにリプライします。
4. マッチング項目が見つからなかった場合、質問は通常プロセスを継続します（LLMやRAGに渡されます）。
5. アノテーションリプライ機能をオフにすると、システムはアノテーションからのマッチングリプライを継続して行いません。

<figure><img src="https://3244742310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBl3K6n12AeCkG3icHwfh%2Fuploads%2Fgit-blob-090c7766acfb0ee3a498fc8eff83b825f6e678a0%2Fimage%20(130).png?alt=media" alt="" width="563"><figcaption><p>アノテーションリプライの流れ</p></figcaption></figure>

### 提示詞編成でアノテーションリプライを有効にする

「アプリケーション構築->機能追加」からアノテーションリプライのスイッチを有効にします：

<figure><img src="https://3244742310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBl3K6n12AeCkG3icHwfh%2Fuploads%2Fgit-blob-0695c6d76f7f304650f52d8f3074aeb6f23ecc04%2Fannotated-replies.png?alt=media" alt=""><figcaption><p>提示詞編成でアノテーションリプライを有効にする</p></figcaption></figure>

有効にする際には、まずアノテーションリプライのパラメータを設定する必要があります。設定可能なパラメータには次のものがあります：スコア閾値と埋め込みモデル

**スコア閾値**：アノテーションリプライのマッチング類似度閾値を設定するために使用されます。閾値スコアを超えるアノテーションのみがリコールされます。

**埋め込みモデル**：アノテーションテキストをベクトル化するために使用され、モデルの切り替え時には再度埋め込みが生成されます。

保存して有効にすると、この設定は直ちに有効となり、システムはすべての保存されたアノテーションに対して埋め込みモデルを利用して埋め込みを生成し保存します。

<figure><img src="https://3244742310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBl3K6n12AeCkG3icHwfh%2Fuploads%2Fgit-blob-6df72ab4676f9f3e8e1d3a74f09b54d7f71d9740%2Fsetting-parameters-for-annotated-replies.png?alt=media" alt=""><figcaption><p>アノテーションリプライのパラメータ設定</p></figcaption></figure>

### 会話デバッグページでアノテーションを追加する

デバッグおよびプレビューページでモデルのリプライ情報に直接アノテーションを追加または編集できます。

<figure><img src="https://3244742310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBl3K6n12AeCkG3icHwfh%2Fuploads%2Fgit-blob-501ce9aa196f4fdb36d3e16a4329235a32d8fe60%2Fadd-annotation-reply.png?alt=media" alt=""><figcaption><p>アノテーションリプライを追加する</p></figcaption></figure>

必要な高品質リプライに編集して保存します。

<figure><img src="https://3244742310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBl3K6n12AeCkG3icHwfh%2Fuploads%2Fgit-blob-ce68714f12cd18c0c62ba9b372f04516980af92b%2Fediting-annotated-replies.png?alt=media" alt=""><figcaption><p>アノテーションリプライを編集する</p></figcaption></figure>

同じユーザー質問を再度入力すると、システムは既に保存されたアノテーションを使用してユーザー質問に直接リプライします。

<figure><img src="https://3244742310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBl3K6n12AeCkG3icHwfh%2Fuploads%2Fgit-blob-90579362809825c99d3821c37c9b762af7738a98%2Fannotaiton-reply.png?alt=media" alt=""><figcaption><p>保存されたアノテーションを通じてユーザー質問にリプライする</p></figcaption></figure>

### ログとアノテーションでアノテーションリプライを有効にする

「アプリケーション構築->ログとアノテーション->アノテーション」からアノテーションリプライのスイッチを有効にします：

<figure><img src="https://3244742310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBl3K6n12AeCkG3icHwfh%2Fuploads%2Fgit-blob-26bc77e8c8a57ac7bc1c6bbaa9040b259c8069f0%2Flogs-annotation-switch.png?alt=media" alt=""><figcaption><p>ログとアノテーションでアノテーションリプライを有効にする</p></figcaption></figure>

### アノテーションバックエンドでアノテーションリプライのパラメータを設定する

アノテーションリプライで設定可能なパラメータには次のものがあります：スコア閾値と埋め込みモデル

**スコア閾値**：アノテーションリプライのマッチング類似度閾値を設定するために使用されます。閾値スコアを超えるアノテーションのみがリコールされます。

**埋め込みモデル**：アノテーションテキストをベクトル化するために使用され、モデルの切り替え時には再度埋め込みが生成されます。

<figure><img src="https://3244742310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBl3K6n12AeCkG3icHwfh%2Fuploads%2Fgit-blob-d9661fc9a33a275ea046f1bac17bab6341aa4bdb%2Fannotated-replies-initial.png?alt=media" alt=""><figcaption><p>アノテーションリプライのパラメータを設定する</p></figcaption></figure>

### アノテーションQ\&Aペアを一括インポートする

一括インポート機能内で、アノテーションインポートテンプレートをダウンロードし、テンプレート形式に従ってアノテーションQ\&Aペアを編集します。編集が完了したら、一括インポートします。

<figure><img src="https://3244742310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBl3K6n12AeCkG3icHwfh%2Fuploads%2Fgit-blob-19e15f2694a2a3af6eadc9028fb41ccbc51846f4%2Fbulk-import-annotated.png?alt=media" alt=""><figcaption><p>アノテーションQ&#x26;Aペアを一括インポートする</p></figcaption></figure>

### アノテーションQ\&Aペアを一括エクスポートする

アノテーション一括エクスポート機能を通じて、システム内に保存されたすべてのアノテーションQ\&Aペアを一度にエクスポートできます。

<figure><img src="https://3244742310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBl3K6n12AeCkG3icHwfh%2Fuploads%2Fgit-blob-e09b93c3a811bed2028468e6330127543a83e7a2%2Fbulk-export-annotations.png?alt=media" alt=""><figcaption><p>アノテーションQ&#x26;Aペアを一括エクスポートする</p></figcaption></figure>

### アノテーションリプライのヒット履歴を確認する

アノテーションヒット履歴機能内で、すべてのヒットしたアノテーションの編集履歴、ヒットしたユーザー質問、リプライ回答、ヒットソース、マッチング類似度スコア、ヒット時間などの情報を確認できます。これらのシステム情報に基づいて、アノテーション内容を継続的に改善することができます。

<figure><img src="https://3244742310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBl3K6n12AeCkG3icHwfh%2Fuploads%2Fgit-blob-02e2b0c72ef7cb702d44b5ef44dcd30a3f4dc2a1%2Fview-annotation-hit-history.png?alt=media" alt=""><figcaption><p>アノテーションリプライのヒット履歴を確認する</p></figcaption></figure>
