> 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/conversation-settings/platform-settings/interaction-settings.md).

# インタラクション設定

Webチャットウィンドウの対話動作：あいさつ、会話開始の質問、あいさつの選択肢をAgentのコンテキストに含める設定、会話の表示設定（前回の会話の再開、会話履歴一覧、アイドルタイマー）、満足度アンケート、クォータを使い切った際のメッセージ。

<mark style="color:blue;">インタラクション設定</mark>では、チャットウィンドウの「開始・進行・終了」の3段階での動作を管理します。開始時のあいさつや案内する質問、会話中に前回の会話を再開するかどうかや何分の無操作で終了とするか、終了後の満足度確認やクォータを使い切った際の案内を設定します。これらはWebおよび内部プラットフォームでのみ利用できます。LINEなどのメッセージングプラットフォームでは、会話画面は各プラットフォーム側で決まります。設定ページ全体の構成は[会話プラットフォーム設定の概要](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/platform-settings.md)をご覧ください。

{% hint style="info" %}
**ソリューションガイド**：このページは会話プラットフォーム設定の1つの手順です。テキストカスタマーサービスの導入から公開までの流れは[テキストカスタマーサービス：ゼロから公開まで](https://docs.maiagent.ai/maiagent-user-guide/ja/serve/text-service.md)、音声カスタマーサービスは[音声カスタマーサービス：ゼロから公開まで](https://docs.maiagent.ai/maiagent-user-guide/ja/serve/voice.md)をご覧ください。
{% endhint %}

## 1. 利用する場面 <a href="#when-to-use" id="when-to-use"></a>

カスタマーサービスの責任者が、訪問者はウィンドウを開いても何を聞けばよいか分からず、「こんにちは」だけで終わる会話が多いことに気づきました。そこで、Webプラットフォームの<mark style="color:blue;">インタラクション設定</mark>を開き、<mark style="color:blue;">あいさつ</mark>に「こんにちは！ご注文、返品・交換、営業時間についてご案内します」と入力します。さらに<mark style="color:blue;">会話開始の質問</mark>として「返品の申請方法は？」「注文はいつ届きますか？」「営業時間は？」の3つを追加し、<mark style="color:blue;">あいさつの選択肢をAgentのコンテキストに含める</mark>をオンにします。保存後、訪問者がウィンドウを開くと3つの質問ボタンが表示され、クリックするだけで会話を始められます。「2」と返信した場合も、Agentは到着時期についての質問だと理解できます。

## 2. テキストのあいさつ <a href="#greeting" id="greeting"></a>

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-27f3085ad725f5d6b8ef3a6ca9ca9c5bb9bf58f3%2Fwebchat-interaction-greetings-prod.png?alt=media" alt="インタラクション設定：テキストのあいさつ、言語別のあいさつ、音声のあいさつ、会話開始の質問"><figcaption><p>インタラクション設定：あいさつと会話開始の質問</p></figcaption></figure>

### あいさつ <a href="#greeting-text" id="greeting-text"></a>

<mark style="color:blue;">＋ 追加</mark>をクリックしてあいさつを追加すると、会話の開始時にAgentが自己紹介やあいさつをします。複数追加でき、会話を開始するたびにランダムに1つ表示されます。項目の右側にある削除アイコンで削除できます。

よく使われる書き方：

* **ブランドに合わせたあいさつ**：「当サイトへようこそ！お客様専用のカスタマーサポートアシスタントです」
* **案内型のあいさつ**：「製品情報のご案内、使い方に関するご質問、ご注文の手続きをお手伝いします」のように、対応範囲を明確に伝えます

### あいさつにテキストリンクを追加する <a href="#greeting-links" id="greeting-links"></a>

あいさつにはMarkdownの`[リンクテキスト](完全なURL)`構文を使用できます。訪問者にはクリック可能なテキストが表示され、クリックすると指定したページが新しいタブで開きます。

例えば、カスタマーサービスの責任者が、質問する前に利用ガイドを読んでほしいと考えた場合、<mark style="color:blue;">あいさつ</mark>に次のように入力します。

```markdown
こんにちは！カスタマーサービスのデモへようこそ。

まず [MaiAgentユーザーガイド](https://docs.maiagent.ai/) をお読みになってから、ご質問をお寄せください。
```

保存して新しいWebチャットを開くと、訪問者には「MaiAgentユーザーガイド」というテキストリンクが表示され、クリックするとガイドが開きます。完全なURLを入力し、公開前に実際にクリックして正しいページに移動することを確認してください。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-a9c58670632249ea6eb965c48d97f355d3ccfc48%2Fwebchat-greeting-markdown-link-prod.png?alt=media" alt="Webチャットのあいさつの吹き出し内で、MaiAgentユーザーガイドが青色のテキストリンクとして表示されています"><figcaption><p>訪問者に表示されるあいさつ：あいさつ文の中にテキストリンクを埋め込んでいます</p></figcaption></figure>

### 言語別のあいさつ <a href="#greeting-by-locale" id="greeting-by-locale"></a>

<mark style="color:blue;">言語別のあいさつ</mark>の横にある<mark style="color:blue;">＋ 追加</mark>をクリックすると、特定の言語向けに別のあいさつを作成できます。ユーザーの言語が一致する場合は、その言語のあいさつが優先されます。一致する言語がない場合は、上のデフォルトのあいさつが使われます。同じ言語に複数ある場合はランダムに1つ選ばれます。

### 音声のあいさつ <a href="#voice-greeting" id="voice-greeting"></a>

<mark style="color:blue;">音声のあいさつ</mark>を展開すると、音声会話用の開始メッセージを別途設定できます。音声機能を接続したプラットフォーム向けの設定で、テキストのみのカスタマーサービスでは設定不要です。

## 3. 会話開始の質問 <a href="#starter-questions" id="starter-questions"></a>

<mark style="color:blue;">会話開始の質問</mark>の横にある<mark style="color:blue;">＋ 追加</mark>をクリックし、「返品の申請方法は？」「営業時間は？」などの案内用の質問やよくある質問を追加します。これらの質問は会話の冒頭にボタンとして表示され、ユーザーは入力せずにクリックするだけで送信できます。

* <mark style="color:blue;">ランダム表示件数</mark>：複数の質問を設定した場合、会話を開始するたびにランダムに表示する件数を指定します（デフォルトは2件）
* <mark style="color:blue;">言語別の会話開始の質問</mark>：あいさつと同様に、言語が一致する場合はその言語の質問が優先されます

会話開始の質問は固定のリストで、会話の冒頭にのみ表示されます。プラットフォームには「会話内容に応じておすすめの質問を動的に生成する」設定はありません。会話の途中でAgentが状況に応じたクリック可能な選択肢を提示するには、[Agent UI](https://docs.maiagent.ai/maiagent-user-guide/ja/build/tools/agent-ui.md)の[Quick Reply](https://docs.maiagent.ai/maiagent-user-guide/ja/build/tools/agent-ui/quick-reply.md)（Agentの返信の下にボタン列を表示）または[質問ツール](https://docs.maiagent.ai/maiagent-user-guide/ja/build/tools/agent-ui.md#ask-user-question)（Agentが質問し、ユーザーが選択）を使います。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-3062bdaf23ab7a259e4d955d06166969931febb4%2Fwebchat-greeting-starters-prod.png?alt=media" alt="チャットウィンドウにあいさつと会話開始の質問ボタンが表示されています"><figcaption><p>チャットウィンドウ冒頭のあいさつと会話開始の質問</p></figcaption></figure>

## 4. あいさつの選択肢をAgentのコンテキストに含める <a href="#include-greeting-in-context" id="include-greeting-in-context"></a>

<mark style="color:blue;">あいさつの選択肢をAgentのコンテキストに含める</mark>はデフォルトでオフです。オンにすると、あいさつ本文と**番号付きの選択肢リスト**がAIに渡されるため、ユーザーが番号や短い言葉で回答しても選択肢として認識できます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-1751740ab52f7e08eed37a375aac50a73f2a39f6%2Fwebchat-greeting-context-toggle-prod.png?alt=media" alt="インタラクション設定の「あいさつの選択肢をAgentのコンテキストに含める」スイッチ"><figcaption><p>「あいさつの選択肢をAgentのコンテキストに含める」スイッチ</p></figcaption></figure>

### オンにする前と後の違い <a href="#greeting-context-comparison" id="greeting-context-comparison"></a>

航空会社のカスタマーサービスを例にします。あいさつを「どのようなご用件でしょうか？」、会話開始の質問を「フライト情報」「手荷物規定」「会員マイル」の順に設定します。オンにすると、システムが順番に番号を付けます。訪問者が「2」とだけ入力した場合は、次のようになります。

| 項目             | オフ（デフォルト）                                            | オン                             |
| -------------- | ---------------------------------------------------- | ------------------------------ |
| 訪問者に表示される画面    | あいさつ＋ランダムに選ばれた一部の開始質問                                | あいさつ＋**設定順にすべて表示**された開始質問      |
| AIに渡される情報      | あいさつ本文のみで、選択肢リストはありません                               | あいさつ本文＋番号付きの選択肢リスト             |
| 訪問者が「2」と返信した場合 | AIは「2」がどの選択肢か分からず、「どのようなことをお知りになりたいですか？」と聞き返す場合があります | AIは「2」＝手荷物規定と理解し、手荷物規定を直接案内します |
| 開始質問の表示動作      | ランダムに並べ替えられ、「ランダム表示件数」に制限されます                        | すべて順番に表示され、「ランダム表示件数」は適用されません  |

### 適した利用場面 <a href="#greeting-context-use-cases" id="greeting-context-use-cases"></a>

あいさつと複数の会話開始の質問を組み合わせてメニュー形式で案内し、決まったサービスから訪問者に選んでもらう場合に適しています。

* **金融／銀行**：あいさつは「オンラインサポートへようこそ。ご利用のサービスをお選びください」、選択肢は「口座残高の確認」「クレジットカードの申込状況」「保険契約の照会」「担当者への接続」です。お客様が「3」と返信すると、AIは保険契約の照会フローへ直接進みます
* **医療／クリニック**：あいさつは「こんにちは。どのサービスをご希望ですか？」、選択肢は「診療時間の確認」「診療予約」「診察の進行状況」「健康情報」です。利用者が「予約」と返信しても、AIは選択肢2に対応づけられます
* **政府／公共機関**：あいさつは「お申し込みの手続きをお選びください」、選択肢は「補助金申請」「イベント申込」「窓口の検索」です。市民が「1」と返信すると、AIは続けて申請したい補助金の種類を尋ねます

| 案内の形式                                                           | 推奨設定                         |
| --------------------------------------------------------------- | ---------------------------- |
| **メニュー形式の案内**：複数の会話開始の質問を設定し、訪問者に番号や短い言葉で回答してもらい、決まったフローで進めたい場合 | ✅ オンを推奨します                   |
| **自由な会話**：一般的なあいさつのみで、会話開始の質問を設定していない場合                         | ❌ オンにする必要はなく、Tokenコストを節約できます |

### オンにした場合の注意点 <a href="#greeting-context-side-effects" id="greeting-context-side-effects"></a>

1. **「ランダム表示件数」が無効になります**：訪問者に表示される番号とAIが理解する番号を一致させるため、オンにすると会話開始の質問はランダムに並べ替えられず、表示件数の制限も受けずに、設定順ですべて表示されます。オンにする前に、質問数が多すぎないか確認してください
2. **Tokenコストが増加します**：オンにすると黄色の警告が表示され、リクエストごとのコンテキストが長くなることを知らせます。選択肢が多いほどコストの増加も大きくなります

{% hint style="info" %}
オフの場合の動作は従来と同じです。AIはあいさつ本文を見ることができますが、番号付きの選択肢リストは受け取りません。そのため、ユーザーが「1」とだけ返信した場合、選択肢に対応づけられないことがあります。
{% endhint %}

## 5. 会話の表示設定 <a href="#conversation-display" id="conversation-display"></a>

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-913aefb7e9a13d38d8985cd5ab3f4cd9772f6b8a%2Fwebchat-interaction-display-prod.png?alt=media" alt="会話の表示設定、満足度アンケート設定、クォータを使い切った際のメッセージ"><figcaption><p>会話の表示設定、満足度アンケート設定、クォータを使い切った際のメッセージ</p></figcaption></figure>

| スイッチ          | 説明                                        | 例                                          |
| ------------- | ----------------------------------------- | ------------------------------------------ |
| **前回の会話を再開**  | 前回の会話内容を保持し、ユーザーがウィンドウを再び開いたときに続きから会話できます | お客様が昨日「商品はいつ届きますか」と質問し、今日開いても昨日の内容を確認できます  |
| **会話履歴一覧を表示** | 過去の会話履歴の確認や切り替え、新しい会話の開始ができます             | 「今日の注文に関する質問」「先週の使い方に関する相談」など、過去の会話を確認できます |
| **アイドルタイマー**  | 設定した時間を超えてユーザーの操作がない場合、現在の会話を自動的に終了します    | 質問後にお客様が10分間離れると、会話が終了扱いになります              |

<mark style="color:blue;">アイドルタイマー</mark>をオンにすると、次の2つの設定が表示されます。

* <mark style="color:blue;">アイドル時間（分）</mark>：3〜60分の範囲で設定できます
* <mark style="color:blue;">通知ウィンドウを表示</mark>：オフの場合、タイムアウト後に会話をすぐリセットします。オンの場合、先に「会話がタイムアウトしました。新しい会話を開始してください」という通知を表示し、ユーザーが<mark style="color:blue;">新しい会話を開始</mark>を押してから新たな会話が始まります。設定ページには<mark style="color:blue;">通知ウィンドウのプレビュー</mark>があり、実際の色はテーマカラーに従います

{% hint style="info" %}
アイドル時間は実質的な会話についてのみ計測します。「こんにちは」などのあいさつだけではタイマーは開始せず、具体的な質問を始めてから計測します。ユーザーが途中で離れて戻ってきた場合も、アイドル時間を超えていなければ同じ会話を続けられます。
{% endhint %}

## 6. 満足度アンケート設定 <a href="#satisfaction-survey" id="satisfaction-survey"></a>

<mark style="color:blue;">満足度アンケートを有効にする</mark>をオンにすると、会話に一定時間操作がない場合、満足度アンケートが自動的に表示されます。ユーザーは1〜5点（不満、やや不満、普通、やや満足、満足）で評価し、コメントを残したり、スキップしたりできます。次の項目を設定できます。

* <mark style="color:blue;">待機時間（分）</mark>：会話に操作がなくなってからアンケートを表示するまでの時間です
* <mark style="color:blue;">アンケートのタイトル</mark>：空欄の場合は、デフォルトの「今回の会話全体にどの程度満足していますか？」をユーザーの言語に合わせて表示します
* <mark style="color:blue;">アンケートのプレビュー</mark>：アンケートの見た目をリアルタイムで確認できます

## 7. クォータを使い切った際のメッセージ <a href="#quota-exhausted-message" id="quota-exhausted-message"></a>

このプラットフォームのCreditsクォータを使い切った場合や、有効なクォータがない場合、ユーザーがメッセージを送信すると、無応答になる代わりにここで設定した案内が返されます。<mark style="color:blue;">デフォルトのメッセージ</mark>に、例えば「本サービスは現在利用上限に達しています。しばらくしてから再度お試しいただくか、カスタマーサポートへお問い合わせください」と入力します。<mark style="color:blue;">言語別のメッセージ</mark>の横にある<mark style="color:blue;">＋ 追加</mark>で、訪問者の言語ごとに上書きできます。未設定の言語ではデフォルトの文面を使います。クォータをまだ設定していなくても、先にメッセージを保存できます。クォータ自体は設定ページ上部のメインタブ<mark style="color:blue;">クォータ</mark>で設定します。[会話プラットフォームのCreditsクォータ管理](https://docs.maiagent.ai/maiagent-user-guide/ja/others/credits/inbox-credit-quota.md)をご覧ください。

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

### Q：あいさつはAIに送られますか？ <a href="#faq-greeting-to-ai" id="faq-greeting-to-ai"></a>

AIはあいさつ本文を見ることができます。選択肢リストは、<mark style="color:blue;">あいさつの選択肢をAgentのコンテキストに含める</mark>をオンにした場合のみ渡されます。[第4節](#include-greeting-in-context)をご覧ください。

### Q：「前回の会話を再開」をオフにしても、過去の会話は残りますか？ <a href="#faq-history-kept" id="faq-history-kept"></a>

はい。オフにしても、ユーザーがウィンドウを開いた際に前回の会話を再開するかどうかが変わるだけで、管理画面の<mark style="color:blue;">すべての会話</mark>には完全な履歴が残ります。

### Q：LINEプラットフォームでもあいさつを設定できますか？ <a href="#faq-line" id="faq-line"></a>

インタラクション設定はWebおよび内部プラットフォームでのみ利用できます。LINEのあいさつメッセージは、LINE公式アカウントの管理画面で設定してください。


---

# 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/conversation-settings/platform-settings/interaction-settings.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.
