> For the complete documentation index, see [llms.txt](https://docs.immedio.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.immedio.io/company-settings/ai-sdr/chat-test.md).

# チャットテスト

チャットテストでは、保存済みのAI接客の設定を管理画面上で動作確認できます。テスト対象のAI接客設定を切り替えて試すことも可能です。会話はデータベースに保存されないため、本番データを汚さずにテストできます。

## チャットテストとは

チャットテストとは、AI接客の設定が想定通りに動作するかを管理画面上で確認できる機能です。

会話のターンごとにAI内部の判定経過が「動作の内訳」として表示されるため、Triggerに一致したか、Qualifyノードでステイしているか、Actionに到達したかをひと目で確認できます。

テストで行った会話やリード情報はデータベースに保存されないため、本番のチャット履歴やアナリティクスに影響を与えません。

企業設定 > AI接客 > チャットテスト タブからアクセスできます。

## チャットテストでできること

| 機能          | 説明                                                            |
| ----------- | ------------------------------------------------------------- |
| チャットの動作確認   | 保存済みの設定でAI接客がどう応答するかを確認できます                                   |
| AI接客設定の切り替え | テスト対象のAI接客設定をドロップダウンで切り替えて、それぞれの設定でテストできます                    |
| 動作の内訳の表示    | 各ターンでのTriggerマッチ・Qualify評価・Action到達などの判定経過を確認できます             |
| 質問例からのテスト   | 基本設定の質問例や、デフォルトのサンプルプロンプトをクリックしてテストを開始できます                    |
| 質問サジェストの確認  | 基本設定で「AIの回答後に質問例を自動生成する」が有効な場合、回答後に表示される質問サジェストをテスト画面でも確認できます |
| 会話のリセット     | 「最初からやり直す」ボタンで履歴・収集済み属性をすべてリセットできます                           |

## チャットテストの使い方 <a href="#how-to-use" id="how-to-use"></a>

### テストの開始

1. 企業設定 > AI接客 > チャットテスト を開きます
2. テスト対象のAI接客設定を「基本設定」ドロップダウンから選択します
3. 画面下部のテキスト入力欄にメッセージを入力し、「送信」ボタンをクリックするか、Enterキーを押します
4. AIの応答と「動作の内訳」が表示されます

画面に表示される質問例のボタンをクリックしてテストを開始することもできます。質問例は選択中のAI接客設定で設定されている質問例が表示されます。AI接客設定で質問例が未設定の場合は、デフォルトのサンプルが表示されます。

### AI接客設定の切り替え <a href="#switch-setting" id="switch-setting"></a>

チャット画面上部の「基本設定」ドロップダウンから、テスト対象のAI接客設定を切り替えることができます。AI接客設定を切り替えると、会話履歴・収集済み属性がすべてリセットされ、選択したAI接客設定の質問例やフローでテストを行えます。

複数のAI接客設定を作成している場合に、それぞれの設定の動作を個別に確認する際に利用します。

### マルチターンのテスト

チャットテストでは複数ターンの会話をテストできます。過去のターンで収集された属性やQualifyノードの状態は次のターンに引き継がれるため、以下のような一連のフローを通しで確認できます。

1. Triggerノードに一致する発話を入力する
2. Qualifyノードで求められる属性（例：従業員規模）を回答する
3. さらに別の属性（例：メールアドレス）を回答する
4. Actionノードに到達して面談予約やURL遷移などのアクションが提示される

### 質問サジェストの確認 <a href="#suggestion" id="suggestion"></a>

選択中のAI接客設定で「AIの回答後に質問例を自動生成する」が有効になっている場合、AIの回答後に表示される質問サジェストをチャットテスト画面でも確認できます。サジェストのチップをクリックすると、その文言がそのまま送信され、次のテストを続けられます。

ただし、チャットテストには実際の訪問者がいないため、閲覧中ページや訪問履歴は使われず、サジェストは**会話履歴のみ**から生成されます。本番では閲覧中ページ・訪問履歴も加味されるため、サジェストの内容は本番と完全には一致しない点にご注意ください。機能の詳細は[基本設定 > 回答後の質問サジェスト](/company-settings/ai-sdr/basic-settings.md#suggestion)を参照してください。

### 会話のリセット

「最初からやり直す」ボタンをクリックすると、会話履歴・ステイ中のノード・収集済みの属性がすべてリセットされ、初期状態に戻ります。異なるフローを試したい場合や、設定を変更した後にテストをやり直したい場合に使用します。「基本設定」ドロップダウンでAI接客設定を切り替えた場合も、自動的に会話がリセットされます。

## 動作の内訳 <a href="#trace-steps" id="trace-steps"></a>

チャットテストでは、AIの応答の下に「動作の内訳」が表示されます。これはAIが内部でどのような判定を行ったかを時系列のステップで示すものです。

### ステータスの種類

動作の内訳の各ステップには、以下のステータスが色付きのドットで表示されます。

| ステータス | 色   | 説明                           |
| ----- | --- | ---------------------------- |
| ok    | 緑   | 条件に一致した、またはアクションに到達した        |
| wait  | 黄   | 属性の収集を待っている（Qualifyノードでステイ中） |
| skip  | グレー | 条件に一致しなかった、またはフロー上にいない       |
| info  | 青   | 属性の読み取りやQualify条件の不一致など、補足情報 |

### 表示されるステップの例 <a href="#trace-step-examples" id="trace-step-examples"></a>

#### Triggerに一致した場合

```
[ok] 話題が Trigger ノードに一致しました - 「料金について」
```

リードの発話がフローのTriggerノードの発火条件にマッチしたことを示します。一致したTriggerの発火条件の内容が表示されます。

#### Triggerに一致しなかった場合

```
[skip] Trigger には一致しませんでした - 雑談として処理されます。
```

リードの発話がどのTriggerノードにもマッチしなかったことを示します。AIガイドラインに沿った自由な応答が返されます。

#### Qualifyノードでステイ中の場合

```
[wait] Qualify ノードでリード属性の収集を待っています - これから「従業員規模・メールアドレス」を聞きます。
```

Qualifyノードの条件評価に必要な属性が揃っていない状態です。AIがリードに対して不足している属性を質問します。

#### Qualify条件を満たした場合

```
[ok] Qualify 条件を満たしました - 次のノードへ進みます。
```

Qualifyノードの条件が合致し、「合致」の接続先へ遷移したことを示します。

#### Actionノードに到達した場合

```
[ok] Action ノードに到達しました - 提示するアクションが 2 件あります。
```

フローの終点であるActionノードに到達し、面談獲得・URL遷移・Box埋め込みなどのアクションがリードに提示されることを示します。

## 注意事項

* チャットテストで行った会話はデータベースに保存されません。チャット履歴やリード情報、アクセスログには記録されません
* チャットテストはAI接客の設定を保存した状態でテストを行います。未保存の変更はテストに反映されません
* フローが未設定の場合でも、AIガイドラインに沿った雑談として応答が返されます
* ナレッジベースの検索が行われる場合、検索中のステータスが表示されます

## よくある質問

### チャットテストの会話は本番のチャット履歴に表示されますか？

いいえ、表示されません。チャットテストの会話はデータベースに一切保存されないため、チャット履歴やアナリティクスには影響しません。

### フローを変更した後、すぐにチャットテストに反映されますか？

フローや基本設定を保存した後であれば反映されます。未保存の変更はテストに反映されないため、変更を保存してからテストしてください。

### Triggerに一致しないのですが、どうすればよいですか？

フロー設定でTriggerノードの発火条件を確認してください。発火条件はリードの発話内容を自然言語で記述したものであり、リードの発話がその条件に合致するとフローが開始されます。詳細については[フロー設定](/company-settings/ai-sdr/flow.md)を参照してください。


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.immedio.io/company-settings/ai-sdr/chat-test.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.