> 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/tools/agent-ui/quick-reply.md).

# Quick Reply

Quick Reply のクイック返信ボタン列を作成し、Agent の回答にクリックできる選択肢を添えてユーザーの次の操作を案内します

Quick Reply は [Agent UI](https://docs.maiagent.ai/maiagent-user-guide/ja/build/tools/agent-ui.md) の一種です。Agent が回答すると、メッセージの下にクリックできるボタン（チップ）が横並びで表示されます。ユーザーは文字を入力せずに、メッセージの送信、リンクの表示、入力欄へのテキストの事前入力といった次の操作を選べます。Agent は「トリガー条件」に基づいて表示するタイミングを判断します。ボタンは最大 13 個です。

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

通信会社のカスタマーサポートでは、ユーザーが問い合わせを始めたものの意図が明確でない場合、Agent に「どのようなことでお困りですか？」と尋ねさせ、「請求を確認」「プランを変更」「修理を依頼」の 3 つのボタンを添えられます。ユーザーが「請求を確認」をクリックすると、Agent はすぐに請求の手続きに進みます。動的生成という使い方もあります。ユーザーが関心のある商品について話したときに、LLM が会話の状況に応じて関連商品を最大 5 件、ボタンとして提示します。

[クイックメニュー](https://docs.maiagent.ai/maiagent-user-guide/ja/build/tools/quick-menu.md) との違いは、クイックメニューが入力バーに**常時表示**され、会話によって変化しない点です。Quick Reply は**特定の回答の下に添付**されます。表示するタイミングは Agent が判断し、内容は会話に応じてその場で生成できます。

## Quick Reply の作成 <a href="#create" id="create"></a>

{% stepper %}
{% step %}

### 種類の選択 <a href="#step-pick-type" id="step-pick-type"></a>

「<mark style="color:blue;">AI 機能</mark>」→「<mark style="color:blue;">Agent UI</mark>」に移動し、「<mark style="color:blue;">Agent UI を追加</mark>」をクリックして、**Quick Reply**（クイック返信ボタン列）を選択します。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-b3e3e9a5e71c9b2d4cff4aa99615ba6ff00de631%2Fagent-ui-quick-reply-pick-type.png?alt=media" alt="Agent UI の種類を選択するページの Quick Reply カード"><figcaption><p>「Agent UI の種類を選択」で Quick Reply をクリックします</p></figcaption></figure>
{% endstep %}

{% step %}

### 基本情報の入力 <a href="#step-basic-info" id="step-basic-info"></a>

| 項目                                      | 説明                                                                                                                       |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| <mark style="color:blue;">表示名</mark>    | 管理画面に表示する名前です。例：「カスタマーサポートメニュー」                                                                                          |
| <mark style="color:blue;">ツール名</mark>   | LLM が使用する英語の識別名です。命名規則（英字とアンダースコアを使用し、スペースを含めない）に従う必要があります                                                               |
| <mark style="color:blue;">説明</mark>     | 任意項目です。このボタンセットの用途を説明します                                                                                                 |
| <mark style="color:blue;">トリガー条件</mark> | **必須です。** どのような状況でこのボタンセットを添付するかを自然言語で Agent に伝えます。例：「ユーザーが問い合わせを始め、意図が明確でなく、選択を案内する必要がある場合」「よくある質問をされたときにカテゴリへの入口を提示する」 |

{% hint style="info" %}
トリガー条件を具体的に書くほど、Agent は毎回の回答にボタンを添付するのではなく、適切なタイミングで表示しやすくなります。同じ Agent に複数の Quick Reply セットを割り当てる場合は、各セットのトリガー条件が重ならないようにしてください。
{% endhint %}
{% endstep %}

{% step %}

### テンプレートの選択（任意） <a href="#step-template" id="step-template"></a>

「<mark style="color:blue;">テンプレートを選択</mark>」には組み込みのテンプレートが表示されます。クリックすると右側にプレビューが表示されます。「<mark style="color:blue;">このテンプレートを適用</mark>」を押すと、現在のボタン設定がテンプレートの内容で**上書き**されます。適用後に編集することもできます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-9b43f0f93949382cc0e9ce547df260c1cc31e054%2Fagent-ui-quick-reply-editor.png?alt=media" alt="カスタマーサポートメニューテンプレートを適用した Quick Reply の編集画面とプレビュー"><figcaption><p>「カスタマーサポートメニュー」テンプレートを適用すると、右側のプレビューで Web Chat のボタン列を再現します</p></figcaption></figure>
{% endstep %}

{% step %}

### ボタンの設定 <a href="#step-buttons" id="step-buttons"></a>

まず「<mark style="color:blue;">ボタン設定</mark>」の上部で <mark style="color:blue;">静的リスト</mark> または <mark style="color:blue;">動的生成</mark> を選択し（違いは次の節を参照）、各ボタンを設定します。右側の「<mark style="color:blue;">プレビュー</mark>」では Web Chat での表示をリアルタイムに再現します。ボタンを直接クリックして動作を試し、「<mark style="color:blue;">ボタンを再表示</mark>」を押すと最初から試せます。
{% endstep %}

{% step %}

### 保存 <a href="#step-save" id="step-save"></a>

プレビューを確認して、右上の「<mark style="color:blue;">保存</mark>」をクリックします。保存前に、ボタンのテキストが空でないこと、固定テキストが 20 文字以内であること、AI 項目にプロンプトがあること、リンクが `https://` で始まること、数量の範囲が 1～13 であることがチェックされます。
{% endstep %}
{% endstepper %}

## 静的リストと動的生成 <a href="#static-vs-dynamic" id="static-vs-dynamic"></a>

| モード                                    | ボタンの決定方法                                                   | 適した用途                         |
| -------------------------------------- | ---------------------------------------------------------- | ----------------------------- |
| <mark style="color:blue;">静的リスト</mark> | 1～13 個のボタンを固定で設定します。各ボタンのテキストとアクションは、項目ごとに「固定」または「AI」を選べます | 固定のサービスカテゴリ、よくある質問への入口        |
| <mark style="color:blue;">動的生成</mark>  | 「ボタンパターン」と数量の範囲だけを指定し、LLM が会話の状況に応じて N 個のボタンをその場で生成します     | おすすめ商品、ユーザーが話したトピックに応じた選択肢の提示 |

### 静的リスト <a href="#static-list" id="static-list"></a>

「<mark style="color:blue;">ボタンを追加</mark>」をクリックしてボタンを追加します（最大 13 個）。各ボタンを展開すると、次の節で説明する項目を設定できます。タイトル右側のゴミ箱アイコンで削除できます。各ボタンのタイトルにはアクションの種類のラベルとボタンのテキストが表示されるため、すぐに見分けられます。

### 動的生成 <a href="#dynamic-generation" id="dynamic-generation"></a>

| 項目                                                                        | 説明                                                                                    |
| ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| <mark style="color:blue;">最小数</mark>／<mark style="color:blue;">最大数</mark> | LLM が生成するボタン数の範囲です。1 ≤ 最小 ≤ 最大 ≤ 13 を満たす必要があります                                       |
| <mark style="color:blue;">生成ルール</mark>                                    | いつ、どのように、何個生成するかを LLM に伝えます。例：「ユーザーが話した興味に応じて関連商品を最大 5 件提示する。該当するものがなければセット全体をスキップする」 |
| <mark style="color:blue;">ボタンパターン</mark>                                  | 生成されるすべてのボタンに共通する設定（アクションの種類、テキスト、アイコン）です。通常、テキスト項目は AI 生成に設定します                      |

動的生成モードでは JSON ソースの編集はできません。

## 各ボタンの設定 <a href="#button-fields" id="button-fields"></a>

### アクションの種類 <a href="#action-types" id="action-types"></a>

| アクション                                     | クリック後の動作                                  | 入力する項目                                                                        |
| ----------------------------------------- | ----------------------------------------- | ----------------------------------------------------------------------------- |
| <mark style="color:blue;">メッセージを送信</mark> | ユーザーとして Agent にメッセージを送信します                | <mark style="color:blue;">送信メッセージ</mark>：実際に送信するテキストです。ボタンのテキストと異なっていてもかまいません |
| <mark style="color:blue;">リンクを開く</mark>   | URL を開きます                                 | <mark style="color:blue;">リンク URL</mark>：`https://` で始まる必要があります               |
| <mark style="color:blue;">入力欄に事前入力</mark> | テキストを入力欄に入れます。すぐには送信されず、ユーザーが編集してから送信できます | <mark style="color:blue;">事前入力テキスト</mark>                                     |

### 固定と AI <a href="#fixed-vs-ai" id="fixed-vs-ai"></a>

「<mark style="color:blue;">ボタンのテキスト</mark>」と上の表のアクション項目には、右側に <mark style="color:blue;">固定</mark>／<mark style="color:blue;">AI</mark> の切り替えがあります。

* **固定**：入力した値を表示します。ボタンのテキストは最大 20 文字です。
* **AI**：プロンプトを入力すると、LLM が会話中にそのプロンプトに従って内容を生成します。たとえば、ボタンのテキストを AI に設定し、「ユーザーが直前に言及した商品名」と入力します。

### ボタンのアイコン <a href="#button-icon" id="button-icon"></a>

各ボタンには <mark style="color:blue;">なし</mark>、<mark style="color:blue;">画像</mark>（`https://` の画像 URL を入力）、<mark style="color:blue;">Emoji</mark>（絵文字 1 個）、<mark style="color:blue;">略称の丸型バッジ</mark>（1～2 文字）を選べます。

{% hint style="info" %}
「<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>」を変更してください。ここで説明しているのは管理画面のプレビューです。訪問者側ではアイコンの位置や表示方法が異なる場合があります。
{% endhint %}

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-2536eab0bf9cbcd865b5264af22ae3b951c17a5d%2Fquick-reply-action-icon-preview-prod.png?alt=media" alt="管理画面の Quick Reply プレビューで、サービス照会ボタンの右側に紙飛行機アイコンが表示されています"><figcaption><p>管理画面のプレビュー：ボタンのアイコンを「なし」、アクションの種類を「メッセージを送信」に設定しても、アクションを示す紙飛行機アイコンは表示されます。</p></figcaption></figure>

### 高度な action JSON（LINE のみ） <a href="#advanced-action-json" id="advanced-action-json"></a>

LINE で 3 種類の基本アクション以外の LINE ネイティブアクション（`datetimepicker`、`postback`、`camera`、`cameraRoll`、`location`、`richmenuswitch`、`clipboard` など）を使うには、上部のサンプルタブをクリックして挿入するか、LINE action オブジェクトの JSON を直接貼り付けます。システムはそのまま LINE に渡します。この種類のボタンはプレビューではグレーで表示され、Web Chat には表示されません。

## JSON ソース <a href="#json-source" id="json-source"></a>

「<mark style="color:blue;">JSON ソース</mark>」セクション（初期状態では折りたたみ）は、現在の静的リストの LINE `quickReply` JSON に対応します。上級ユーザーは直接編集し、「<mark style="color:blue;">JSON をボタン設定に適用</mark>」を押せます。適用するとボタン設定が上書きされます。対応するアクションは `message`／`uri`／`inputOption` の 3 種類のみで、13 個を超えるボタンは破棄されます。

## Agent への割り当て <a href="#attach-to-agent" id="attach-to-agent"></a>

保存後、**Agent モード**を使用している Agent に割り当てると有効になります。Agent の設定 →「<mark style="color:blue;">インターフェースと体験</mark>」→「<mark style="color:blue;">Agent UI</mark>」→「<mark style="color:blue;">Agent UI を選択</mark>」に進み、作成した Quick Reply にチェックを入れて保存します。操作の詳細は [Agent への紐付け](https://docs.maiagent.ai/maiagent-user-guide/ja/build/tools/agent-ui.md#bind-to-chatbot) を参照してください。

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

<details>

<summary>ボタンはどのプラットフォームで表示されますか？</summary>

Web Chat と LINE で表示されます。3 種類の基本アクションは両方で使用できます。「高度な action JSON」は LINE でのみ有効です。

</details>

<details>

<summary>Agent がボタンを添付しないのはなぜですか？</summary>

まず、Agent の回答モードが Agent モードになっていること、Agent UI タブでこの Quick Reply セットにチェックが入っていること、「トリガー条件」の状況がユーザーの実際の質問と一致していることを確認してください。動的生成モードでは、LLM が「生成ルール」に基づいて適切な項目がないと判断すると、セット全体をスキップします。

</details>

<details>

<summary>ユーザーがボタンをクリックすると、ボタンは消えますか？</summary>

はい。ボタンはその回答にのみ添付されます。いずれかをクリックするとボタン列全体が非表示になります（プレビューには「ボタンは非表示です」と表示されます）。次の回答にボタンを添付するかどうかは、Agent が改めて判断します。

</details>


---

# 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/tools/agent-ui/quick-reply.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.
