> 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.md).

# Web Chat の概要

Web Chat のインタラクション機能とインターフェースのカスタマイズを紹介し、企業のブランドに合った Web Chat サービスの構築を支援します

このページの内容：[1. Web Chat とは？](#what-is-webchat)｜[2. 企業ブランドに合った Web Chat サービスの構築](#branding)｜[3. メッセージのカスタマイズ](#messages)｜[生成中の応答を停止する](#stop-generating)｜[4. 多様な Q\&A コンテンツ](#multimodal-qa)｜[5. 会話履歴の記憶と共有](#memory-and-sharing)｜[6. 使用ツールと引用ドキュメント一覧の表示設定](#display-tools-and-citations)｜[7. 会話のアクセス権限保護 - 安全で管理可能な会話環境](#access-control)｜[8. データ収集（Pre-chat フォーム）](#pre-chat-form)｜[接続に失敗した場合の対処方法](#connection-failure)｜[応答生成中に前のメッセージを確認する](#review-during-generation)

## <mark style="color:blue;">1. Web Chat とは？</mark> <a href="#what-is-webchat" id="what-is-webchat"></a>

MaiAgent で作成した Agent をウェブサイトに埋め込み、リアルタイムのカスタマーサポートやその他の会話に利用できます。Web Chat は**レスポンシブデザインを採用しており、パソコン、タブレット、スマートフォンに適切に対応します。**

現在、MaiAgent では次の 3 つの埋め込み方法を提供しています。

### 1. ウェブサイトの右下に埋め込む <a href="#embed-widget" id="embed-widget"></a>

* 公式サイトに埋め込み、サイトに組み込まれたインテリジェントアシスタントとして利用できます
* 通常の閲覧を妨げず、必要なときにいつでも利用できます
* 一般的なカスタマーサポートやお問い合わせ対応に適しています

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-3880f664a77d58888b950e5e5612652da2b1fbcc%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-08-15%20125237.png?alt=media" alt=""><figcaption><p>右下への埋め込み（ウィンドウをドラッグして移動できます）</p></figcaption></figure>

### 2. 全画面で埋め込む <a href="#embed-fullscreen" id="embed-fullscreen"></a>

* 充実した会話体験を提供します
* 複雑なお問い合わせやサービスフローに適しています
* 企業のニーズに合わせてデザインをカスタマイズできます

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-84b25bce62e614b0545b739650995c0f8fc43225%2Fimage%20(116).png?alt=media" alt=""><figcaption><p>全画面埋め込みの例</p></figcaption></figure>

### 3. MaiGPT ウィンドウモードで埋め込む <a href="#embed-maigpt" id="embed-maigpt"></a>

* ChatGPT スタイルの会話インターフェース（左側の会話履歴一覧 + 右側のメイン会話エリア）を、ページのメイン UI として直接埋め込めます
* 指定したコンテナ内に常時表示するか、右下のフローティングボタンをクリックして全画面表示できます
* AI ポータル、社内ナレッジポータル、製品のメイン会話インターフェースに適しています

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-40da32c6e68a4607ef47a4430950a10cbb1765b5%2Fmaigpt-embed-overview.png?alt=media" alt="MaiGPT ウィンドウモードの埋め込み"><figcaption><p>MaiGPT ウィンドウモード：ChatGPT スタイルの会話インターフェース</p></figcaption></figure>

{% hint style="info" %}
MaiGPT ウィンドウモードは、会話プラットフォーム設定の「<mark style="color:blue;">埋め込み</mark>」ウィンドウで選択できます。詳しい設定手順は [MaiGPT ウィンドウモードの埋め込み](https://docs.maiagent.ai/maiagent-user-guide/ja/build/choose-channel/web-chat/maigpt-embed.md)をご覧ください。
{% endhint %}

### 訪問者が切り替えられるウィンドウモード <a href="#visitor-window-modes" id="visitor-window-modes"></a>

右下に埋め込むウィンドウでは、デフォルトの <mark style="color:blue;">フローティングウィンドウ</mark> に加えて、<mark style="color:blue;">サイドバー</mark> モードも利用可能にできます。会話ウィンドウをページの右端に寄せて高さ全体に表示するため、ページを見ながら質問するのに適しています。ウェブサイトのエンジニアが埋め込みコードで両方のモードを有効にすると、パソコンの訪問者のタイトルバーに <mark style="color:blue;">ウィンドウモードを切り替え</mark> ボタンが表示され、クリックするだけで切り替えられます。サイドバーモードには、一時的に折りたたむための <mark style="color:blue;">折りたたむ</mark> ボタンもあります。このほか、ページ内の特定の領域に会話を直接配置する inline モードや、フローティングボタンを表示しないモードもあり、いずれも埋め込みコードで設定します。技術者向けマニュアルの [Web Chat の埋め込みと SDK：ウィンドウモード](https://docs.maiagent.ai/tech/serve/web-chat-sdk#window-modes)をご覧ください。

この設計には、次の利点があります。

* **即時性**：訪問者は待つことなく専門的な回答を得られ、ユーザー体験が向上します
* **利便性**：右下のフローティング表示は通常の閲覧を妨げず、必要なときにいつでも利用できます
* **費用対効果**：Agent が 24 時間 365 日対応し、人件費を大幅に削減します
* **プロフェッショナルな印象**：企業の技術力とサービス品質を示せます

## <mark style="color:blue;">2. 企業ブランドに合った Web Chat サービスの構築</mark> <a href="#branding" id="branding"></a>

MaiAgent では、ロゴ、アバター、Q\&A のテーマカラーなどをカスタマイズでき、企業ブランドに合った Web Chat サービスを構築できます

次の設定が可能です。

1. Agent の表示名を選択します
2. 企業のロゴをアップロードします
3. Agent の表示アバターを選択します
4. Web Chat のテーマカラーを選択します
5. Agent の応答メッセージの背景色を選択します

これらの機能で、独自の Web Chat の外観を作成できます。

<div><figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-98048f7b5e57344d70831936ed727a91a00604c0%2Fimage%20(118).png?alt=media" alt=""><figcaption><p>デフォルトのスタイル</p></figcaption></figure> <figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-256f1d936b5145c36cf8f1106d1f9dbd1fbd9103%2Fimage%20(119)%20(1).png?alt=media" alt=""><figcaption><p>カスタマイズしたスタイル</p></figcaption></figure></div>

このように、企業のブランドカラーやスタイルに合った Web Chat サービスを構築できます

Web Chat では、会話の入力エリアの下にプラットフォームのブランドロゴを表示します。ログイン、登録、読み込み画面でもブランド画像を一定の縦横比で表示し、つぶれたり引き伸ばされたりしません。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-08a452dcf190d99fb18802f136241351607d360a%2Fwebchat-brand-footer.png?alt=media" alt="Web Chat の入力エリアの下に Powered by と MaiAgent のブランドロゴを表示"><figcaption><p>Web Chat 下部のブランドロゴは鮮明さと縦横比を保って表示されます</p></figcaption></figure>

### ダークモードの最適化 <a href="#dark-mode" id="dark-mode"></a>

MaiAgent の Web Chat は、より快適に表示できるようダークモードを全面的に最適化しています。

**動的な色の調整**

* テーマカラーの明るさを自動調整し、暗い背景でも見やすくします
* テキストのコントラストを適切に調整し、読みやすさを保ちます
* アイコンやボタンの色を最適化し、ダークモードでも見分けやすくします

**コントラストの最適化**

* メッセージの吹き出しの背景色を工夫し、目の疲れを抑えます
* リンクや重要な情報にはコントラストの高い色を使い、明確に識別できるようにします
* 入力欄とボタンの枠線の色を最適化し、操作しやすくします

**スムーズな切り替え**

* ユーザーはいつでもライトモードとダークモードを切り替えられます
* 切り替えても会話内容と操作状態を保持します
* システムがユーザーのテーマ設定を記憶します

ダークモードは、特に次のような場合に適しています。

* 夜間や暗い環境で利用する場合
* 長時間の会話で目の疲れを軽減したい場合
* 企業ブランドに合うダーク系のデザインを採用する場合

## <mark style="color:blue;">3. メッセージのカスタマイズ</mark> <a href="#messages" id="messages"></a>

Web Chat に初めてアクセスしたときに表示する Agent の挨拶を、以下のような場面に合わせて自由に設定できます。挨拶は AI が生成する内容ではなく固定の文面なので、高評価／低評価のフィードバックボタンは表示されず、[利用分析](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent/usage.md#user-satisfaction-rate)のユーザー満足度にも含まれません。

### **1. 挨拶のカスタマイズ** <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-b21ad3d1aa1d753ca4a0e9b2b73af621c62e8e8c%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-08-15%20152318.png?alt=media" alt=""><figcaption><p>カスタマイズした挨拶</p></figcaption></figure>

### 2. 会話を始めるための質問 <a href="#starter-questions" id="starter-questions"></a>

* 「<mark style="color:blue;">会話開始時の質問</mark>」をクイック選択肢として設定します
* ユーザーは入力せずに、よくある質問を直接クリックできます
* **質問の例**：
  * 「注文した商品を確認するには？」
  * 「注文するには？」
  * 「会員ポイントのルール」
  * 「営業時間」

ユーザーは開始時の質問をクリックして会話を始め、すばやく回答を得られます。

<div><figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-ba6c8e8005961ff727708c56c2df863893c7e59b%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-08-15%20153127.png?alt=media" alt=""><figcaption><p>開始時の質問の設定例</p></figcaption></figure> <figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-c2847c1a6f8cdbfe8c6066e8d85089987d336d56%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-08-15%20153719.png?alt=media" alt=""><figcaption><p>ユーザーがクリックして会話を開始します</p></figcaption></figure></div>

## 生成中の応答を停止する <a href="#stop-generating" id="stop-generating"></a>

質問を送信した後に内容の誤りに気づいても、Agent が応答全体を生成し終わるまで待つ必要はありません。応答の生成中は、入力欄の右側にある送信ボタンが四角い<mark style="color:blue;">停止</mark>ボタンに変わります。クリックすると今回の応答を停止でき、修正した質問を入力できます。

たとえば、カスタマーサポート担当者が Agent に年間の製品発表会の企画を依頼した後で、イベント予算を伝え忘れたことに気づいたとします。Agent が応答を生成している間に<mark style="color:blue;">停止</mark>をクリックし、予算と参加人数を追加して質問し直せば、要望に合わない内容が生成され終わるのを待たずに済みます。

### 応答を停止する <a href="#stop-current-response" id="stop-current-response"></a>

{% stepper %}
{% step %}

### 1. 停止ボタンを確認する <a href="#find-stop-button" id="find-stop-button"></a>

質問を送信し、Agent が応答の生成を開始するまで待ちます。入力欄の右側に四角い<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-5b470980c305488984de0c77295cf0ef2ae6f57f%2Fwebchat-stop-response.png?alt=media" alt="Web Chat が応答を生成している間、入力欄の右側に四角い停止ボタンを表示"><figcaption><p>応答の生成中は、入力欄の右側にある停止ボタンをクリックできます</p></figcaption></figure>
{% endstep %}

{% step %}

### 2. 停止して質問し直す <a href="#stop-and-ask-again" id="stop-and-ask-again"></a>

<mark style="color:blue;">停止</mark>をクリックします。停止した応答の下に「応答が中断されました」と表示され、入力欄の右側はすぐに送信ボタンに戻ります。修正した質問を入力して再送信できます。
{% endstep %}
{% endstepper %}

{% hint style="info" %}
停止するのは現在生成中の応答だけです。送信済みの質問や、それ以前の会話履歴は削除されません。
{% endhint %}

### キーボードで停止する：Esc を押す <a href="#stop-with-esc" id="stop-with-esc"></a>

パソコンでは、入力欄にカーソルがある状態で Esc キーを押すと、マウスを動かさずに<mark style="color:blue;">停止</mark>をクリックした場合と同じ操作ができます。応答を生成していないときに Esc を押しても何も起こらず、入力途中のテキストもそのまま保持されます。

### 応答中にメッセージを追加する：メッセージキュー <a href="#message-queue" id="message-queue"></a>

Agent が応答している間も、パソコンの訪問者は入力を続けて Enter キーでメッセージを送信できます。これらのメッセージはすぐに Agent に送られず、入力欄の上にある「応答が完了したら順番に送信します（N 件）」の一覧に入り、現在の応答が終了すると自動で順番に送信されます。応答中は入力欄の右側が<mark style="color:blue;">停止</mark>ボタンになるため、キューへの追加には Enter キーを使います。キュー内のメッセージには、次の操作ができます。

* クリックして入力欄に戻し、編集して再送信できます
* 右側の <mark style="color:blue;">削除</mark> をクリックして取り消せます
* キューが上限に達すると「キューに追加できるメッセージは最大 N 件です。応答の完了をお待ちください」と表示されます

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-697fc31a977d189aef4631a049501e43b61e988d%2Fwebchat-message-queue.png?alt=media" alt="入力欄の上に「応答が完了したら順番に送信します（1 件）」とキュー内のメッセージ 1 件を表示し、その右側に削除ボタン、入力欄の右側に停止ボタンを表示"><figcaption><p>応答中に Enter キーで送信したメッセージは入力欄の上で待機します</p></figcaption></figure>

すぐに新しい質問を Agent に処理してほしい場合は、先に<mark style="color:blue;">停止</mark>または Esc を押してから送信します。停止時にすでにキューに入っていたメッセージは保持され、中断した応答の終了処理が済むと（最大約 10 秒）、自動で送信されます。

たとえば、訪問者が公式サイトの Web Chat でプラットフォームの全機能を詳しく説明するよう Agent に依頼し、応答の途中で箇条書きに変えたいと思ったとします。入力欄に「補足ですが、箇条書きで整理してください。」と入力して Enter を押すと、まずキューに追加されます。続いて Esc を押して長い応答を停止すると、画面に「応答が中断されました」と表示されます。少し待つとキュー内のメッセージが自動送信され、Agent がその新しいメッセージに応答します。

{% hint style="warning" %}
次の場合はキューに追加されません。

* **添付ファイル付きのメッセージ**：応答中にファイルを添付して送信しようとすると「AI が応答中です」と表示され、テキストとファイルは入力欄に残ります。応答が終了してから送信してください。<mark style="color:blue;">停止</mark>を押した場合も、中断した応答の終了処理が済むまで少し待つ必要があります（最大約 10 秒）。
* **スマートフォンとタブレット**：入力欄の Enter は改行です。応答中は右側に<mark style="color:blue;">停止</mark>ボタンだけが表示されるため、応答を停止するか終了するまで待ってから、次のメッセージを送信してください。
  {% endhint %}

## <mark style="color:blue;">4. 多様な Q\&A コンテンツ</mark> <a href="#multimodal-qa" id="multimodal-qa"></a>

### 1. 多言語サポート <a href="#multi-language" id="multi-language"></a>

ユーザーの言語で応答し、コミュニケーションの壁を取り除きます。

* **自動検出**：ユーザーが言語を選択していない場合、Agent は質問の言語で応答します

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-6ddc78047a3aef2815f71e26c3d498588224141c%2Fimage%20(127).png?alt=media" alt="言語を選択していない状態で、ユーザーが英語、簡体字中国語、繁体字中国語で挨拶すると、Agent はそれぞれの言語で応答します"><figcaption><p>言語を選択していない場合、Agent は質問の言語で応答します</p></figcaption></figure>

**インターフェース言語の切り替え**：

1. 訪問者は Web Chat の言語メニューで言語を選択します（まだメッセージを送信していない場合は新しい言語で会話を開始し直します。送信済みの場合は同じ会話にとどまり、以降の応答に新しい言語を使用します）。[多言語サポート：Web Chat の言語設定](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent/multi-language-support.md#web-chat-language-settings)をご覧ください。
2. Web Chat の初期化スクリプト（javascript）で `locale` を使い、インターフェース言語と Agent の応答言語を指定します。[技術者向けマニュアル—Web Chat の埋め込みと SDK（`locale` 設定）](https://docs.maiagent.ai/tech/serve/web-chat-sdk#config-basic)をご覧ください。

訪問者が言語を選択するか、埋め込み先のページが言語を指定すると、プラットフォームは Agent にその言語で回答するよう指示します。ただし、ユーザーがメッセージ内で明示的に別の言語を求めた場合は、その指示に従います。インターフェース言語をブラウザーから推測している場合に限り、Agent は通常、質問の言語で回答します。詳しくは[多言語サポート：AI の応答言語の決まり方](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent/multi-language-support.md#reply-language)をご覧ください。

{% hint style="info" %}
対応言語の一覧は、[多言語サポート：対応言語一覧](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent/multi-language-support.md#supported-language-list)をご覧ください
{% endhint %}

### 音声入力と音声再生 <a href="#voice-input-and-playback" id="voice-input-and-playback"></a>

Agent の音声サービスを有効にすると、訪問者側の Web Chat に次の 3 つの機能が追加されます。

| 場所                                                  | 機能                                                                                                                                                                                                                                                                                                            |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 入力欄の左側にある <mark style="color:blue;">マイク</mark> アイコン | **音声入力**：クリックすると話し始められ、画面に「聞き取り中」と表示されます。話し終えると認識結果が自動でメッセージとして送信されます                                                                                                                                                                                                                                         |
| 設定メニューの <mark style="color:blue;">音声</mark>         | 音声認識の言語とプロバイダーを選択します。<mark style="color:blue;">Microsoft Azure</mark>（台湾の標準中国語、簡体字中国語、英語、日本語、韓国語、タイ語、ベトナム語、インドネシア語、マレー語、フィリピン語、ビルマ語、クメール語、ラオ語、シンガポール英語）、<mark style="color:blue;">Bronci</mark>（台湾語）、<mark style="color:blue;">内蔵</mark>（台湾の標準中国語、英語。ブラウザーの音声認識を使用）から選択できます。正確に認識するには、訪問者が話す言語と認識言語を一致させてください |
| 設定メニューの <mark style="color:blue;">音声再生</mark>       | 有効にすると Agent の応答を自動で読み上げます。無効にするとテキストだけを表示します。デフォルトは有効です                                                                                                                                                                                                                                                      |

パソコンでは、タイトルバーの設定バーから設定メニューを利用できます。スマートフォンでは、右上の <mark style="color:blue;">⋮</mark> から開きます。

{% hint style="info" %}
ここでの音声入力は「一文を話し、テキストに変換して送信する」機能です。Agent で[音声アシスタント](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent/voice-agent.md)を有効にすると、入力欄の横に <mark style="color:blue;">ヘッドホン</mark> アイコンも表示され、リアルタイムの音声通話を開始できます。[音声アシスタント：ユーザー側の使い方](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent/voice-agent.md#how-users-talk)をご覧ください。
{% endhint %}

### 2. マルチモーダル Q\&A <a href="#multimodal" id="multimodal"></a>

テキストによる Q\&A に加えて、Agent は次のようなファイル形式のアップロードにも対応できます。

* スプレッドシート：.xls, .xlsx, .csv, .ods
* ワープロ文書：.doc, .docx, .odt, .pdf, .md, .txt
* プレゼンテーション：.ppt, .pptx, .odp
* ウェブ文書：.html, .htm
* データ形式：.json, .jsonl
* 音声ファイル：.wav, .mp3, .m4a, .aac
* 動画ファイル：.mp4
* CAD テンプレートファイル：.dxf（Agent モードで Code Interpreter を有効にした Agent のみ対応します。[Code Interpreter](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent/code-interpreter.md#faq-dxf)をご覧ください）

{% hint style="info" %}
会話の安全性を保つため、ユーザーによる添付ファイルのアップロードを許可せず、テキストのみで会話するように設定できます。
{% endhint %}

#### 画像コンテンツの処理

**画像の認識と分析**

* **アップロードした画像の分析**：ユーザーが製品画像をアップロードすると、AI が自動で認識し、関連情報を提供します
* **スクリーンショットの処理**：スクリーンショットを分析し、使い方に関する問題の解決を支援します
* **画像の説明**：画像の内容説明や関連する提案を自動生成します

**画像による応答機能**

* **製品画像の表示**：応答に実際の製品画像を含めます
* **操作ガイド画像**：手順に沿った操作画面のスクリーンショットを提供します

例：

1. ユーザーが MaiAgent の Agent をどこで設定するか質問すると、Agent が設定画面の画像で回答します
2. ユーザーがスクリーンショットを送ってパスが正しいか確認すると、Agent が内容を正しく解析して回答します

<div><figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-71263c2534efc1ba8bb19b493e761d88f0ef2c5f%2Fimage%20(122).png?alt=media" alt=""><figcaption><p>Agent が画像で回答します</p></figcaption></figure> <figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-c71336dcd8110e7f04f15a551ff3d4b3fd2dbdb1%2Fimage%20(123).png?alt=media" alt=""><figcaption><p>Agent がユーザーのスクリーンショットを解析します</p></figcaption></figure></div>

#### ドキュメント処理機能

**対応するドキュメント形式**

* **PDF ドキュメント**：PDF の内容を自動で解析し、関連する質問に回答します
* **Word ドキュメント**：.doc/.docx 形式のドキュメントを処理します
* **Excel スプレッドシート**：表のデータを分析し、知見を提供します
* **PowerPoint プレゼンテーション**：内容を抽出し、質問に回答します
* **メールファイル**：Outlook の .msg と .eml メールを処理し、メールの情報、本文、添付ドキュメントを読み取ります

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-fb182a0ccc7d4f5fd35c125480e6582808f3dfda%2Fwebchat-email-attachments.png?alt=media" alt="Web Chat がアップロードされた EML メールを読み取り、PDF と CSV の検査結果、送信者、日付について回答します"><figcaption><p>訪問者は添付ファイルの入口からメールをアップロードし、メールと添付ドキュメントの内容について質問できます</p></figcaption></figure>

**ドキュメントとのやり取り**

* **ドキュメント内容の照会**：アップロードしたドキュメントに基づいて具体的な質問に回答します
* **データ分析**：表形式のデータを自動分析し、統計情報を表で提供します
* **ドキュメントの要約**：長いドキュメントの重要な内容を要約します

***

例 1：Agent に情報を表形式で整理し、参考資料へのリンクを付けるよう依頼します

<div><figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-b31d4a6935949e33bd1007689bb0fba9782f730f%2Fimage%20(132).png?alt=media" alt=""><figcaption><p>情報を表形式で整理します</p></figcaption></figure> <figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-f7cd38de66136fd5b12b73f4f143fff7ae00aa30%2Fimage%20(133).png?alt=media" alt=""><figcaption><p>外部リンクを提供します</p></figcaption></figure></div>

例 2：Agent に売上内容を分析し、表形式で説明するよう依頼します

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-150fb2de65a75b631b5dcb1721f03e2c73ae297d%2Fimage%20(131).png?alt=media" alt=""><figcaption></figcaption></figure>

例 3：docx ファイルをアップロードし、履歴書の書き方の問題点を分析するよう Agent に依頼します

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-4354e35d4f0e524745e7859982782380ca89d980%2Fimage%20(134).png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Agent は常に Markdown 形式で回答し、応答内容をわかりやすく整理します。
{% endhint %}

**Agent が提供するファイル**：Agent が Code Interpreter でファイルを生成してユーザーに提供すると、Web Chat は応答内にファイルカード（ファイル名、種類、ダウンロードボタン）を表示します。カードをクリックすると、その場でプレビューできます。Agent Teams のサブ Agent が生成したファイルも同じ形式で表示されます。

## <mark style="color:blue;">5. 会話履歴の記憶と共有</mark> <a href="#memory-and-sharing" id="memory-and-sharing"></a>

### **1. 会話履歴の記憶** <a href="#chat-history" id="chat-history"></a>

継続的なサービスを提供するため、Web Chat はユーザーの会話履歴を自動で記憶し、過去のやり取りを踏まえて次の会話を進められるようにします。

**記憶する内容の範囲**

* **会話内容**：テキスト、画像、ドキュメントなどを含む Q\&A の全記録です
* **サービスの状態**：未完了の問い合わせや、対応待ちの問題です

「会話履歴を表示」を有効にすると（[インタラクション設定](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/platform-settings/interaction-settings.md#conversation-display)をご覧ください）、タイトルバーの左側に <mark style="color:blue;">時計</mark> アイコンが表示されます。クリックすると会話履歴のサイドバーが開きます。

<div><figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-516cd7f27f014ac3d1ccd66d011d495c1db67266%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-08-15%20171142.png?alt=media" alt=""><figcaption></figcaption></figure> <figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-e794f1deb35a654a2724917cd732fa298ed7ccb9%2Fimage%20(135).png?alt=media" alt=""><figcaption></figcaption></figure></div>

| 場所                                              | 機能                                                                                                                                                                                                                                                                                                                                                  |
| ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| サイドバー上部の <mark style="color:blue;">会話を検索</mark> | 検索パネルを開き、キーワードを入力して会話をリアルタイムで絞り込みます。パネル内の <mark style="color:blue;">新しい会話</mark> を直接クリックすることもできます                                                                                                                                                                                                                                                   |
| サイドバー上部の <mark style="color:blue;">新しい会話</mark> | 新しい会話を開始します                                                                                                                                                                                                                                                                                                                                         |
| サイドバー上部の <mark style="color:blue;">会話を編集</mark> | ログイン済みの訪問者だけに表示されます。複数の会話を選択して一括削除できます。下記の[複数の会話を一括削除する](#history-batch-delete)をご覧ください                                                                                                                                                                                                                                                              |
| 会話一覧                                            | <mark style="color:blue;">今日</mark>／<mark style="color:blue;">昨日</mark>／<mark style="color:blue;">過去 7 日間</mark>／<mark style="color:blue;">過去 30 日間</mark>／<mark style="color:blue;">それ以前</mark> に自動で分類されます。[会話の引き継ぎ](https://docs.maiagent.ai/maiagent-user-guide/ja/work/maigpt/chat/conversation-handoff.md)を利用した会話には「引き継ぎ先」または「元の会話から継続」と表示されます |
| 各会話の <mark style="color:blue;">⋯</mark>         | <mark style="color:blue;">名前を変更</mark>（タイトルの変更）、<mark style="color:blue;">削除</mark>（確認後に削除し、元に戻せません）を選択できます。プラットフォームで会話共有が有効な場合は <mark style="color:blue;">共有</mark> も表示されます。下記の[会話の共有](#chat-sharing)をご覧ください                                                                                                                                       |

会話履歴が無効な場合、時計アイコンの代わりに <mark style="color:blue;">新しい会話</mark> アイコンが表示されます。訪問者は新しい会話を開始することだけができ、過去の記録は表示できません。

#### 複数の会話を一括削除する <a href="#history-batch-delete" id="history-batch-delete"></a>

会話プラットフォームでログイン機能が有効な場合（[ウェブサイト：ログイン設定](https://docs.maiagent.ai/maiagent-user-guide/ja/build/choose-channel/web-chat/website.md#login-settings)をご覧ください）、ログイン済みの訪問者は会話履歴のサイドバーで自分の会話を複数選択して、一括削除できます。ログインしていない訪問者にはこの入口は表示されませんが、各会話の <mark style="color:blue;">⋯</mark> から 1 件ずつ削除できます。

たとえば、オンラインストアの会員がカスタマーサポートの Web Chat で、注文の発送、返品書類、請求書の宛名の 3 件を質問したとします。すべて解決した後、2 件を削除し、注文についての会話だけを確認用に残したいと考えました。会話履歴のサイドバーを開いて <mark style="color:blue;">会話を編集</mark> を押し、ほかの 2 件を選択して <mark style="color:blue;">削除</mark> を押します。確認すると、サイドバーには注文の会話だけが残ります。削除した会話のうち 1 件が開いていたため、画面も自動で新しい会話に切り替わります。

1. タイトルバー左側の <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> を押すと、サイドバーに現在読み込まれている会話を 1 回につき最大 100 件まで選択できます。もう一度押すと全選択を解除します。一覧の上には「N 件選択済み」と表示されます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-67fcd800c92fa8d2619c5611e3e41c9151c11ab4%2Fweb-chat-history-batch-select.png?alt=media" alt="編集モードの Web Chat 会話履歴サイドバーで、3 件中 2 件を選択し、上部にすべて選択、2 件選択済み、赤い削除ボタンを表示"><figcaption><p>削除する会話を選択すると、一覧の上に選択件数が表示されます。</p></figcaption></figure>

3. <mark style="color:blue;">削除</mark> を押すと、確認ダイアログに「N 件の会話を削除しますか？」と表示されます。件数を確認して <mark style="color:blue;">削除</mark> を押します。すべて成功すると「N 件の会話を削除しました」と表示され、編集モードを終了します。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-591662080b4c39ecc5d9866a7e92be769b976202%2Fweb-chat-history-batch-delete-confirm.png?alt=media" alt="「2 件の会話を削除しますか？」というタイトルの確認ダイアログに、会話内のすべてのメッセージも削除され、元に戻せないことを表示し、下部にキャンセルと削除ボタンを表示"><figcaption><p>確認ダイアログには、今回削除する会話の件数が表示されます。</p></figcaption></figure>

{% hint style="warning" %}
会話内のすべてのメッセージも削除されます。画面から元に戻すことはできません。
{% endhint %}

* 削除した会話に現在開いている会話が含まれる場合、画面は自動的に新しい会話に切り替わります。
* 一部の会話を削除できなかった場合（別のタブですでに削除されていた場合など）は、「N 件を削除しました。M 件の削除に失敗しました」と表示されます。削除できた会話は一覧から消え、失敗した会話は選択されたまま残ります。編集モードが維持されるので、再度 <mark style="color:blue;">削除</mark> を押して再試行するか、<mark style="color:blue;">完了</mark> を押して終了できます。一括削除のリクエスト全体を送信できなかった場合（ネットワークが切断された場合など）は、「削除に失敗しました。しばらくしてからもう一度お試しください」と表示され、一覧と選択状態は変わりません。
* 削除をやめる場合は、<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-fc25fd8d962b878f53f7002f6eaea49f828d5612%2Fweb-chat-history-batch-partial-failed.png?alt=media" alt="一部の削除に失敗した後も履歴サイドバーは編集モードのままで、削除できなかった会話 1 件だけが選択状態で残り、上部には 1 件選択中と表示されています"><figcaption><p>削除できなかった会話は一覧に残り、選択状態が維持されます。</p></figcaption></figure>

会話の記憶機能は、次のような場面で利用できます。

* **継続的な相談**：ユーザーが「前回おすすめしてくれたテントのモデルは何でしたか？」と尋ねると、AI がすぐに思い出して回答します
* **進捗の確認**：ユーザーが「前回の注文に関する問い合わせを続けて」と伝えると、AI が関連情報を自動的に呼び出します
* **パーソナライズされたサービス**：会話履歴に基づき、より的確なおすすめやアドバイスを提供します

{% hint style="info" %}
同じ会話が長くなりすぎた場合は、「会話の引き継ぎ」を有効にすると、訪問者が Agent に引き継ぎ用の要約を作成してもらい、新しい会話で続きを話せます。Web Chat での有効化と制限については、[会話の引き継ぎ：Web Chat で有効にする](https://docs.maiagent.ai/maiagent-user-guide/ja/work/maigpt/chat/conversation-handoff.md#enable-on-web-chat)をご覧ください。API で継続用の会話を作成する場合は、技術マニュアルの[会話の引き継ぎと継続用会話 API](https://docs.maiagent.ai/tech/serve/conversation-handoff-continuation)をご覧ください。
{% endhint %}

### **2. 会話の共有** <a href="#chat-sharing" id="chat-sharing"></a>

Agent への相談内容を友人や同僚に共有したい場合や、社内チームで顧客の問題について協議する場合は、MaiAgent で会話の共有リンクを作成できます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-5a43d6523e30f0539424a2d220e71f053420d7df%2Fimage%20(136).png?alt=media" alt=""><figcaption></figcaption></figure>

会話ウィンドウ右上の <mark style="color:blue;">共有</mark> をクリックし、「会話を共有する公開リンク」ウィンドウで <mark style="color:blue;">リンクをコピー</mark> を押すと、相手に送信できます。履歴サイドバーの各会話にある <mark style="color:blue;">⋯</mark> → <mark style="color:blue;">共有</mark> からも同じ種類のリンクを取得できます。

**リンクを受け取った人に表示される内容**

* その会話の現在までのすべてのメッセージ（テキスト、画像、添付ファイルを含みます）が表示される、読み取り専用の会話ページです
* ログインせずに開けるため、閲覧してよい相手にだけ共有してください
* 閲覧のみ可能で、このページから続きを入力することはできません。質問を続ける場合は、元の Web Chat に戻って会話を開いてください

{% hint style="info" %}
共有リンクに表示されるのは会話履歴そのものだけです。別途要約を生成したり、関連リソースを整理したりすることはありません。
{% endhint %}

会話履歴の共有は、次のような場面で利用できます。

* **顧客による共有**：「このキャンプ用品のおすすめはいいですね。登山サークルに共有します」
* **社内での協力**：カスタマーサポート担当者が複雑な問題を技術サポートチームに共有します
* **研修での利用**：代表的な会話事例を従業員の研修教材として共有します

### **3. 会話のタイムアウト管理** <a href="#chat-timeout" id="chat-timeout"></a>

会話の品質とシステム性能を維持するため、Web Chat にはインテリジェントな会話タイムアウト管理機能があります。

**インテリジェントなフィルタリング**

* **あいさつメッセージの自動除外**：会話の冒頭のあいさつを識別して除外し、タイムアウトの計算に含めません
* **メッセージ数の正確なリセット**：会話を再開すると、メッセージカウンターが正しくリセットされます
* **タイムアウト判定の最適化**：実質的な会話内容のみを対象にタイムアウトを計算し、より正確に会話を管理します

**会話の継続性の確保**

* 通常の会話中に意図せずタイムアウトしないようにします
* 長く考えたり一時中断したりした後でも会話を続けられます
* システムが会話の継続状況を適切に判断します

**実際の動作**

1. **会話の開始**：ユーザーが「こんにちは」などのあいさつを送信しても、タイムアウトの計算には含まれません
2. **本題に入る**：ユーザーが具体的な質問を始めると、タイムアウトのタイマーが開始します
3. **会話の一時中断**：ユーザーが一時的に離れた場合も、システムは会話の状態を維持します
4. **再開**：ユーザーが戻って会話を続けると、メッセージ数が正しく更新されます

この改善により、会話がよりスムーズで自然になり、考える時間が長くなって会話が途切れる心配がなくなります。

### **4. メッセージの操作：編集、フィードバック、分岐** <a href="#message-actions" id="message-actions"></a>

メッセージにカーソルを合わせると操作アイコンが表示されます。操作方法は MaiGPT と同じです。詳しくは [MaiGPT：メッセージの操作](https://docs.maiagent.ai/maiagent-user-guide/ja/work/maigpt/chat.md#message-actions)をご覧ください。Web Chat で異なるのは、**どの訪問者に表示されるか**です。

| 操作                                                                                                                       | 利用できる人                                             | 説明                                                                                                                                                                                                                                                                                               |
| ------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| AI の返信にある <mark style="color:blue;">コピー</mark>、<mark style="color:blue;">高評価</mark>、<mark style="color:blue;">低評価</mark> | すべての訪問者                                            | 低評価を押すと「フィードバックを送信」ウィンドウが開き、理由を選択し、追加の意見を入力して送信できます。フィードバックは管理画面の[会話ビューアー](https://docs.maiagent.ai/maiagent-user-guide/ja/serve/daily-operations/reply/conversation-viewer.md)と[利用分析](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent/usage.md#user-satisfaction-rate)の満足度統計に反映されます |
| 自分のメッセージにある <mark style="color:blue;">メッセージを編集</mark> とバージョン切り替え <mark style="color:blue;">‹ N / M ›</mark>              | ログイン済みの訪問者（プラットフォームで[ログイン機能](#login-config)が有効な場合） | 編集するとそれ以降の会話が削除され、Agent が再度返信します。内容に変更がない場合は送信できません                                                                                                                                                                                                                                              |
| AI の返信にある <mark style="color:blue;">会話を分岐</mark>                                                                         | ログイン済みの訪問者                                         | その返信までの内容で別の会話を開始します。元の会話には影響しません                                                                                                                                                                                                                                                                |

### **5. 接続済みのサービス** <a href="#connected-services" id="connected-services"></a>

Agent が訪問者に代わって外部サービスにアクセスする必要がある場合（訪問者自身のアカウントでカレンダーを確認する場合など）、会話内に認可カードを送信します。訪問者が認可したサービスは、タイトルバーの <mark style="color:blue;">接続済みのサービス</mark>（リンクアイコン）からまとめて確認、再認可、接続解除できます。このボタンは、本人の識別が済んでいる訪問者（ログイン済み、または Web サイトから Source ID で識別情報が渡されている訪問者。Pre-chat フォームへの記入だけでは該当しません）にのみ表示されます。また、会話プラットフォームの[接続済みのサービスを表示](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/platform-settings/function-settings.md#show-connected-services)を有効にする必要があります（新規作成したプラットフォームではデフォルトで無効です）。詳しくは[接続済みのサービス](https://docs.maiagent.ai/maiagent-user-guide/ja/build/choose-channel/web-chat/connected-services.md)をご覧ください。

## <mark style="color:blue;">六、使用ツールと引用ドキュメントの一覧の表示設定</mark> <a href="#display-tools-and-citations" id="display-tools-and-citations"></a>

### **1. 使用ツールの一覧を表示** <a href="#show-tools" id="show-tools"></a>

Agent が推論時に使用したツールの一覧をユーザーに表示するかどうかを選択できます。有効にすると、Agent が返信を生成するときに次の画面が表示されます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-397b3d1960642ae0a98c9097422f2fa66f89c543%2Fimage%20(140).png?alt=media" alt=""><figcaption></figcaption></figure>

この一覧で、Agent がツールを正しく使用しているか確認できます。

Agent が呼び出した MCP ツールにインタラクティブなインターフェースがある場合、返信の下に直接操作できるカードも表示されます。[MCP インタラクティブカード（MCP Apps）](https://docs.maiagent.ai/maiagent-user-guide/ja/build/tools/mcp-apps.md)をご覧ください。

### **2. 引用ドキュメントの一覧を表示** <a href="#show-citations" id="show-citations"></a>

AI の各回答には引用ドキュメントの一覧が自動生成され、情報源が明示されます。これにより、回答の信頼性と追跡可能性が向上します。

**表示設定**

企業は、引用ツールの一覧や参照ドキュメントの名前と内容をユーザーに表示するかどうかを設定できます。有効にすると、Agent の回答の下部に次の一覧が表示されます。「引用ノード」をクリックすると、参照したドキュメントの抜粋を確認できます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-380a3f1aadb6212090fd6ed70f0c93d56a2224e9%2Fimage%20(139).png?alt=media" alt=""><figcaption></figcaption></figure>

利用場面に応じて、引用情報を公開するかどうかを選択できます。

* **公開のカスタマーサポート**：すべての引用情報を表示し、信頼につなげます
* **社内サポート**：機密性の高いドキュメントを非表示にし、機密情報を保護します
* **教育機関**：学習リソースを表示し、学生が参照しやすくします

## 返信横のパネル：キャンバスとブラウザー <a href="#side-panels" id="side-panels"></a>

Agent の返信はテキストだけとは限りません。ドキュメント、図表、Web ページ、地図を生成すると、デスクトップ版では会話の右側にパネルが開き、モバイル版では会話画面全体を覆います。パネルを閉じても、メッセージ内には生成結果のカードが残り、後からカードをクリックして再度開けます。この節では、訪問者に表示される 3 種類のパネルを説明します。

### キャンバス（Canvas） <a href="#web-chat-canvas" id="web-chat-canvas"></a>

Agent が Markdown ドキュメント、Mermaid 図、HTML、React のインタラクティブページをキャンバスとして生成すると、キャンバスが自動的に開きます。パネル上部のツールバーには、次のボタンがあります。

| ボタン                                                                                   | 動作                                                                                                                                                                    |
| ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">コードに切り替え</mark>／<mark style="color:blue;">プレビューに切り替え</mark> | レンダリング後の画面と元のコンテンツを切り替えます                                                                                                                                             |
| <mark style="color:blue;">コンソール</mark>、<mark style="color:blue;">コードをリセット</mark>      | React のインタラクティブページにのみ表示されます。実行メッセージを確認したり、Agent が最初に生成したコードに戻したりできます                                                                                                  |
| <mark style="color:blue;">全画面表示</mark>／<mark style="color:blue;">全画面表示を終了</mark>      | キャンバスをウィンドウ全体に拡大します                                                                                                                                                   |
| <mark style="color:blue;">ダウンロード</mark>                                               | <mark style="color:blue;">元のファイルをダウンロード</mark>（種類に応じて .md、.mmd、.html、.jsx）または <mark style="color:blue;">PDF をダウンロード</mark>を選択できます。コンパイル中は「コンパイル完了後にダウンロードできます」と表示されます |
| <mark style="color:blue;">閉じる</mark>                                                  | パネルを折りたたみます。メッセージ内のキャンバスカードから再度開けます                                                                                                                                   |

デスクトップ版では、パネル左端をドラッグして幅を調整できます。キャンバスの用途、適した指示、エクスポートの詳細は MaiGPT と同じです。[Canvas キャンバス](https://docs.maiagent.ai/maiagent-user-guide/ja/work/maigpt/canvas.md)をご覧ください。

### 地図のキャンバス <a href="#map-canvas" id="map-canvas"></a>

Agent が場所や旅行プランに関する質問（レストランのおすすめ、2 泊 3 日の旅行プランなど）に回答するときは、地図のキャンバスを使用する場合があります。左側に Google マップと場所のマーカー、右側（モバイル版では下側）に場所カードの一覧が表示されます。

* **絞り込み**：<mark style="color:blue;">フィルター</mark>のドロップダウンで、<mark style="color:blue;">カテゴリ</mark>（レストラン、カフェ、宿泊施設、観光スポット、ショッピング、自然、交通、その他）、<mark style="color:blue;">条件</mark>（<mark style="color:blue;">営業中のみ</mark>、<mark style="color:blue;">4.5★ 以上</mark>）、<mark style="color:blue;">表示</mark>（評価バッジ、名前ラベル）を指定できます。該当する場所がない場合は、「フィルター条件に一致する場所がありません」と表示されます。
* **複数日の旅行プラン**：日ごとのプランでは、地図の左上に <mark style="color:blue;">すべて</mark>／<mark style="color:blue;">N 日目</mark> の切り替えが表示され、一覧は午前、午後、夜、未定に分けられます。
* **場所の詳細**：場所カードをクリックすると詳細が開きます。<mark style="color:blue;">概要</mark>（場所の紹介、住所、Web サイト、電話番号、営業時間、<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;">Web サイトを開く</mark>、<mark style="color:blue;">Google Maps で開く</mark> があります。詳細情報は Google から取得し、読み込めない場合は「詳細情報を取得できません」と表示されます。

地図のキャンバスで <mark style="color:blue;">コードに切り替え</mark> を押すと場所データの元の内容が表示され、<mark style="color:blue;">元のファイルをダウンロード</mark> を押すと .json 形式で保存されます。

### ブラウザーパネル <a href="#browser-panel" id="browser-panel"></a>

[Browser Tool](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent/browser-tool.md) が有効な Agent が Web ページの操作を始めると、右側に <mark style="color:blue;">ブラウザー</mark> パネルが表示され、Agent が見ているページのスクリーンショットと現在の URL をリアルタイムで確認できます。Agent の操作中は <mark style="color:blue;">AI が操作中</mark> と表示され、画面がまだない場合は「ブラウザーの画面を待機中…」と表示されます。

訪問者は Agent が停止しているときに操作に介入し、認証コードやアカウントとパスワードを入力したり、選択肢を選んだりできます。

* スクリーンショット上で直接クリック、ダブルクリック、右クリック、スクロールをすると、その操作が Agent の操作中の Web ページに送信されます。
* パネル下部の入力欄 <mark style="color:blue;">ここにテキストを入力し、Enter キーでブラウザーに送信</mark>：テキストを入力して Enter キーを押すと送信されます。入力欄が空の場合も、Enter、Esc、方向キーなどのキー操作が直接 Web ページに送信されます。Agent の操作中は入力欄が一時的に無効になります。
* 右上の <mark style="color:blue;">閉じる</mark> でパネルを折りたたむと、入力欄の上に <mark style="color:blue;">ブラウザーの画面を再表示</mark> が表示され、クリックすると再度確認できます。

{% hint style="warning" %}
パネルに入力したアカウントとパスワードは、Agent が操作している Web ページに送信されます。この Agent と運営企業を信頼できる場合にのみ入力してください。
{% endhint %}

#### パネルをデフォルトで折りたたむ <a href="#collapse-by-default" id="collapse-by-default"></a>

パネルが自動的に開かないようにするには、パネルのヘッダー（<mark style="color:blue;">閉じる</mark> の左側）にある <mark style="color:blue;">デフォルトで折りたたむ</mark> を有効にします。有効にすると、Agent が Web ページを操作してもパネルは折りたたまれたままになります。画面を確認するときは、入力欄の上にある <mark style="color:blue;">ブラウザーの画面を再表示</mark> を押してください。

* この設定は現在使用中のブラウザーにのみ保存され、同じ Web サイト上の Web Chat で共有されます。別のブラウザーやデバイスでは再設定が必要です。
* ブラウザーがサードパーティ Cookie やサイトデータをブロックしている場合、再読み込みすると無効に戻ります。
* ログイン済みの組織メンバーも同様に、ブラウザーにのみ保存されます。内部会話の[デフォルトで折りたたむ](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent/browser-tool.md#collapse-by-default)とは別の設定なので、それぞれ設定してください。

## <mark style="color:blue;">七、会話のアクセス制御 - 安全で管理可能な会話環境</mark> <a href="#access-control" id="access-control"></a>

### 1. ログイン機能の設定 <a href="#login-config" id="login-config"></a>

**ログインの必須化**

会話内容の安全性と管理性を確保するため、企業はログイン機能を有効にし、Agent サービスの利用前にログインを必須にできます。設定後、訪問者が Web Chat をクリックすると、まずログインページが表示されます。ログインに成功したユーザーだけが Agent との会話を開始できます

**セキュリティ上の利点**

* **本人確認**：会話するすべてのユーザーの身元を明確にします
* **権限制御**：ユーザーの身元に応じたサービス内容を提供します
* **会話の追跡**：各ユーザーの会話履歴をすべて記録します
* **データの保護**：権限のないユーザーによる機密情報へのアクセスを防ぎます

### 2. 3 つのログイン方法 <a href="#login-methods" id="login-methods"></a>

**AD（Active Directory）ログイン**

* **利用場面**：社内従業員向けに、既存の AD システムと連携します
* **特徴**：シングルサインオン（SSO）に対応し、追加のアカウント管理は不要です
* **設定方法**：AD サーバーの接続情報と同期ルールを設定します
* **活用例**：従業員が会社のアカウントで直接ログインし、対応する権限を自動的に取得します

**Keycloak ログイン**

* **利用場面**：複雑な ID 管理が必要な企業向けで、複数の ID プロバイダーに対応します
* **特徴**：OAuth2、SAML、OpenID Connect などの標準プロトコルに対応します
* **設定方法**：Keycloak サーバー、ユーザープール、ID プロバイダーを設定します
* **活用例**：複数のシステムのユーザー ID を統合し、権限を一元管理します
* **応用**：Agent が MCP／API ツールを呼び出すときに、訪問者の Keycloak ログイン ID を引き継げます。[Keycloak のログイン ID を引き継いでツールを呼び出す](#keycloak-token-passthrough)をご覧ください

**MaiAgent ログイン**

* **利用場面**：シンプルなユーザー管理が必要な場合に、すばやく導入できます
* **特徴**：ユーザー管理システムを内蔵し、シンプルで直感的に操作できます
* **設定方法**：MaiAgent プラットフォームでユーザーアカウントと権限を作成します
* **活用例**：特定のユーザーグループ専用のログインシステムを構築します
* **訪問者自身による登録**：ログインページには <mark style="color:blue;">今すぐ登録</mark> と <mark style="color:blue;">パスワードをお忘れですか？</mark> があります。登録フォームは MaiAgent 管理画面のアカウント申請と同じです（氏名、会社名、会社のメールアドレス、パスワード、招待コード）。MaiAgent プラットフォームのアカウントが作成され、そのままログインページに戻って Web Chat にログインできます。このアカウントが組織のメンバーになったり、管理画面の権限を取得したりすることはありません。ページには人間であることを確認する認証があります。下記の[訪問者に表示されるその他の案内](#other-visitor-prompts)をご覧ください。

有効にすると、会話を始める前に次のログイン画面が表示されます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-64de17901f8cb6979d092e523f309cbf98c493d2%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-08-15%20174017.png?alt=media" alt=""><figcaption></figcaption></figure>

### 3. Keycloak のログイン ID を引き継いでツールを呼び出す <a href="#keycloak-token-passthrough" id="keycloak-token-passthrough"></a>

訪問者が Keycloak で Web Chat にログインすると、Agent が訪問者に代わって [MCP ツール](https://docs.maiagent.ai/maiagent-user-guide/ja/build/tools/mcp-setup.md)や [API ツール](https://docs.maiagent.ai/maiagent-user-guide/ja/build/tools/setup_api_tool.md)を呼び出すときに、**訪問者本人の Keycloak ログイン認証情報**を自動的に付与できます。バックエンドシステムは、リクエストを受け取ると同じ Keycloak の認証で「誰からのリクエストか」を確認し、その人が閲覧できるデータだけを返せます。ツールごとに別途アカウントを設定したり、訪問者にもう一度ログインしてもらったりする必要はありません。

この機能はデフォルトで無効です。無効の場合、すべてのツールの呼び出し方法は従来どおりです。

#### 利用例 <a href="#keycloak-token-passthrough-scenario" id="keycloak-token-passthrough-scenario"></a>

ある企業では、社内サービスポータルで Keycloak を使って従業員アカウントを管理し、Web Chat を従業員専用の Agent として利用しています。IT 管理者が会話プラットフォームでこの機能を有効にし、会社の休暇管理システムのホストを許可リストに追加します。従業員が Web Chat にログインして「有給休暇はあと何日残っていますか？」と尋ねると、Agent が休暇管理システムの API ツールを呼び出し、リクエストにその従業員本人のログイン認証情報を付与します。休暇管理システムは認証情報で本人を識別し、その従業員の勤怠データだけを返します。別の従業員が尋ねた場合は、その人自身のデータが返されます。

#### 事前準備 <a href="#keycloak-token-passthrough-prerequisites" id="keycloak-token-passthrough-prerequisites"></a>

* 組織で [Keycloak 連携](https://docs.maiagent.ai/maiagent-user-guide/ja/org/sso/sso-keycloak.md)が完了している必要があります。訪問者はこの組織のメンバーである必要があります。組織に設定された Keycloak で初めてログインすると、アカウントが自動作成され、組織に追加されます（[外部サービスでのログイン：初回ログイン](https://docs.maiagent.ai/maiagent-user-guide/ja/org/sso.md#first-login)をご覧ください）。
* 会話プラットフォームの「<mark style="color:blue;">ログイン設定</mark>」で「<mark style="color:blue;">ログイン機能を有効にする</mark>」がオンになっており、「<mark style="color:blue;">ログイン元</mark>」に Keycloak が選択されている必要があります。
* 認証情報を受け取る MCP／API ツールが作成され、この会話プラットフォームで利用する Agent に設定されている必要があります。相手のシステムは、Keycloak Realm が発行した認証情報を検証できる必要があります。

#### 設定手順 <a href="#keycloak-token-passthrough-steps" id="keycloak-token-passthrough-steps"></a>

設定場所：左側メニューの「<mark style="color:blue;">カスタマーサポート > 会話プラットフォーム</mark>」から Web サイト型の会話プラットフォームを選択し、「<mark style="color:blue;">ログイン設定</mark>」タブを開きます。ログイン元に Keycloak を選ぶと、その下にこの設定が表示されます。

1. 「<mark style="color:blue;">Keycloak のログイン ID を引き継いでツールを呼び出す</mark>」を有効にします。
2. スイッチの下にある赤い警告文「<mark style="color:blue;">訪問者本人のログイン認証情報を以下のホストに転送します</mark>」を読み、認証情報の送信先を理解していることを確認します。
3. 「<mark style="color:blue;">認証情報の受信を許可するツールホスト</mark>」に、認証情報を受け取るツールのホストを 1 行に 1 つずつ入力します（カンマ区切りも可能です）。
   * ホスト名だけを入力します。`https://`、ポート番号、パスは含めません。例：`mcp.example.com`。
   * `*.example.com` は `example.com` 自体とすべてのサブドメインに一致します。`*.` を付けないホスト名は、完全に同じホストだけに一致します。
   * ホスト名は、ツールの「MCP サーバー URL」または「API URL」と照合されます。
4. 設定を保存します。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-affd050ebc568fa2c5cad82c542d3f53cefe8493%2Fwebchat-keycloak-token-passthrough.png?alt=media" alt="Keycloak のログイン ID を引き継いでツールを呼び出す機能を有効にした後の警告と許可ホストの一覧"><figcaption><p>有効にすると認証情報の転送に関する警告が表示され、受信を許可するツールホストの入力が必要です</p></figcaption></figure>

スイッチを有効にする場合は、リストに少なくとも 1 つのホストを入力する必要があります。リストが空、または無効なホスト名が含まれる場合は、「<mark style="color:blue;">有効にする場合は、認証情報の受信を許可するツールホストを少なくとも 1 つ入力してください</mark>」または「<mark style="color:blue;">以下は有効なホスト名ではありません</mark>」と表示され、設定は送信されません。

{% hint style="warning" %}
**有効にした後、訪問者は再度ログインする必要があります。** プラットフォームが Keycloak の認証情報を保存するのは訪問者のログイン時だけで、いずれかの会話プラットフォームでこの機能が有効になっている場合に限られます。有効にする前からログインしていた訪問者には、ログアウトして再度ログインしてもらってください。その後のツール呼び出しから認証情報が付与されます。
{% endhint %}

#### 相手のシステムが受け取る内容 <a href="#keycloak-token-passthrough-request" id="keycloak-token-passthrough-request"></a>

Agent が許可リスト内のホストの MCP／API ツールを呼び出すと、リクエストに次の HTTP ヘッダーが追加されます。

```
Authorization: Bearer <訪問者の Keycloak access token>
```

これは、Keycloak Realm がその訪問者に発行した標準の access token です。連携を担当するエンジニアは、通常の Keycloak token の検証方法（署名、有効期限、Realm の確認）でユーザーを識別できます。認証情報の有効期限が切れた場合は、プラットフォームがその訪問者のログインセッションを使って同じ Keycloak で更新してから送信します。ツール側で更新を処理する必要はありません。

#### 認証情報が付与される場合とされない場合 <a href="#keycloak-token-passthrough-behavior" id="keycloak-token-passthrough-behavior"></a>

| 状況                                                                                                                                                                     | 結果                                                                  |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| 訪問者が Keycloak でログインしており、現在もログイン状態で、ツールホストが許可リストにある場合                                                                                                                   | 訪問者本人の認証情報を付与します                                                    |
| ツールホストが許可リストにない場合                                                                                                                                                      | 認証情報を付与せず、通常どおり呼び出します                                               |
| ツール自体に `Authorization` が設定されている場合（OAuth、API ツールのヘッダー、[連絡先の MCP 認証情報](https://docs.maiagent.ai/maiagent-user-guide/ja/build/tools/setup-contacts-mcp-credentials.md)など） | 上書きせず、ツールの既存の認証方法を維持します                                             |
| 訪問者がログアウト済み、またはこの組織のメンバーではない場合                                                                                                                                         | 認証情報を付与しません                                                         |
| 訪問者が [Source ID によるログイン不要のアクセス](https://docs.maiagent.ai/maiagent-user-guide/ja/build/choose-channel/web-chat/source-id-access.md)で会話に入った場合                            | 認証情報を付与しません。身元は会話作成時に紐付けられた組織メンバーに基づき、埋め込み元から渡された Source ID は使用しません |
| スイッチが無効の場合                                                                                                                                                             | この機能を有効にしていない場合と同じ動作です                                              |

{% hint style="danger" %}
転送されるのは訪問者本人の完全なログイン認証情報です。受け取ったシステムは、訪問者の身元を使って、同じ Keycloak で保護されているほかのサービスにもアクセスできます。許可リストには、信頼でき、実際にユーザーの識別が必要なホストだけを登録し、範囲が広すぎるワイルドカードは避けてください。
{% endhint %}

{% hint style="info" %}
訪問者がログアウトすると、プラットフォームは保存済みの認証情報を取り消します。同じ Keycloak サイトでこの機能を有効にしている会話プラットフォームがなくなった場合（スイッチを無効にした、ログイン元を変更した、または会話プラットフォームを削除した場合）、保存済みの訪問者の認証情報もすべて消去されます。
{% endhint %}

## <mark style="color:blue;">八、データ収集（Pre-chat フォーム）</mark> <a href="#pre-chat-form" id="pre-chat-form"></a>

データ収集を有効にすると、訪問者は会話を開始する前にフォームが表示され、記入してから会話に進みます。入力内容はその訪問者の[連絡先](https://docs.maiagent.ai/maiagent-user-guide/ja/serve/daily-operations/contact.md)に保存され、サポート担当者が会話ページから直接確認できます。販売代理店向けサービスで会社名と法人番号を収集する場合や、イベントに関する問い合わせで氏名と Email を収集する場合など、事前に相手を把握したい場面に適しています。

### 1. データ収集フォームの設定 <a href="#pre-chat-config" id="pre-chat-config"></a>

操作経路：<mark style="color:blue;">カスタマーサポート</mark> → <mark style="color:blue;">会話プラットフォーム</mark> → Web Chat の会話プラットフォームを選択 → <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-df589272e7045f7e939b7cba60f075968b08b741%2Fweb-chat-prechat-settings.png?alt=media" alt="データ収集タブ"><figcaption><p>「データ収集」タブ：左側でスイッチ、タイトル、フィールドを設定すると、右側の「ライブプレビュー」にフォームの外観がリアルタイムで表示されます</p></figcaption></figure>

{% stepper %}
{% step %}

### フォームを有効にする <a href="#pre-chat-enable-form" id="pre-chat-enable-form"></a>

<mark style="color:blue;">Pre-chat フォームを有効にする</mark> をオンにします。無効の場合は、従来どおり訪問者が直接会話に進みます。
{% endstep %}

{% step %}

### タイトルとサブタイトルを設定する（任意） <a href="#pre-chat-form-title" id="pre-chat-form-title"></a>

* <mark style="color:blue;">フォームのタイトル</mark>：フォームの上部に表示されます。未入力の場合は、デフォルトの「会話を始める前の簡単な質問」が使用されます。
* <mark style="color:blue;">フォームのサブタイトル</mark>：フォームの説明文です。`{name}` で会話プラットフォーム名を挿入できます。未入力の場合は、デフォルトの「{name} がよりパーソナライズされたサービスを提供できるよう、お客様の情報をご入力ください」が使用されます。

どちらも多言語に対応しており、言語タブを切り替えて各言語の内容を入力できます。
{% endstep %}

{% step %}

### フィールドの追加 <a href="#pre-chat-add-fields" id="pre-chat-add-fields"></a>

<mark style="color:blue;">フィールドを追加</mark>をクリックします。各フィールドでは次の項目を設定できます。

| 設定項目                                                   | 説明                                                                                                                                                                                                                                                    |
| ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">フィールドの種類</mark>              | テキスト、Email、電話、ドロップダウンの4種類です                                                                                                                                                                                                                           |
| <mark style="color:blue;">フィールドラベル</mark>              | 訪問者に表示されるフィールド名です。言語ごとに入力できます                                                                                                                                                                                                                         |
| <mark style="color:blue;">プレースホルダー（Placeholder）</mark> | フィールド内に表示される灰色のヒントです                                                                                                                                                                                                                                  |
| <mark style="color:blue;">必須</mark>                    | チェックを入れると、訪問者は未入力のまま送信できなくなります                                                                                                                                                                                                                        |
| <mark style="color:blue;">Contactフィールドとの対応付け</mark>    | 連絡先のどこにデータを保存するかを指定します。<mark style="color:blue;">氏名（Contact.name）</mark>、<mark style="color:blue;">Email（Contact.email）</mark>、<mark style="color:blue;">電話（Contact.phoneNumber）</mark>、または<mark style="color:blue;">カスタムフィールド（Metadata）</mark>を選択します |

ドロップダウンには<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-619c49c3340c2461c44fc92d965e6a2d40c77538%2Fweb-chat-prechat-field-editor.png?alt=media" alt="フィールド編集エリア"><figcaption><p>各フィールドで種類、フィールドラベル（多言語）、プレースホルダー、Contactフィールドとの対応付け、必須の有無を設定できます</p></figcaption></figure>

フィールドはドラッグして並べ替えられます。1つのフォームに設定できるフィールドは最大10個です。右側のプレビューにはフォームの表示がリアルタイムで反映されます。<mark style="color:blue;">プレビュー言語</mark>を切り替えて、各言語の表示を確認できます。
{% endstep %}

{% step %}

### 保存 <a href="#pre-chat-save-form" id="pre-chat-save-form"></a>

プレビューに問題がないことを確認して保存すると、Web Chatにすぐに反映されます。
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Contactフィールドとの対応付けの制限**

* 氏名は「テキスト」、Emailは「Email」、電話は「電話」の種類にのみ対応付けられます。種類が一致しない場合は、選択できないことを示すメッセージが表示されます。
* 氏名、Email、電話は、それぞれ1つのフォームフィールドにのみ対応付けられます。その他の項目（法人番号、会社名など）は「カスタムフィールド（Metadata）」を選択してください。
  {% endhint %}

### 2. 訪問者による入力の流れ <a href="#pre-chat-visitor-flow" id="pre-chat-visitor-flow"></a>

訪問者がWeb Chatを開くと、最初にフォームが表示されます。タイトル、サブタイトル、設定したフィールドに加え、右上には言語切り替えが表示されます。入力後に<mark style="color:blue;">会話を開始</mark>をクリックすると、会話に進みます。

<div><figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-72d96183b2932a7f3a53fa26e25b0c44693d9976%2Fweb-chat-prechat-form.png?alt=media" alt="訪問者に表示されるフォーム"><figcaption><p>訪問者がWeb Chatを開くと、最初にフォームが表示されます</p></figcaption></figure> <figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-80e055ba2910bb69258325f5f6f23ee481ba7342%2Fweb-chat-prechat-form-filled.png?alt=media" alt="入力済みのフォーム"><figcaption><p>入力後に「会話を開始」をクリックします</p></figcaption></figure></div>

* 必須フィールドが未入力の場合や、Emailまたは電話の形式が正しくない場合は、フィールドの下にエラーが表示され、送信できません。
* 同じブラウザーで一度入力すると、その後同じWeb Chatを開いても再入力は求められません。
* 情報を修正したい場合は、Web Chat右上の<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-cc226e66c15e542470c95f0dd2b494f604ad81ec%2Fweb-chat-prechat-menu-refill.png?alt=media" alt="情報を再入力"><figcaption><p>右上の⋮メニューにある「情報を再入力」です</p></figcaption></figure>

### 3. ログイン機能との併用：ログインアカウントへのデータの紐付け <a href="#pre-chat-with-login" id="pre-chat-with-login"></a>

同じWeb Chatで[ログイン機能](#login-config)とデータ収集を両方有効にすると、**ログイン → フォーム入力 → 会話開始**の順に進みます。入力したデータはブラウザーではなく、ユーザーのログインアカウントに紐付きます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-06b9fe480a3b4194110f3ebf618909d604be8274%2Fweb-chat-prechat-login-settings.png?alt=media" alt="ログイン設定タブ"><figcaption><p>「ログイン設定」タブで「ログイン機能を有効にする」をオンにし、ログイン元を選択します。「データ収集」タブとは独立した設定です</p></figcaption></figure>

<div><figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-f9c71c232b1bbdd9ee1880cf922a6361d2420e5e%2Fweb-chat-prechat-login-page.png?alt=media" alt="ログイン画面"><figcaption><p>① Web Chatを開くと、最初にログイン画面が表示されます</p></figcaption></figure> <figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-020c77245a78280ffc81ed879bdb2a9613f3cdeb%2Fweb-chat-prechat-login-form.png?alt=media" alt="ログイン後のフォーム"><figcaption><p>② ログイン後にデータ収集フォームが表示されます</p></figcaption></figure></div>

| 状況                                                          | Web Chatの動作                                   |
| ----------------------------------------------------------- | --------------------------------------------- |
| アカウントの初回利用で、フォームをまだ入力していない場合                                | ログイン後にフォームが表示されます。送信すると、そのアカウントに紐付く連絡先が作成されます |
| 同じアカウントで別のデバイスやブラウザーからログインした場合                              | フォームは再表示されず、アカウントの既存データで会話を開始します              |
| このデバイスで以前に未ログインの状態で入力しており、アカウント自体にはデータがない場合                 | 「この情報はあなたのものですか？」という確認画面が表示されます（下記参照）         |
| アカウントにデータがあり、このデバイスにも未ログイン時に入力した別のデータがある場合                  | アカウントのデータを優先し、確認や統合は行いません                     |
| ログイン済みユーザーが<mark style="color:blue;">情報を再入力</mark>をクリックした場合 | アカウントに紐付く既存の連絡先が更新されます。連絡先は追加されません            |

**確認画面：この情報はあなたのものですか？**

このデバイスで以前に誰かがログインせずにフォームを入力しており、現在ログインするアカウントにデータがない場合は、ログイン後すぐにフォームを表示せず、先に確認画面を表示します。このデバイスで以前に入力された内容（一部マスク済み）と、次の2つのボタンが表示されます。

* <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-f8d35bfa6b85a7ec60a08eb8e73cc09904338eb6%2Fweb-chat-prechat-claim.png?alt=media" alt="この情報はあなたのものですか？確認画面"><figcaption><p>確認画面では内容の一部をマスクし、自分が入力した情報かどうかを判別できる範囲だけ表示します</p></figcaption></figure>

{% hint style="info" %}

* ログイン機能を有効にしていないWeb Chatには影響しません。引き続きブラウザー単位で入力済みかどうかを判定します。
* アカウントのデータがフォームに自動入力されることはありません。アカウントの初回利用時は、管理画面にすでにデータがある場合も、一度フォームの入力を求められます。
  {% endhint %}

会話開始後、Agentとカスタマーサポート管理画面では、どちらもこのアカウントに紐付く同じ連絡先を参照します。

<div><figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-f9a99f4c93d7d3395efb4d6f27175d2469857745%2Fweb-chat-prechat-login-chat.png?alt=media" alt="ログイン後の会話"><figcaption><p>Agentはフォームに入力された氏名でユーザーを呼びます</p></figcaption></figure> <figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-c054d2802f3905081dd7f8f997b1ac7ef7dc9697%2Fweb-chat-prechat-conversation-login.png?alt=media" alt="管理画面の会話ページ"><figcaption><p>管理画面の会話ページには、連絡先とフォームで受け取った法人番号が表示されます</p></figcaption></figure></div>

### 4. 管理画面で収集したデータを確認 <a href="#pre-chat-view-data" id="pre-chat-view-data"></a>

**会話内で確認する場合**：<mark style="color:blue;">カスタマーサポートの会話</mark> → <mark style="color:blue;">すべての会話</mark> → 会話を開くと、右側の<mark style="color:blue;">連絡先情報</mark>にフォームで受け取った内容が項目ごとに表示されます。Emailと電話に対応付けたフィールドは「メールアドレス」「電話番号」と表示され、カスタムフィールドは設定したフィールドラベルで表示されます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-efe6eb93e6c245a6c4dd2e98e793cc07bd69668f%2Fweb-chat-prechat-conversation-contact.png?alt=media" alt="会話ページ右側の連絡先情報エリア"><figcaption><p>会話ページ右側の「連絡先情報」に、フォームで受け取った内容が項目ごとに表示されます</p></figcaption></figure>

{% hint style="info" %}
連絡先リストの「連絡先」列には、Contactの氏名が表示されます。フォームの氏名フィールドを「氏名（Contact.name）」ではなく「カスタムフィールド（Metadata）」に対応付けている場合、未ログインの訪問者の連絡先は「匿名」と表示され、氏名はカスタム属性にのみ表示されます。リストで訪問者の氏名を直接確認したい場合は、氏名フィールドを「氏名（Contact.name）」に対応付けてください。
{% endhint %}

**連絡先ページで確認する場合**：<mark style="color:blue;">カスタマーサポートの会話</mark> → <mark style="color:blue;">連絡先</mark> → 連絡先を開くと、<mark style="color:blue;">基本情報</mark>タブに氏名と電話番号、<mark style="color:blue;">カスタム属性</mark>タブにその他のフォームフィールドが表示されます。

<div><figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-efb6b695dd61855fd1e9963f8cfd34597bc31f73%2Fweb-chat-prechat-contacts-list.png?alt=media" alt="連絡先リスト"><figcaption><p>連絡先リストは氏名、Email、電話番号で検索できます</p></figcaption></figure> <figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-9bc3a0bf13c97c7eed1f5223b76a9bca113962f5%2Fweb-chat-prechat-contact-attributes.png?alt=media" alt="カスタム属性タブ"><figcaption><p>「カスタム属性」タブには、フォームの各フィールドの値が表示されます</p></figcaption></figure></div>

ログイン済みユーザーが入力したデータは、そのユーザーのアカウントに紐付くため、所有者のいない匿名の連絡先ではなくなります。連絡先の名前はフォームの設定によって決まります。氏名フィールドが「氏名（Contact.name）」に対応付けられている場合は、フォームに入力された氏名が表示されます。氏名フィールドがない場合は、ログインアカウントの名前が表示されます。

## 訪問者に表示されるその他の案内 <a href="#other-visitor-prompts" id="other-visitor-prompts"></a>

会話中にときどき表示される、管理者による設定が不要な案内を以下にまとめています。訪問者からの質問に回答する際に参照してください。

| 画面                                                                     | 表示されるタイミング                                                                                                                                                                      | 対応方法                                                                                                                                                            |
| ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ログイン、新規登録、パスワード再設定ページの認証ボックス、および「操作が多すぎます。しばらくしてからもう一度お試しください。」        | ログイン機能を有効にしたWeb Chatでは、この3つのページにCloudflare Turnstile認証が追加されます。短時間に多数のリクエストを送信すると（新しい会話を連続して開く、メッセージを連投するなど）、レート制限が適用されます                                                        | 認証ボックスにチェックが付いてから送信してください。制限された場合は、少し待ってから再試行してください                                                                                                             |
| 画面下部の「{アプリ名} Appをインストール」パネル                                            | モバイルブラウザーで独立した全画面ページを開くと、Web Chatをアプリとしてホーム画面に追加できます。Androidでは<mark style="color:blue;">今すぐインストール</mark>、iPhoneのSafariでは「ホーム画面に追加」の手順が表示されます。iPhoneのその他のブラウザーではSafariの使用が案内されます | インストールしない場合は<mark style="color:blue;">後で通知</mark>をクリックすると、1日間は再表示されません。インストール済みのアプリとして開いた場合は表示されません                                                             |
| 「内容が長すぎます（全N文字）。プレーンテキストで表示します」＋<mark style="color:blue;">全文を表示</mark> | 1つの返信が50,000文字を超える場合（または1行が2,000文字を超える場合）は、Markdownの書式を適用せず、最初の2,000文字を表示します                                                                                                    | <mark style="color:blue;">全文を表示</mark>で展開し、<mark style="color:blue;">折りたたむ</mark>で戻します                                                                          |
| 「内容が大きすぎます（全N文字）。先頭部分のみ表示します」                                          | ツールが返したJSONデータが大きすぎる場合に表示されます                                                                                                                                                   | 表示だけが省略されています。Agentは完全なデータを受け取っています                                                                                                                             |
| 「以前の長いメッセージの一部を省略しました（合計約N文字）。アシスタントが全文を参照できていない可能性があります」              | 会話が長くなると、コンテキストの長さを抑えるために、以前の長いメッセージの一部が省略されます                                                                                                                                  | Agentにその内容を参照させたい場合は、関連する部分をもう一度貼り付けてください。[会話の引き継ぎ](https://docs.maiagent.ai/maiagent-user-guide/ja/work/maigpt/chat/conversation-handoff.md)で新しい会話を開始することもできます |
| 返信の横にある「この返信はチームメンバー『{名前}』が生成しました」という小さなラベル                            | Agentが[Agentチーム](https://docs.maiagent.ai/maiagent-user-guide/ja/build/teams.md)に所属しており、その返信をチーム内のメンバーAgentが担当した場合に表示されます                                                       | 対応は不要です                                                                                                                                                         |
| 「{Agent}に委任中／引き継ぎ中／切り替え中」、サブエージェントのタスクカード                              | 複数のAgentが連携する際、メインAgentがサブエージェントにタスクを委任します                                                                                                                                      | カードには回答中または完了の状態が表示されます。完了までお待ちください                                                                                                                             |
| 「位置情報を取得中...」「位置情報を取得できません。設定で位置情報へのアクセスを許可してください」「位置情報を取得しました」        | 管理者が[位置情報](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/platform-settings/function-settings.md#gps-location)を有効にしている場合、ブラウザーが位置情報へのアクセス許可を求めます   | 位置情報へのアクセスを許可してから送信してください。許可しなくてもAgentは回答しますが、位置情報は使用できません                                                                                                      |
| 「{サービス}に接続」認可カード                                                       | Agentが訪問者自身のアカウントを使用して外部サービスにアクセスする必要がある場合に表示されます                                                                                                                               | [接続済みサービス](https://docs.maiagent.ai/maiagent-user-guide/ja/build/choose-channel/web-chat/connected-services.md)を参照してください                                        |
| 動画生成カード（待機中／生成中／所要時間の目安：60〜90秒）                                        | Agentが動画生成ツールを使用する場合に表示されます                                                                                                                                                     | 完了までお待ちください。詳細は[AI動画生成](https://docs.maiagent.ai/maiagent-user-guide/ja/work/maigpt/video.md)を参照してください                                                          |

## 接続に失敗した場合の対処方法 <a href="#connection-failure" id="connection-failure"></a>

たとえば、Web Chatを開くと接続できないと訪問者からウェブサイトの管理者に報告があった場合、訪問者はまずシステムの自動再試行を待ちます。それでもエラー画面が表示される場合は、失敗した段階、エラー分類、発生時刻を含む画面全体を撮影して管理者に渡すと、原因を判断しやすくなります。

Web ChatがAgent設定を読み込む際にネットワークが切断されると、自動で再試行します。その間は読み込み画面が表示されます。再試行後も接続できない場合、エラー画面には次の情報が表示されます。

* 読み込みに失敗した段階
* エラー分類（HTTPステータスコードがある場合は併せて表示）
* エラーが発生した現地時刻

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-e24edbd1a83fd7f69430443a8a74158aeb6a117b%2Fweb-chat-connection-failure-network.png?alt=media" alt="Agent設定の読み込み段階でネットワーク接続に失敗したことを示すWeb Chatの診断情報"><figcaption><p>自動再試行でも接続できない場合、失敗した段階、エラー分類、発生時刻が表示されます</p></figcaption></figure>

HTTPエラーステータスコードを受信している場合は、サーバーからの応答があったことを意味します。この場合は自動再試行せず、診断情報を含むエラー画面を直接表示します。

{% hint style="info" %}
まずデバイスがインターネットに正常に接続できることを確認してから、エラー画面の<mark style="color:blue;">再試行</mark>をクリックしてください。問題が続く場合は、診断情報全体を含めて画面を撮影し、会話内容や個人情報が写らないようにしてください。
{% endhint %}

## 返信生成中に以前のメッセージを確認 <a href="#review-during-generation" id="review-during-generation"></a>

Agentが返信を生成している間も、訪問者は上にスクロールして以前のメッセージを確認できます。返信は下部で生成され続けますが、画面はスクロールした位置にとどまり、新しいテキストが表示されても移動しません。最新の表示位置から離れると、入力欄の上に<mark style="color:blue;">最新に戻る</mark>が表示されます。

### 利用例 <a href="#generation-scroll-scenario" id="generation-scroll-scenario"></a>

訪問者がAgentに複数のプランをまとめて比較するよう依頼します。回答が完成する前に、最初のプランの価格を確認するため上にスクロールしても、画面はその位置にとどまり、下にテキストが追加され続けても移動しません。確認後に<mark style="color:blue;">最新に戻る</mark>をクリックすると、最後の質問の位置に戻り、残りの比較内容を読み進められます。

### 操作方法 <a href="#generation-scroll-steps" id="generation-scroll-steps"></a>

{% stepper %}
{% step %}

### 1. 上にスクロール <a href="#scroll-up-during-generation" id="scroll-up-during-generation"></a>

Agentが返信を生成している間に、マウスホイール、タッチ操作、またはスクロールバーのドラッグで上にスクロールします。
{% endstep %}

{% step %}

### 2. その位置で読む <a href="#read-in-place" id="read-in-place"></a>

画面はスクロールした位置にとどまります。生成中の新しい内容によって、現在の位置が変わることはありません。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-537d8652530560963f91fe83d44727c547068051%2Fwebchat-back-to-latest.png?alt=media" alt="Web Chatの返信生成中に上にスクロールすると、入力欄の上に「最新に戻る」が表示されます"><figcaption><p>返信生成中（入力欄の右側に四角い停止ボタンが表示されています）に上にスクロールすると、入力欄の上に「最新に戻る」が表示されます</p></figcaption></figure>
{% endstep %}

{% step %}

### 3. 最新に戻る <a href="#press-back-to-latest" id="press-back-to-latest"></a>

<mark style="color:blue;">最新に戻る</mark>をクリックすると、最後の質問の位置に戻り、最新の内容への自動追従が再開されます。
{% endstep %}
{% endstepper %}


---

# 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.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.
