> ## Documentation Index
> Fetch the complete documentation index at: https://docs.helloclever.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Clever AI のチュートリアル

> Merchant Portal の Clever AI を段階的に解説します。読み取るデータ、質問できる内容、ストアの接続方法、提示されたインサイトに基づいて行動する方法を紹介します。

Clever AI は [Merchant Portal](/ja/portal/overview)（マーチャントポータル）に組み込まれた決済インテリジェンスの機能です。平易な言葉で質問すると、リアルタイムの決済データ、顧客データ、ストアデータから回答します。質問しなくても、Clever AI が自らインサイトを生成して提示します。

レポートのツールとの違いは、情報が届くタイミングです。分析ツールは精算後に、すでに起きたことを説明します。Clever AI はすべての取引を対象に、いま起きていることを読み取り、結果にまだ影響を与えられるうちに次に取るべき行動を示します。プラットフォーム全体のどこに位置するかは、[プラットフォームの概要](/ja/platform-overview/overview)を参照してください。

このチュートリアルは、実際に使う順序で全体を解説します。Clever AI が読み取るデータを理解する、Clever AI を開く、最初の質問をする、ストアを接続する、そしてインサイトを読み、それに基づいて行動し、さらに掘り下げる、という流れです。

<Note>
  Clever AI はベータ版です。数値は行動に移す前に必ず確認し、内容に誤りがある場合は[回答の評価と問題の報告](#rate-an-answer-or-flag-a-problem)で説明するフラグの機能から報告してください。
</Note>

## Clever AI の仕組み

Clever AI は決済のために専用に構築されています。汎用的な Web 上のデータではなく、取引の挙動、キャッシュバックの仕組み、Milestone Rewards の成果に基づいて構築されているため、汎用の AI ツールでは答えられない自社の精算やロイヤルティの数値についても回答できます。

1つの質問欄の背後で、Clever AI は12の専門エージェントを稼働させています。Hello Clever が名称を公開しているのは次の4つです。

* **Planner Agent**
* **Customer Intelligence Agent**
* **Payment Intelligence Agent**
* **Cashback Campaign Agent**

エージェントを選ぶ必要はありません。質問を1つ入力すると、Clever AI がどのエージェントを使うかを判断します。同じ質問欄から、傾向の説明も、内容があらかじめ入力されたキャッシュバックキャンペーンの作成も行えるのは、このためです。

### Clever AI が読み取るデータ

<CardGroup cols={2}>
  <Card title="Hello Clever のデータ" icon="credit-card">
    過去およびリアルタイムの取引件数、顧客の購入と再訪のパターン、キャッシュバックの利用実績、チャネルの成果。
  </Card>

  <Card title="接続したストア" icon="store">
    [データコネクター](#choose-which-data-clever-ai-reads)を通じて接続したストアの注文、商品、顧客のデータ。読み取り専用です。
  </Card>

  <Card title="添付したファイル" icon="paperclip">
    質問に添付したレポート、請求書、スクリーンショット。リアルタイムのデータとあわせて分析されます。
  </Card>

  <Card title="外部のコンテキスト" icon="globe">
    Web のトラフィック、消費者の活動、マクロ経済のデータ、気象パターン、業界の見通し、その他の代替データ。
  </Card>
</CardGroup>

インサイトが自社の数値以外の事象に言及することがあるのは、この最後のグループがあるためです。たとえば、地域の暴風雨の警報と連動した需要の急増や、銀行のシステム障害と連動したカードの否認率などです。

## Clever AI を開く

<Steps>
  <Step title="全体共通の Ask 欄を使う">
    Portal のいずれのページでも、上部の **Ask me anything…** の欄を選択するか、その横に表示されているキーボードショートカットを押します。この欄はすべての画面から利用できるため、質問のために画面を移動する必要はありません。
  </Step>

  <Step title="またはサイドバーから開く">
    左サイドバーの **Growth Tools** から **Clever AI** を選択します。項目に付いたバッジには、確認待ちのインサイトの件数が表示されます。
  </Step>

  <Step title="Insights パネルの読み込みを待つ">
    ページを開くと、右側の **Insights** パネルが最新の推奨事項をまとめるまで少し時間がかかります。その間、短い読み込みのアニメーションが表示されます。
  </Step>

  <Step title="質問の画面が表示される">
    読み込みが完了すると、左側に **Ask me about your payments, customers, and more** の見出しの付いた質問欄、右側にインサイトのフィードが表示されます。
  </Step>
</Steps>

## 質問する

<Steps>
  <Step title="質問を入力する">
    決済、顧客、売上に関する質問を入力欄に入力します。事前に絞り込みやダッシュボードを設定する必要はありません。
  </Step>

  <Step title="またはプロンプトの候補を選ぶ">
    何を尋ねればよいか分からない場合は、入力欄の下にあるプロンプトの候補を選択します。たとえば **What were my best sales days this month?** などです。
  </Step>

  <Step title="ファイルを添付する（任意）">
    クリップのアイコンを選択すると、レポート、請求書、スクリーンショットを添付できます。Clever AI はリアルタイムのデータとあわせてそれを分析します。
  </Step>

  <Step title="送信する">
    入力欄の右にある送信の矢印を選択します。文字を入力すると、矢印の色が濃くなります。
  </Step>

  <Step title="回答が順次表示される">
    回答はリアルタイムで順次表示されます。生成中は送信の矢印が四角い**停止**のボタンに変わり、選択すると回答を途中で打ち切れます。
  </Step>

  <Step title="応答時間を確認する">
    各回答には生成にかかった時間が表示され、その下に **Beta** の表記があります。
  </Step>
</Steps>

<Tip>
  Clever AI は21の言語で回答します。普段の業務で使う言語で質問すると、同じ言語で回答が返ります。
</Tip>

### 質問できる内容

Clever AI がリアルタイムのデータで参照できる範囲であれば、何でも質問できます。次の例は、その幅を示したものです。

| テーマ       | 質問の例                                                  |
| --------- | ----------------------------------------------------- |
| 消込        | 売上と銀行の残高が一致しないのはなぜですか。先週の注文あたりの純収益はいくらでしたか。           |
| キャッシュフロー  | 支払い済みの注文からキャッシュフローを予測してください。                          |
| チャネルと決済手段 | Shopify の売上を決済手段ごとに分けてください。再購入につながっている決済手段はどれですか。     |
| 顧客        | 最も価値の高い顧客のうち、動きが止まっているのは誰ですか。初回購入の顧客は最初の2週間でどう行動しますか。 |
| 早期の警告     | 返金が急増している箇所はありますか。在庫が少なくなっている商品はどれですか。                |
| キャンペーン    | 現在のキャッシュバックキャンペーンは、その前のキャンペーンと比べてどのような成果ですか。          |

<Tip>
  すでに起きた変化の説明ではなく、これから加える変更を試算したい場合は、[Forecaster](/ja/clever-ai/forecaster) を使用してください。価格、インセンティブ、ロイヤルティの変更による結果を、予算を投じる前にリアルタイムのデータに対して予測できます。
</Tip>

## Clever AI が読み取るデータを選ぶ

既定では、Clever AI は Hello Clever アカウントにある決済データと顧客データから回答します。対象を広げるには、ストアを接続します。

ストアの接続は、売れた金額と精算された金額の差を埋めるための手順です。Shopify と WooCommerce は何が売れたかを示します。Hello Clever は実際に銀行口座へ入った金額を把握しています。両方が接続されていれば、Clever AI は片側だけのデータで回答するのではなく、両者を突き合わせて差異を説明できます。

<Steps>
  <Step title="Data connectors を開く">
    入力欄の横にある **+ Data connectors** を選択します。
  </Step>

  <Step title="接続済みのソースをオンまたはオフにする">
    **Connected** の下で、質問に含めるソースをオンにし、除外するソースをオフにします。ソースは、ストア名など、設定時に付けた分かりやすい名称で一覧表示されます。
  </Step>

  <Step title="新しいコネクターを追加する">
    **Add new data connector** の一覧からプラットフォームを選択します。Shopify、WooCommerce、API Connection は現在利用できます。Google Drive と Dropbox は **Coming soon** と表示されます。

    ストアのコネクターの設定には、プラットフォーム側での作業がいくつか必要です。[Shopify コネクター](/ja/clever-ai/shopify-connector)または [WooCommerce コネクター](/ja/clever-ai/woocommerce-connector)のガイドに従い、完了後にこの手順に戻ってください。
  </Step>

  <Step title="質問に適用されていることを確認する">
    選択した各ソースは、入力欄の上にチップとして表示されます。質問する前に外す場合は、チップの **x** を選択します。
  </Step>
</Steps>

<Tip>
  新しいストアを接続した後、Clever AI が初回のデータ同期を完了するまで最大 24 時間かかることがあります。それまでは、そのストアに関する回答は不完全になります。
</Tip>

## インサイトを読んで行動する

右側の **Insights** フィードに表示される内容はすべて自動的に生成されたもので、質問する必要はありません。Clever AI が生成するインサイトの種類と生成方法は、[Actionable Insights](/ja/clever-ai/actionable-insights) を参照してください。

インサイトはいずれも同じ構成です。検知したシグナル、そのシグナルが重要である理由となるコンテキスト、推奨されるアクション、そしてそのアクションを開始するボタンです。

| 構成要素       | 例                                             |
| ---------- | --------------------------------------------- |
| シグナル       | Sydney CBD の拠点の取引件数が、通常の月曜午後より 45% 多くなっています。  |
| コンテキスト     | 地域の消費者の活動から、購入意欲の高い新規顧客の層がその地域で活動していると考えられます。 |
| 推奨されるアクション | 今後 60 分間、5% のフラッシュキャッシュバックを実施し、その場での転換を獲得します。 |
| アクションのボタン  | **Create time-based cashback campaign**       |

<Steps>
  <Step title="見出しを読む">
    太字のタイトルが要点です。たとえば *Boost Sales: Reactivate 73 Dormant Customers, 85.90% Revenue at Risk* のように表示されます。
  </Step>

  <Step title="説明を読む">
    その下の段落では、Clever AI がそのインサイトを提示した理由と、行動した場合に見込まれる効果を説明します。
  </Step>

  <Step title="ワンクリックで行動する">
    下に黒いボタンが付いたインサイトは、単なる指摘ではありません。**+ Create Cashback Campaign** などのボタンを選択すると、関連する情報があらかじめ入力された状態で、推奨されたアクションの設定に直接進めます。その後の流れは[キャッシュバックキャンペーン](/ja/portal/cashback-campaigns)を参照してください。
  </Step>
</Steps>

<Tip>
  インサイトは、その性質上、時間の制約があります。離反の兆候や需要の急増は、Clever AI が示したその期間内に対応する価値があります。週次の振り返りまで残さず、フィードをこまめに確認してください。
</Tip>

## インサイトや回答をさらに掘り下げる

前提となる内容を入力し直すことなく、詳細を確認できます。

<Steps>
  <Step title="インサイトの下の Ask を選択する">
    各インサイトのカードの下には **Ask** のリンクがあります。
  </Step>

  <Step title="追加の質問を入力する">
    そのインサイトが質問欄の上部に引用されるため、Clever AI は何についての質問かを正確に把握できます。その下に追加の質問を入力します。たとえば *how to execute* などです。引用を外す場合は、**x** を選択します。
  </Step>

  <Step title="提案された追加の質問を使う">
    回答が完了すると、**Keen to dig deeper?** のセクションに自然な次の質問が提示されます。たとえば **Show me the conversion rate by payment method** などです。いずれかを選択すると、会話を続けられます。
  </Step>

  <Step title="過去の回答をフィードから探す">
    質問とその回答は、アシスタントの名称とタイムスタンプとともに Insights パネルに記録されるため、後からさかのぼって確認できます。
  </Step>
</Steps>

## チャットの管理とフィードバック

### チャットパネルの操作

チャットパネルの左上には3つのアイコンがあります。

| アイコン | ツールチップ       | 機能                                                    |
| ---- | ------------ | ----------------------------------------------------- |
| 鉛筆   | New chat     | 新しい話題のために、新規の会話を開きます。                                 |
| きらめき | Insights     | Insights パネルを表示または折りたたみます。長い回答を読むために画面を広く使いたいときに便利です。 |
| 時計   | Chat history | 過去のすべての会話を日付ごとにまとめて一覧表示し、以前の質問を開き直せます。                |

<a id="rate-an-answer-or-flag-a-problem" />

### 回答の評価と問題の報告

<Steps>
  <Step title="インサイトや回答を評価する">
    インサイトのカードまたは完了した回答が役に立った場合はサムズアップを選択し、現在の事業に関係がない場合はサムズダウンを選択します。Clever AI はこれをもとに、次に提示する内容を調整します。
  </Step>

  <Step title="内容の誤りを報告する">
    数値が誤っていると思われる場合は、インサイトのカードにあるフラグのアイコンを選択します。これにより、Hello Clever のチームへ確認の依頼が送られます。
  </Step>
</Steps>

## 制約

<Warning>
  Clever AI の回答とインサイトは、自社の取引データ、顧客データ、接続したストアのデータから生成されます。これは推奨事項であって保証ではないため、自社のビジネス判断とあわせて活用してください。
</Warning>

* 取引履歴が限られているアカウントでは、データが蓄積されるまで回答が少なくなり、具体性も低くなります。
* Clever AI は、その質問でオンになっているソースのみを読み取ります。回答のデータが不足していると感じたら、まず **Data connectors** の選択を確認してください。
* コネクターは読み取り専用です。Clever AI は接続されたストアを分析するだけで、ストアへ書き込むことはありません。
* Clever AI はアクションを推奨し、内容をあらかじめ入力します。キャンペーンを自動で開始することはないため、確定するまで公開されることはありません。

<Note>
  Clever AI は匿名化された取引データに基づいて構築されており、プラットフォームは PCI DSS Level 1 と [SOC 2](/ja/platform-overview/compliance/soc-2-compliant) の認証を取得しています。Hello Clever がこのデータをどう取り扱うかは [AML/CTF と AI の慣行](/ja/platform-overview/compliance/aml-ctf)を、全体的な考え方は[データの取り扱い](/ja/platform-overview/compliance/how-handle-data)を参照してください。
</Note>

## 次に読むもの

* [Actionable Insights](/ja/clever-ai/actionable-insights)：Clever AI が提示するインサイトの種類と生成方法
* [Forecaster](/ja/clever-ai/forecaster)：価格、インセンティブ、ロイヤルティの変更を、確定する前に試算する
* [Shopify コネクター](/ja/clever-ai/shopify-connector)と [WooCommerce コネクター](/ja/clever-ai/woocommerce-connector)：ストアをデータソースとして接続する
* [キャッシュバックキャンペーン](/ja/portal/cashback-campaigns)：インサイトが推奨するキャンペーンを作成する
* [Merchant Portal](/ja/portal/overview)：Clever AI が示す数値の基となる Portal の画面


## Related topics

- [AI アプリをドキュメント MCP サーバーに接続する](/ja/developer-reference/docs-mcp-server.md)
- [Hello Clever とは](/ja/getting-started/introduction.md)
- [リアルタイム A2A 決済の詳細](/ja/platform-overview/payment-concepts/real-time-a2a.md)