Pendoエージェントアナリティクスは、訪問者のプロンプト、エージェントの応答、セッションのコンテキストなど、AIエージェントからの会話データを収集します。アプリケーションの構築方法によっては、いくつかのインテグレーション方法のいずれかを使ってこのデータを送信できます。
この記事では、利用可能なオプションについて説明し、ご自身の環境に最適な方法を選択するお手伝いをします。
利用可能な方法
Pendoは、エージェントアナリティクスデータを送信するための以下の方法をサポートしています。
-
クライアント側（Pendo Web SDK）。
trackAgent()メソッドを使用して、ブラウザベースのAIインターフェイスから会話データを自動的にキャプチャします。Pendo Web SDKが必要です。 - サーバー側（HTTP API）。バックエンドから標準的なHTTPリクエストを使って会話データを直接送信します。モバイルアプリ、バックエンドサービス、およびPendo Web SDKが利用できない環境では必須です。
- Python SDK（ベータ版）。PythonベースのAIエージェントが会話とトレースデータをPendoに送信するように導入します。Pendo Web SDKは不要です。
- TypeScript SDK（ベータ版）。TypeScriptベースのAIエージェントが会話とトレースデータをPendoに送信するように導入します。Pendo Web SDKは不要です。
また、Pendo setup-agent-analyticsスキルをClaude CodeやCursorのようなAIコーディングアシスタントと組み合わせて、正しい導入を自動的にコードベースに追加することもできます。このスキルはクライアントサイドとサーバーサイドの両方の手法をサポートします。
方法を選択する
トレースや実行の詳細など、エージェントの全体像を把握したい場合は、Python SDKまたはTypeScript SDK（ベータ版）を使用してください。これらのSDKは会話イベントとトレースデータをPendoに送信します。
この表を使用して、お使いのシステムに最適なインテグレーションを見つけてください。
| 方法 | 最適な用途 | Web SDKの必要性 | 会話 | ユースケース | 問題 | トレースデータ |
|---|---|---|---|---|---|---|
| プロンプトのみ | コードへのアクセス権限を持たない拡張アプリ（例：Agentforce） | はい✅ | いいえ ❌ | はい✅ | いいえ ❌ | いいえ ❌ |
| クライアント側（Conversations API） | ブラウザベースのAIインターフェース | はい✅ | はい✅ | はい✅ | はい✅ | いいえ ❌ |
| サーバー側（HTTP API） | モバイルアプリ、バックエンドサービス、非ウェブ環境（例：CLIや音声エージェント） | いいえ ❌ | はい✅ | はい✅ | はい✅ | いいえ ❌ |
| Python SDK（ベータ版） | PythonベースのAIエージェント、トレース機能による完全な可視性を必要とするチーム | いいえ ❌ | はい✅ | はい✅ | はい✅ | はい✅ |
| TypeScript SDK（ベータ版） | TypeScriptベースのAIエージェント、トレース機能による完全な可視性を必要とするチーム | いいえ ❌ | はい✅ | はい✅ | はい✅ | はい✅ |
ヒント：setup-agent-analyticsスキルを使用すると、上記のクライアント側またはサーバー側のオプションを実装できます。
これらの方法はすべてエージェントアナリティクスデータを直接Pendoプラットフォームに送信するため、パス、ファネル、セッションリプレイで既存のプロダクトデータとともにAIエージェントのアクティビティを分析できます。
会話イベントとトレースデータの違い
すべてのインテグレーション方法では会話イベントを送信できます。会話イベントとは、訪問者が送信するプロンプトと、エージェントが返す応答のことです。これはエージェントアナリティクスの基盤であり、ユースケースの検出、問題の特定、会話のレビューを可能にするものです。
トレースデータはより詳細な情報を提供します。トレースを送信すると、Pendoは、実行したステップ、呼び出したツール、使用したモデル、エラーが発生した場所など、エージェントの内部実行をキャプチャします。
トレースとは何か、そしてPendoでトレースを表示する方法の詳細については、「エージェントトレースの理解と確認」を参照してください。
実装手順
手順ごとの設定方法については、お使いの方法に関する記事をご覧ください。
- クライアント側またはサーバー側のAPIを使用して会話イベントを送信する
- Python SDKをインストールして会話とトレースデータを送信する
- TypeScript SDKをインストールして会話とトレースデータを送信する
- AIスキルを使用して会話APIの実装を自動化する
共通の要件
どの方法を使うにしても、必要なものは以下の通りです。
- Pendoでエージェントの全会話が有効化されていること。設定手順については、「PendoでのAIエージェントの追加と設定」を参照してください。
- 導入したいエージェントのエージェントID。これを見つけるには、［プロダクト］>［エージェントアナリティクス］に移動し、エージェント名の横にある設定アイコンを選択します。
- プロダクトのコードベースへのアクセスと、変更をデプロイできる開発者環境。
処理と可視性
会話データは1時間ごとにバッチ処理されます。コードが本番環境で稼働した後、通常、次のバッチ処理が開始されてから15分以内に新しいメッセージが表示されます。エージェントを選択し、［会話］タブを開くと、［プロダクト］>［エージェントアナリティクス］からデータを確認できます。
エージェントアナリティクスデータの探索に関する詳細は「AIエージェントとのやり取りの分析」をご覧ください。