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

# チャットエージェント

表示中のデータを調べるクイック分析、データを深掘りする分析アシスタント、設定を相談する設定アシスタントの使い方を説明します。

## チャットエージェントでできること <a href="#overview" id="overview"></a>

チャットで質問しながら、データを分析したり、プロジェクトの設定を相談したりできます。目的に合わせて使い分けます。

| 目的                          | 使う機能     |
| --------------------------- | -------- |
| 表示中のダッシュボードやヒートマップについて質問したい | クイック分析   |
| 表示中の画面に限らず、計測データを深掘りしたい     | 分析アシスタント |
| タグ設置やCVイベントなど、設定について相談したい   | 設定アシスタント |

クイック分析・分析アシスタントの利用には[Wicle AIの有効化](https://docs.wicle.io/ai/policy.md#enable-ai)が必要です。クイック分析・分析アシスタントは、テスト環境のプロジェクトでは利用できません。利用回数の上限は[プランごとの一覧](https://docs.wicle.io/billing/plan-comparison.md#ai-limits)で確認できます。

会話は標準ではプロジェクト内で共有されます。共有範囲は、質問を送る前に確認してください。個人情報や機密情報など、入力してはいけない情報は[AI機能の提供ポリシー](https://docs.wicle.io/ai/policy.md#prohibited-actions)をご覧ください。

## エージェントの種類 <a href="#agent-types" id="agent-types"></a>

### クイック分析 <a href="#quick-analysis" id="quick-analysis"></a>

表示中の画面の情報をもとに分析します。ダッシュボードの数値を要約したいときや、ヒートマップから改善ポイントを確認したいときに使います。

1. 分析したいダッシュボードやヒートマップを開きます。
2. ページ上部の`AIに質問`を選択します。
3. 質問を入力するか、表示された質問の候補を選んで送信します。たとえば、期間内の変化や、先月と比べて変わった点を質問できます。

表示中のデータ以外も調べたい場合は、入力欄の`詳細分析`をオンにします。同じパネルで、分析アシスタントと同等の詳細な分析ができます。

### 分析アシスタント <a href="#analysis-assistant" id="analysis-assistant"></a>

Wicleで計測しているデータに対して、文章で質問できます。流入元ごとの違いや、CVの増減など、表示中の画面だけでは分からない点を調べるときに使います。

1. サイドメニューの`エージェント`を開きます。
2. 左側で`分析アシスタント`を選択します。
3. 調べたい対象・期間・比較したい条件を入力して送信します。たとえば「先月と今月で、CVが減った流入元を調べて」のように質問します。

[AIレポート](https://docs.wicle.io/ai/ai-summary.md#deep-analysis)の`詳しく分析`から開いた場合は、レポートの期間とカテゴリを引き継いで分析を始められます。

回答には、グラフやデータテーブルが含まれる場合があります。`実行クエリの解説`タブが表示されている場合は、AIがデータの集計に使ったクエリと、その解説を確認できます。

チャートに`ダッシュボードに追加`が表示されている場合は、[カスタムダッシュボード](https://docs.wicle.io/analytics/dashboard/custom-dashboard.md)へウィジェットとして追加できます。手順は[分析アシスタントからウィジェットを追加する](https://docs.wicle.io/analytics/dashboard/custom-dashboard/create-widget.md#add-from-assistant)をご覧ください。

### 設定アシスタント <a href="#config" id="config"></a>

プロジェクトの設定や、計測タグの診断について相談できます。サイドメニューの`エージェント`を開き、左側で`設定アシスタント`を選択します。

質問を入力するほか、次のような質問の候補から始められます。

* 「設定状況を診断して」
* 「CVイベントの設定を手伝って」
* 「タグ設置の確認をしたい」
* 「うちのサイトに合った設定は？」

## 会話の管理 <a href="#conversation" id="conversation"></a>

### 会話を再開・整理する <a href="#threads" id="threads"></a>

会話はスレッド（質問と回答のまとまり）として保存されます。専用画面では左側の`会話履歴`から、クイック分析ではパネル上部の会話名から履歴を開き、過去の会話を再開できます。

会話の`…`から`編集`を選ぶと、タイトルを変更できます。自分で作成した会話には`削除`も表示されます。削除した会話は元に戻せません。

### 共有とプライベート <a href="#sharing" id="sharing"></a>

標準の会話は、同じプロジェクトのメンバーで共有されます。

分析アシスタントやクイック分析で共有したくない会話を始める場合は、鍵アイコンからプライベートな会話を新しく作成します。送信前に、入力欄の`プライベート会話`表示を確認してください。＋ボタンから作成する会話は共有されます。
