1. Pendoヘルプセンター
  2. エージェント分析
  3. データ取得（収集）の設定を行う

PendoでAIエージェントを追加して設定

最終更新日:

この記事では、PendoにAIエージェントを追加し、設定する方法を説明します。データキャプチャの仕組みや両手法の比較については、「エージェントアナリティクスの概要」をご覧ください。設定後の会話データの探索や利用傾向の分析については、「AIエージェントとのやり取りの分析」を参照してください。

前提条件

AIエージェントを追加して設定するには、次の手順を実行する必要があります。

  • エージェントのバージョンが2.300.0以上であること。
  • サブスクリプション管理者であるか、AI エージェント管理者の役割が割り当てられている必要があります。

重要：Agentアナリティクスは、Pendo がインストールされていてコードを実行できるアプリケーション内で実行される AI エージェントからのみデータを収集できます。AI エージェントがサードパーティのプラットフォーム（Zendesk や Intercom など）から提供されている場合、エージェントアナリティクスは、そのプロバイダがエージェントエクスペリエンスに Pendo をインストールすることを許可している場合にのみ、顧客との対話データを収集できます。d

AIエージェントを追加する

まずはエージェント詳細フォームに記入してください。アプリケーションを選択した後の次のステップは、そのアプリがPendoでどのように設定されているかによって異なります。

  • ウェブアプリやモバイルアプリは直接Conversations APIの設定にルーティングします。
  • ブラウザ拡張機能アプリでは、続行するにキャプチャタイプ（プロンプトのみか全会話）を選択する必要があります。

エージェントを追加するには：

  1. ［プロダクト］>［エージェントアナリティクス］に移動し、［+ エージェントを追加］を選択してください。
  2. エージェント詳細フォームに記入してください。これらのフィールドを組み合わせることで、Pendoはこのエージェント向けにAIを活用した洞察と分析をカスタマイズするために必要なコンテキストを得ることができます。明確で具体的な詳細により、プロンプトのグループ化やエージェントアナリティクスでのインサイトの提示が改善されます。これらのフィールドは後でエージェントの設定から更新できます。
    • エージェント名。Pendo全体でこのエージェントを識別するためのラベル。
    • エージェントの役割。エージェントの作業についての簡単な説明。
    • プライマリユーザー。このエージェントとやり取りする人。
    • エージェントの目的。エージェントがユーザーのために行う作業をできるだけ詳しく説明してください。例えば、エージェントがどのような質問に答えるか、どのようなタスクを支援するか、どのように行うかなどです。具体的であればあるほど、Pendoは関連するプロンプトをまとめ、関連するインサイトを得やすくなります。
    • アプリケーション。このエージェントが存在するアプリケーション。この選択によって次のステップが決まります。
  3. ［エージェントを追加］を選択し、上記のアプリの種類に応じた手順に従ってください。

Conversations APIを設定する

このセクションは、ウェブアプリとモバイルアプリ、および会話全体をキャプチャするように設定されたブラウザ拡張アプリに適用されます。

完全な会話をキャプチャするには、データ収集を開始する前に開発者がConversations APIを実装する必要があります。実装が完了するまでPendoにはデータが表示されません。

  1. ［エージェントを追加］ウィザードで［設定手順をコピー］を選択します。これはすぐに使えるチケットの説明をコピーしたもので、以下が含まれます。
    • エージェントID（事前入力済み）。
    • 詳細なセットアップ手順へのリンク。
    • 実装方法は2つあります。Pendoのsetup-agent-analytics AIスキルを使用してセットアップを自動化する方法（Claude CodeまたはCursorユーザー向け）、またはサーバーサイドの会話APIを使用してバックエンドからイベントを送信する方法です。
    • 開発者の受け入れ基準。

      AgentAnalytics_AddAgent_CopySetupInstructions.png
  2. コピーした説明文をJira、Linear、またはチームが開発作業を追跡しているシステム上のチケットに貼り付け、エンジニアリングチームに割り当ててください。
  3. ［閉じる］を選択してセットアップフローを終了します。

重要：エージェントはPendoに設定されていますが、開発者が会話APIの実装を完了するまでデータは表示されません。セットアップ手順書をできるだけ早く開発者に送ることをおすすめします。

開発者が変更をデプロイした後、エージェントアナリティクスの［会話］タブでデータが表示されていることを確認するか、エージェントのセットアップをテストするを参照してください。新しい会話は通常1時間以内に表示されます。実装の詳細については、 「Conversations APIを使用して全会話をキャプチャする」を参照してください。

エージェントにタグを付ける

このセクションは、キャプチャタイプとして［プロンプトのみ］を選択した場合、ブラウザ拡張機能アプリに適用されます。

エージェントのタグ付けは、ビジュアルデザインスタジオでのページやフィーチャーのタグ付けと同様に機能しますが、エージェントは別のイベントタイプとして扱われ、データは遡及されません。

ステップ1. ビジュアルデザインスタジオを起動する

  1. アプリ内の AI エージェントが配置されている URL を入力します。
  2. ［並べてタグ付けする］または［オーバーレイでタグ付けする］を選択し、［デザイナーを起動］を選択してデザイナーを開きます。

ステップ2. プロンプト入力フィールドにタグを付ける

  1. ［フィールドを入力（Input field）］の下で、［選択（Select）］を選びます。 AgentAnalytics_TagAgent_SelectInput.png
  2. アプリ内のプロンプト入力フィールドを選択します。
  3. プロンプト入力フィールドにタグを付けた後、ルールビルダーまたはカスタムCSSオプションを使用して、必要に応じてルールを調整します。

ステップ3. 投稿アクションにタグを付ける

エージェントに送信ボタンがない場合は、次のセクション「ステップ 4. タグ設定を定義する」に進んでください。

  1. ［送信ボタン（Submit butto）］セクションで［選択（Select）］を選択します。 AgentAnalytics_TagAgent_SubmitButton.png
  2. アプリ内のプロンプト送信ボタンを選択します。この操作で、キーボードのEnterキーまたはReturnキーを押す操作と、ボタンの手動選択の両方を取得できます。
  3. 送信ボタンにタグを付けた後、ルールビルダーまたはカスタムCSSオプションを使用して、必要に応じてルールを調整します。

ステップ4. タグ設定を定義する

  1. ［設定］で、エージェントをアプリケーション全体で保持するか（サイト全体）、このページのみで保持するかを選択します。
  2. オプションで、［詳細設定（Advanced Settings）］を開いて設定します。
    • 動的なカスタムHTML属性の値をフィルターします。サブスクリプション管理者がアプリケーション設定の「カスタムHTML属性の収集」で定義したカスタム属性の動的な見た目の値を除外します。
    • 選択時に他の動的要素をフィルタリングします。Pendoが収集する標準HTML属性（例：idやclass）の動的な値を除外します。
  3. エージェントのプロンプトのキャプチャを開始するには［保存］を選択してください。プロンプトデータは遡及して収集されず、タグ付け後のアクティビティのみが含まれます。

    AgentAnalytics_TagAgent_Save.png

エージェントの設定をテストする

AI エージェントを作成または更新したら、Pendo がデータを正しく収集していることをテストします。

プロンプトの取得を確認するには：

  1. エージェントを作成した後、構成が処理されるまで数分間お待ちください。
  2. 新しいブラウザタブを開き、AIエージェントが表示されるページを開きます。これにより、最新のPendoインストールスクリプトを読み込むことができます。
  3. ページを右クリックし、［検査］を選択し、［コンソール］タブを選択してブラウザの開発者コンソールを開きます。
  4. pendo.enableDebugging()を実行してPendoデバッガを開きます。
  5. ［イベント］タブを開き、［イベントログを開始］を選択します。

    Debugger_StartEventLogging.png
     
  6. エージェントにプロンプトを送信し、ログにプロンプトイベントとして表示されることを確認します。

    Debugger_PromptEvent.png

プロンプトイベントが表示されない場合：

  • 15分待ってからもう一度テストして、新しいエージェントの設定がPendoインストールスクリプトに適用されていることを確認します。
  • それでも表示されない場合は、セットアップに問題がある可能性があるため、インストールを再確認してください。
  • 問題が解決しない場合は、サポートチームにお問い合わせください。

エージェント設定を表示および管理する

エージェントを確認または更新するには：

  1. ［プロダクト］>［エージェントアナリティクス］に移動します。

  2. エージェント名の横にある設定（歯車）アイコンを選択します。

    AgentAnalytics_AgentSettings.png

    または、リストからエージェントを選択し、エージェントの詳細ページの右上隅にある［アクション］>［設定の編集］を選択します。

    AgentAnalytics_AgentDetails_EditSettings.png

設定ページには次の内容が含まれます。

  • エージェント名。
  • エージェントの役割。
  • プライマリユーザー。
  • エージェントの目的。
  • エージェントが割り当てられているアプリケーション。
  • アプリの種類（ウェブアプリ、モバイルアプリ、またはブラウザ拡張機能）。
  • タグ付けルールとデザイナーを開くオプション（プロンプト専用エージェント向け）。
  • 会話設定セクションには以下が含まれます。
    • エージェントID。
    • インストールスニペットの例。
    • 完全な会話を有効にする（プロンプトのみのエージェント向け）か、会話の収集を一時停止する（完全な会話をキャプチャするように設定されているエージェント向け）かを選択できるオプション。
    • インストール手順を表示リンク。
  • エージェントを追加したユーザーとその時期。
  • 最後にエージェントを更新したユーザーとその時期。
  • エージェントを削除するオプション。

注：完全な会話をキャプチャするよう設定されたエージェントが14日間データを受け取っていなければ、エージェント設定にバナーが表示され、プロンプトのみモードに戻るオプションがあります。

AgentAnalytics_AgentSettings.png

プロンプトのみのエージェントを全会話に切り替える

すでにプロンプトのみのエージェントを作成していて、会話全体をキャプチャしたい場合は、エージェントの設定から会話モードを有効にすることができます。

  1. ［エージェント設定］に移動します。
  2. ［会話］のドロップダウンの選択を［アクティブ］に変更します。

    AgentAnalytics_Settings_Conversations.png

重要：全会話モードへの切り替えは恒久的です。有効化後は、プロンプトのみのキャプチャに戻すことはできません。

会話を有効化した後、開発者はConversations APIを実装してPendoにプロンプトや応答を送信しなければなりません。必要なコード変更が完了するまでデータは表示されません。

AIエージェント管理者の役割を割り当てる

デフォルトでは、サブスクリプションの管理者はエージェントアナリティクスにアクセスし、PendoでAIエージェントとしてタグ付けされた後に訪問者が会話型UIに送信した特定のプロンプトを見ることができます。

サブスクリプション管理者で、管理者権限を持たないユーザーにプロンプトテキストを表示させたい場合は、そのユーザーにAIエージェント管理者ロールを割り当てることができます。このロールにより、ユーザーは以下のことが可能になります。

  • 訪問者が送信したプロンプトと会話を表示する。
  • タグ付けされたAIエージェントの設定を表示および編集する。
  • 新しいAIエージェントにタグを付け、既存のエージェントを削除する。

役割を割り当てるには：

  1. 左側のメニューの下部から［設定］>［ユーザーとチーム］にアクセスします。
  2. この役割を割り当てたいユーザーを見つけてください。［ユーザー］テーブルでその行にカーソルを合わせ、右端にある編集（鉛筆）アイコンを選択します。

    Users_Edit.png
  3. ［アプリレベルの役割］セクションで、この役割を割り当てたい各アプリケーションが左側のパネルでチェックされていることを確認してください。
  4. 右側のパネルで［AIエージェント管理者］を選択します。
  5. ［変更を保存する］を選択し、この役割を割り当てたいユーザーごとにこれらの手順を繰り返します。
この記事は役に立ちましたか？
4人中3人がこの記事が役に立ったと言っています

このセクションの記事