CitadexDocs

AI アシスタント:自社データで答え、確認してから実行

AI アシスタントは Citadex のメイン画面で、ログインするとそのまま会話が開きます。アカウントの実データを読んで質問に答え、次に押す場所を案内します。操作はカードで提示され、「実行する」を押すまで実行されません。ヘルプセンターの検索、サポートへの連絡、収益アトリビューションの接続案内もできます。

AI Assistant & API21 min read

AI アシスタントとは

AI アシスタントは Citadex に組み込まれた会話パネルです。現在のプロジェクトの実データ(可視性、プロンプト、競合、引用元、AI トラフィック、収益アトリビューションなど)を読み取って質問に答え、どのページのどのボタンを使うかを具体的に案内します。「このページは何を示しているか」「今週の状況は」「まず何をするか」といった質問に向いています。

開くとチャット

  1. ログインすると AI アシスタントの会話が開きます。左にサイドバー、中央に質問欄、その下によく使う依頼と「マイプラン」(システムが見つけたタスクと、回答の下の「プランに追加」で保存したタスク。未完了/完了に分かれ、丸をクリックで完了)があります。まだプロジェクトがないアカウントでは、先に「新規プロジェクト」が開きます。
  2. サイドバーのページ(ダッシュボード、プロンプト追跡、引用ソースなど)をクリックすると、サイドバーの右にそのページ全体が開き、サイドバーはそのまま残ります。「新しい会話」や最近の会話で会話に戻ります。ページへのリンク(ブックマーク、メールのリンク)を直接開いたときも同じく、サイドバーの右にページが表示されます。再読み込みすると直前に見ていた画面に戻ります。
  3. アシスタントは今いるページを把握して回答します。ページの「AI に聞く」は会話に戻って質問をそのまま送ります。

AI アシスタント:左にサイドバー(新しい会話、成果物ライブラリ、よく使うページ、プロジェクト、最近の会話)、中央に質問欄と今週まずやること

AI アシスタント:左にサイドバー(新しい会話、成果物ライブラリ、よく使うページ、プロジェクト、最近の会話)、中央に質問欄と今週まずやること

何を聞けるか

新しい会話では、今いるページに合わせた質問の候補が表示されます。クリックするだけで質問できます。よく使われる質問:

  • このページは何を示していますか?まず何をすべき?
  • 今週、AI の回答でのブランドの状況は?
  • 競合は言及されて自社は言及されないプロンプトは?
  • AI がよく引用するサイトは?どこで露出を狙うべき?
  • AI に引用されているのに訪問がないのはなぜ?
  • 米国で ChatGPT に推薦されないのはなぜ?(商品やカテゴリ、例えば香水を指定しても構いません)
  • AI 経由の売上が変わった理由は?AI 経由の訪問が注文につながらない理由は?
  • 注文につながっているプロンプトは?AI に読まれているのに引用されないページは?
  • 新しい市場(国と言語)の追加方法は?

こうした「なぜ」の質問には、プロジェクトのデータを順に確認し、具体的な数値を添えて回答します。データが足りない場合は、何が不足していてどう補えばよいかを伝えます。売上データやクローラーログを接続すると、チャットのホーム画面の質問候補にこれらが優先して表示されます。「収益アトリビューション」と「AI トラフィック」では、売上が大きく変化した数値の横や、訪問があるのに注文がない行、読まれているのに引用されないページの行に「理由は?」ボタンがあり、画面の数値を添えてアシスタントに質問できます。

回答の下には「データ:」として、読み取ったデータ(AI 可視性、引用元、AI トラフィック、収益アトリビューション、今週のタスクなど)が表示されます。続けて「こんな質問もできます」に次の質問の候補が並びます。

回答は自社のデータに基づきます

  • アシスタントはアカウントのデータだけを使い、数値・プロンプト・競合について話す前に必ずデータを読み取ります。
  • まだデータがない項目(未スキャン、AI トラフィック未接続など)は、そのことと、データを用意する方法を伝えます。
  • クレジット数や料金は答えません。必要な場合はクレジットや料金のページへのリンクを示します。

操作を頼む:先に確認、そのあと実行

「成果が最も低いプロンプト 5 件を再チェックして」「今週のページの修正リストを作って」のように、操作を頼むこともできます。すぐには実行されず、回答の下に「確認待ちの操作」カードが表示されます。

  1. 1

    各項目を確認する

    「n 件のプロンプトを再チェック」「記事の下書きを作成」「n 件のプロンプトを追跡に追加」「修正リストを作成」「修正済みにして再測定を開始」など、何をするかが書かれ、「クレジットを使用」または「クレジット不要」が表示されます。プロンプトの追加自体はクレジットを使いませんが、初回チェック分の残高が必要で、足りないと追加されません。

  2. 2

    実行するものを選ぶ

    不要な項目はチェックを外します。

  3. 3

    「実行する」を押す

    このボタンを押すまで何も始まりません。やめる場合は「キャンセル」を押します。

  4. 4

    結果を見る

    カードが「実行結果」に変わり、各項目の「見る」から該当ページ(プロンプト追跡、コンテンツ、再テストなど)へ移動できます。

クレジットを使う操作の消費は、アプリでボタンを押した場合と同じで、失敗したときは返却されます。残高が足りない場合、その項目はカードに入らず、アシスタントが理由とチャージ先を伝えます。記事の公開、支払い、アカウントや請求の設定変更はアシスタントでは行わず、各ページで操作します。ワークスペースの閲覧者は操作を実行できません。

アシスタントに頼めること

いずれもカードで提示され、確認してから実行されます。

  • プロンプト:追加(グループに直接入れる、追加後すぐチェックも可)、再チェック、一時停止・再開、削除(ゴミ箱へ、30 日間復元可)、チェック頻度の変更(毎日・毎週・毎月)、グループへの整理・移動。
  • 競合とマーケット:競合の追加・削除、マーケット(国と言語)の追加。
  • レポート:今月・先月・直近 30 日の成果レポートを作成し、共有リンクを表示。
  • コンテンツとページ:記事の下書き、修正リスト、どのページがどのプロンプトを担当するか、ページ修正済みの記録と再測定の開始。

チャットモード:開くとチャット

  • Citadex はチャットモードで開きます(チャットアプリのような画面です)。ダッシュボードを開くと会話が、ほかのページへのリンクを開くとサイドバーの右にそのページが表示されます。
  • 左側はサイドバー 1 つだけです:「新しい会話」「成果物ライブラリ」(アシスタントが作ったレポート・記事・リスト。まだ何もないときは、何が入るかの説明と「最初の 1 つを作ってもらう」、すぐ使える 3 つの依頼(記事を書く・レポートを作る・目標を決める)が表示されます)、その下によく使うページ(標準ではダッシュボード、プロンプト追跡、引用ソース、競合)。その他のページと「毎週自動」は「その他」にあり、「その他」の下の「サイドバーを編集…」で外に出すページを選べます。さらに「プロジェクト」(クリックで切り替え、+ で新規作成。プロジェクトにマウスを合わせてゴミ箱アイコンを押すと、名前を入力して削除できます)と「最近」の会話、いちばん下にアカウントメニュー(設定、サブスクリプション、チーム、サポートに連絡、ログアウト)があります。サイドバーは閉じられ、スマートフォンでは左上から開きます。
  • 新しい会話の最初の画面は「今日は何を進めますか?」と大きな入力欄です。入力欄の薄い文字は質問の例を順に表示します。入力すると左下に「Enter で送信 · Shift / Option + Enter で改行」(Windows では Alt)と表示され、回答中は送信ボタンが四角になり、クリックすると止められます。よく使う指示は入力欄左下の + にあります。入力欄の下の「📁 プロジェクト名」を開くとプロジェクトの切り替えや新規作成ができ、その隣が「アプリを接続」です。
  • 入力欄の下にはよく使う依頼が並びます。クリックすると入力欄に入るので、直してから送信できます。候補は数秒ごとに自動で入れ替わり(マウスを乗せている間は止まります)、端のボタン(「別の候補」)ですぐに次の候補を表示します。どの組にも流入や売上に関する依頼が 1 つ入ります(AI からの訪問数、サイトに来ている AI クローラー、AI がもたらす売上など)。その下の「プロジェクト開始前にやること」には、現在のプロジェクトで先に済ませる 4 項目(プロンプトを追加:プロジェクト作成時に自動で入ったもの以外・競合を設定:競合リストに 1 件以上・ブランドナレッジを入力:資料が 1 件以上処理済み・市場ヘルスと修復:プラットフォームを 1 件以上進捗ありにする)があります。「プロンプトを追加」はその場でプロンプト追跡と同じ追加ウィンドウが、「競合を設定」は競合リストが、「ブランドナレッジを入力」はその場でブランド情報チェックの「ナレッジベース」が開き、ほかの項目はそのページが開きます。4 項目すべて終わるとこのカードは表示されなくなります。「閲覧者」には表示されません。最後が「マイプラン」です。システムが見つけたタスク(種類のタグ付き)と、回答の下の「プランに追加」や下の入力欄で追加した自分のタスクが「未完了」「完了」に分かれて並びます。丸で完了/未完了を切り替え、タスクをクリックするとアシスタントが引き継ぎ、「根拠」「開く」で右側にそのページを表示します。
  • サイドバーのナビゲーション(よく使うページ、「その他」のページ、通知、新規プロジェクト、アカウントメニュー)は、サイドバーの横にページ全体を開きます。サイドバーはそのまま残ります。「新しい会話」、最近の会話、「成果物ライブラリ」「スタートガイド」「毎週自動」でチャットに戻ります。スマートフォンではページ上部のバーの左のボタンでサイドバーを開きます。回答内のリンク、「根拠」、完了した結果は右側のパネルで開き、会話から離れません。パネル内のページでダイアログを開くと、ウィンドウ全体の中央に表示されます。パネルは複数のタブを持てます。端をドラッグして幅を変え、✕ で閉じます。閉じた後は上部にタブ数が表示され、クリックで再表示できます。タブ右側の ↗「ページ全体を開く」はそのページをチャットの位置に開き、サイドバーはそのまま残ります。
  • 代理店のスタートガイドは「最近」の最初の会話「スタートガイド」で、進捗が表示されます。アシスタントが 1 ステップずつ案内します:なぜ、どうやるか、完了条件。「「…」へ移動」で右側にそのページを開き、操作する場所を囲んで示します。ステップが完了するとこの会話で知らせ、次のステップを示します。上部の「すべてのステップ」から任意のステップへ移動でき、質問はその下に入力します。
  • 会話を開くと、上部にそのタイトル(最初の質問の 1 文目)が表示されます。クリックすると「名前を変更」または「会話を削除」ができます。
  • スマートフォンでは右側のパネルが全画面で開き、「会話に戻る」で会話に戻ります。
  • 右側パネルで開いたページは、上部バーの左側にそのページのタブが並びます(入りきらないものは「その他 ▾」)。タブのないページはプロジェクト名を表示し、あまり使わないボタンは「⋯」に入ります。全画面で開くと、バーには「プロジェクト / ページ」とすべてのボタンが表示されます。

アプリを接続:すべての接続を 1 か所で

  • チャットモードでは、入力欄の下、プロジェクト名の右にある「アプリを接続」に、このプロジェクトで接続できるものがすべて並びます:検索と分析(Google、Bing IndexNow)、AI 流入(サイト計測タグ、Cloudflare、Vercel、WordPress クローラー計測プラグイン、Next.js・Netlify・その他のサーバー)、売上アトリビューション(HubSpot CRM、Salesforce、Stripe、Shopify の注文、WooCommerce、Webhook / API)、公開先(Citadex Publisher 拡張機能、WordPress、Ghost、HubSpot CMS、GitHub、Shopify ブログ、Webflow、Wix、Zapier · Make · n8n、ホスト型ブログ、コンテンツ API / RSS)、通知と AI ツール(Slack、API と MCP)、AI モデル(自前の API キー:OpenAI・Anthropic・Google Gemini・Perplexity・xAI・Qwen のキー。所有するすべてのプロジェクトに適用され、キーを登録したモデルのチェックはクレジットを使いません)。
  • 接続済みのものが一番上に表示され、ボタンにそのロゴと数が出ます。上部で検索できます。「未完了」は、入力済みでもテストがまだ、最初のデータ待ち、またはドメインの確認中という意味です。
  • どれかをクリックすると詳細が開きます。左は何を読み取りどこで使うか、右はその接続の設定(接続・切断・サイトやプロパティの選択・コードのコピーなど)で、元のページと同じものです。「ページ全体で開く」で元のページに移動します。
  • Google は 1 つの接続です。Search Console と GA4 は 1 回の認可を共有し、切断すると両方とも切れます。すべてのプランで接続でき、認可はワークスペースのオーナーが行います。
  • 公開先の接続にはワンクリック公開に対応したプランが必要です。「連携」ページのカードからも同じ詳細画面が開きます。AI トラフィックの「データ元」や収益アトリビューションの「売上データ元」の行のラベルも同じで、そのページのまま開きます。
  • 回答にまだ接続していないデータが必要なとき(ストアも CRM も未接続で AI の売上を聞いたときなど)、アシスタントは回答の下に「アカウントを接続」カードを出します。接続ごとに 1 行あり、「接続」で同じ詳細画面が開き、進み具合が「n / m」で表示されます。接続できたら「続ける」を押すと、アシスタントがさっきの質問に答え直します。

WordPress プラグイン:ワンクリックで接続

WordPress サイトには Citadex プラグインを使えます。連携 → WordPress クローラー計測プラグイン から citadex.zip をダウンロードし、WordPress の「プラグイン → 新規追加 → プラグインのアップロード」でインストールして有効化します。次に「設定 → Citadex」で「Connect to Citadex」を押し、ログインしてこのサイトのプロジェクトを選べば接続完了です。キーのコピーは不要です。機能ごとにオン・オフできます:AI クローラーの訪問を Citadex に送る、Citadex のサイトスクリプトを追加する(AI の回答から来た訪問者と成約を計測)、Citadex でオンにした最適化版ページを AI クローラーに表示する、AI エージェントが行った WooCommerce の注文に目印を付ける(Beta)。WordPress のダッシュボードには、直近 30 日の AI 回答での言及率、AI クローラーの訪問、AI からの訪問者を示す小さなカードが表示されます。すべて無料アカウントで使えます。接続済みのサイトは WordPress のダウンロードボタンの下に表示されます。

HubSpot:AI 流入元の書き戻し、レコードカード、Breeze エージェント

連携 → HubSpot CRM で HubSpot にログインして接続したら、「AI 流入元を HubSpot に書き戻す」をオンにできます。Citadex は HubSpot にプロパティグループ「Citadex AI attribution」を作り、各コンタクトの最初の AI エンジン・最初の AI 訪問・AI 訪問回数・ランディングページ・根拠レベルと、各取引の AI 収益区分・AI エンジン・AI に帰属する金額を書き込みます。同期のたび(30 分ごと)に変化したレコードだけを書くので、営業はレコード上で確認でき、HubSpot のレポートでもこの項目で集計できます。認可時に書き込み権限を許可してください。プライベートアプリのトークンの場合は、プライベートアプリに書き込み権限を追加します。

HubSpot に Citadex アプリを入れると、コンタクトと取引のレコードに「Citadex AI source」カードが表示されます。そのレコードが AI の回答から来たか、どのエンジンか、いつ、どのページか、取引なら AI に帰属する金額と根拠レベルが分かります。Breeze エージェントに Citadex のツールを追加すると、AI 可視性、診断(なぜ AI が推薦しないか、なぜ競合が先行しているか)、AI 収益、レコードごとの AI 流入元を直接聞けます。ツールは読み取りのみで、クレジットは使いません。HubSpot ユーザーのメールアドレスで Citadex のプロジェクトを見られる(オーナーまたはチームメンバー)場合だけデータが表示されます。

記憶:確認したことだけを覚えます

質問欄の下、「アプリを接続」の隣に「記憶」があり、数字は現在のプロジェクトでアシスタントが覚えている件数です。覚えるのはあなたが確認したことだけです。チャットで「覚えて:私たちは『最安』とは言わない」と伝えると「覚える」カードが出て、確認してから保存します。「記憶」から直接追加もできます。ブランド(ワークスペース共通:ブランド名、提供しているもの、決して言わないこと)、プロジェクト(重点市場とエンジン、目標)、あなただけ(例:結論から先に)の 3 層です。週次プランや更新で採用しなかった提案は 60 日間記録され、その間は同じ提案をしません。AI の回答、Web ページ、パスワードは覚えません。「記憶」からいつでも編集・削除できます。閲覧者は自分の層だけ変更できます。

Citadex で完了したこと(今週のタスクの「完了」、マイプランのチェック、承認して実行した修正、公開した記事、再テスト)は、約 3 週間後に AI の推薦状況を前後で自動比較します。はっきりした結果はプロジェクトの記憶の「実施したことと効果」に残り(削除のみ可、編集不可)、「アシスタントのフォローアップ」がオンならチャットでお知らせします。以降の提案はこの結果を踏まえます。効果があったやり方は再び提案し、効果がなかったものは別の方法に切り替え、今週のタスクには同じプロンプトの前回の結果も表示します。前後の比較であり、その変更が原因だと証明するものではありません。アシスタントに「やったことは効果があった?」と聞くこともできます。

コマンドライブラリ:よく使う質問と操作

新しい会話では、場面別のコマンドライブラリが表示されます:「よく使う」「このページ」「はじめに」「整理」「競合」「コンテンツ」「レポート」「アカウント」。各項目に内容と「無料」「クレジット」「質問」の区別があり、クリックするだけで送信されます。

ひとことで複数のステップ

「中国マーケットのプロンプトが少ないので 20 件追加して、チェックして、月次レポートを作って」のようにまとめて頼めます。アシスタントはデータを確認して理由を説明し、各ステップを 1 枚のカードにまとめます。「チェック完了後にレポートを作成」のように待つステップは、確認後「チェック完了後に自動で実行」と表示され、終わると自動で完了し、ベルに通知が届きます。

会話履歴

  • これまでの会話は左のサイドバーの「最近」にあり、選ぶと続きから話せます。
  • 会話にカーソルを合わせ、ごみ箱のアイコンで「削除」できます。
  • サイドバー上部の「新しい会話」で新しく始めます。
  • 毎週のプランも「最近」に会話として届き、未読の間はその会話に赤い点が付きます。
  • 「自動化 → 今週のテーマ」をオンにすると、毎週月曜 9:00 にテーマのレポートが届きます。買い手が公開の場で話している質問を最大 10 件、根拠のリンク(Reddit の議論、記事、調査)付きで、「ユーザーが直接質問」か「議論から推定」かも示します。会話には上位 3 件が表示され、「すべてを見る」で全体と過去の週を確認できます。各テーマは「追跡に追加」「プランに追加」ができます。メールも届きます(同じ画面でオフにできます)。テーマが見つかったときだけ、実際の調査コストに応じて少しクレジットを使い、クレジット明細の「AI アシスタント」に記録されます。
  • 「自動化 → 広告ウォッチ」をオンにすると、あなたの質問の横の ChatGPT 広告に変化(競合の出稿開始、新しい広告主、自社広告の消失)があったとき、アシスタントがチャットで原因と次の一手を説明し、ベルでもお知らせします。詳細は「収益アトリビューション → AI 広告」。
  • アシスタントが実行したこと(確認した操作とその結果)はサイドバーの「成果物ライブラリ」にあります。
  • 「操作履歴」に切り替えると、AI アシスタントが実行したすべての操作(内容・日時・プロジェクト・確認した人)を確認できます。完了したものは「見る」で結果を開けます。プロジェクトのオーナーは、チームメンバーがアシスタントで行った操作も見られます。

ヘルプセンターとサポート

  • 「どうやるか」「どこにあるか」という質問には、内蔵のアプリガイドで答えます。ガイドにない内容はヘルプセンターを検索し、記事に基づいて答え、記事へのリンクを付けます。
  • 上部の「サポートに連絡」はサポートフォームを開き、担当者に届きます。不具合、支払いの問題、アシスタントで解決しなかった場合に使ってください。

収益アトリビューションの接続を案内

「連携」で収益ソース(HubSpot CRM、Salesforce、Stripe、Shopify の注文、WooCommerce、Webhook / API、ChatGPT Ads など)を開くと、ダイアログに 2 つの入口があります。

  • 「詳しい手順」:クリック手順をすべて表示します。
  • 「AI アシスタントの案内で接続」:質問が入力された状態でアシスタントが開き、相手側の管理画面でどこを押し、何を選び、何をコピーして戻るかを順番に案内します。収益データを接続する前にサイトスクリプトを入れるよう必ず案内します。スクリプトがないと、収益を AI からの訪問と結び付けられないためです。

Shopify ストアは Citadex の Shopify アプリをインストールするのがいちばん簡単です。連携 → Shopify の注文 でストアのアドレス(your-store.myshopify.com)を入力し、「Citadex アプリをインストール」を押して Shopify で承認すれば完了です。Webhook やシークレットのコピーは不要です。接続後、支払い済みの注文が自動で収益アトリビューションに入り(直近 60 日分は一度だけ読み込み)、商品情報は毎日と編集のたびに更新されます。アシスタントは、AI が同じジャンルの商品を推薦するときによく挙げる情報(価格・素材・サイズ・保証・返品・認証・原産地・対象・評価など)、そのうち自社の商品ページに欠けているものとその商品、AI がそれらの情報をどの競合に結び付けているかを教えます。「商品情報に足りないものは?」とアシスタントに聞くこともできます。Shopify でアプリを削除すると接続は自動で解除されます。

エージェント注文(Beta):AI エージェント(ChatGPT のエージェントモードなど)が顧客の代わりにストアで注文したとき、その注文を分けて集計できます。Shopify の注文 のダイアログの「エージェント注文の目印(Beta)」の「設定」を押し、生成されたコードを Cloudflare Worker としてデプロイし、ストアのドメインにルートを追加します(Citadex のサイトスクリプトが必要です)。以後、署名付き AI エージェントの訪問がそこに表示され、その注文は概要の「AI 収益・6 区分」の「エージェント注文」に入ります。署名で分かるのはどの会社のエージェントかで、誰のために買ったかではないため、「可能性が高い」と Beta で表示します。最初のエージェント注文が届くと、アシスタントが対話でお知らせします。

ChatGPT / Claude で Citadex を使う

質問欄の左下の + メニューのいちばん下にある「ChatGPT / Claude で Citadex を使う」を押すと、接続方法を順番に案内し、接続後にそのまま聞ける質問の例を示します。詳しくは「ChatGPT・Claude で Citadex を使う(API と MCP)」をご覧ください。

よくある質問

アシスタントとの会話でクレジットは使いますか? はい。回答ごとに、実際に使ったモデルの量に応じて消費し、失敗した回答は消費しません。すべてクレジット履歴の「AI アシスタント」に記録され、回答の前に確認は出ません。スキャンや記事作成などの操作は、これまでどおりカードで「実行する」を押すまで実行されません。クレジットがなくなるとアシスタントは回答を止め、チャージすると再開します。

質問回数に上限はありますか? 1 日あたりの上限があります。上限に達すると「本日の質問回数の上限に達しました。明日またどうぞ。」と表示されます。

回答の言語は? 画面の言語に合わせます。プロンプトとブランド名は元のまま表示します。

「AI アシスタント」ボタンが表示されません。 代理店のクライアントアカウントの場合、代理店がこの機能を有効にしていない可能性があります。

Was this article helpful?