この記事では、Agent Toolkitでエージェントを設定し、Pendoに接続して、エージェントで使用できる機能を有効にする方法について説明します。Agent Toolkitの詳細については、「Agent Toolkitの概要」をご覧ください。
エージェントツールキット(エージェントツールキット)は管理者のみが利用可能です。管理者以外のユーザーには、メインナビゲーションにエージェントツールキットは表示されず、直接リンクからそのページにアクセスすることもできません。
仕組み
Agent Toolkitでは、4つのステップで構成される1つのウィザードでエージェントを設定します:
- エージェントの詳細エージェントが動作するプラットフォームを選択し、エージェントに名前を付け、アクセス可能なアプリを選択します。現在、エージェントタイプとしてIntercom Finがサポートされています。その他のカスタムエージェントも近日中にサポートされる予定です。
- MCPを接続する。ガイド、セッションコンテキスト、フィードバックの送信を支えるMCP接続を設定します。
- ウェブフックを設定する。タスクのリマインダーやフラストレーションのシグナルを支えるメッセージングプラットフォームを接続してください。
- 確認を行う。情報やコネクションを確認してからエージェントを作成します。
MCPまたはWebhookの少なくとも1つを接続する必要があります。セットアップが完了したら、エージェントのタブから個々の機能を有効化と設定します。
注:エージェントを追加または更新する際、Pendoは、すでに別のエージェントツールキットエージェントにリンクされているサービスアカウントまたはWebhookのリンクを防止します。別のエージェントにリンクする前に、既存のエージェントとのリンクを解除してください。
始める前に
Agent Toolkitでエージェントを設定するには、以下の条件が必要です:
- エージェントツールキットにアクセスするためのサブスクリプション管理者権限。これらの権限は、MCPを有効にするためにも必要です。
- サブスクリプションでWebhookが有効になっていること。エージェントのタスクナッジ機能やフラストレーションシグナル機能を設定するには、Webhookが必要です。
- Intercom Finのワークスペースがあること。
- Pendoの訪問者IDがIntercomのユーザーIDと必ず一致しているか確認すること。IDが一致しない場合は、PendoとIntercom間でID同期を有効にすることができます。手順については「PendoとIntercom間のID同期」を参照してください。
重要:IDがすでに一致していない場合、Finはそれらの訪問者を認識できず、その訪問者に対してエージェントの機能は動作しません。エージェント作成前または作成後にこの設定を行う方法については、「PendoとIntercom間のID同期」を参照してください。
ステップ1:AIエージェントを追加する
Agent ToolkitでAIエージェントの設定を開始するには、動画ウォークスルーをご覧いただくか、以下の手順に従ってください。
- メインナビゲーションの Agent Toolkit にアクセスします。
- [エージェントを追加(Add agent)]を選択して、設定ウィザードを開きます。
- メインナビゲーションで[エージェントツールキット(Agent Toolkit)]に移動します。IntercomのFin(Fin by Intercom)は、現時点では唯一利用できるオプションです。その他のプラットフォームも近日中にサポートされる予定です。
- エージェントの[名前(Name)]を入力し、必要に応じて[説明(Description)]も入力します。
- [アクセス可能なアプリ(Accessible apps)]で、エージェントがアクセスできるアプリを1つ以上選択します。このフィールドは必須です。
- [続行(Continue)]を選択します。
ステップ2:MCPに接続する
MCP接続により、エージェントはライブの Pendoデータを照会して、ガイド、セッションコンテキスト、フィードバックの送信に役立てることができます。これらの機能が不要な場合は、[スキップ(Skip)]を選択し、代わりにWebhookを設定します。
ウィザードに従ってIntercomでの設定を進めることができます。適切なIntercomページを開くリンクも用意されています。
注: MCPサーバーをオンにすると、サブスクリプションのMCPが有効になります。つまり、ユーザーはPendoアプリケーションの外部でPendoデータを読み書きできます。詳細については、「Pendo MCP serverの概要」を参照してください。
エージェントにMCPを接続するには、動画のウォークスルーをご覧いただくか、以下の手順に従ってください。
- ウィザードでMCPサーバーをオンにしてサービスアカウントを設定すると、エージェントがMCPサーバー経由でPendoのリアルタイムデータを照会できるようになります。
-
[接続を作成(Create connection)]で、ウィザードに表示される認証情報をコピーします。次のステップでこれらをIntercomに貼り付けます:
- OAuthトークンURL
- クライアントID
- クライアントシークレット
- 範囲
重要:クライアントシークレットは安全な場所に保存します。Pendoはウィザードを離れると、再度表示することはできません。
-
[Finで認証トークンを作成(Create authentication token in Fin)]を選択します。これでIntercomの認証設定が開きます。ウィザードの値で新しいトークンを作成します:
- タイプ:OAuth。
- HTTPS URL:ウィザードから取得したOAuthトークンのURL。
- クライアントIDとクライアントシークレット:ウィザードで取得した値。
-
範囲:
read:me。 - リクエストフォーマット:フォームエンコード形式。
Intercomでトークンをテストして、
200 OKレスポンスが返されることを確認します。 - Intercomにトークンを保存します。ウィザードに戻り、[Finで作成された認証トークン(Authentication token created in Fin)]チェックボックスをにチェックを入れます。
- ウィザードの[MCPコネクターの追加(Add MCP connector)]でMCPサーバーのURLをコピーし、[Finでセットアップ(Set up in Fin)]を選択します。これにより、Intercomのデータコネクターページが開きます。Pendo MCPサーバーを追加するための[カスタムMCP(Custom MCP)]を見つけます。カスタムMCPビューで、以下を入力します:
- 名前: 例えばPendo MCPなど、認識しやすい名前です。
- URL:ウィザードの[MCPサーバーURL(MCP server URL)]。
- 認証:前のステップで作成した認証トークンを選択します。
- ウィザードに戻り、[FinにMCPコネクタを追加済み(MCP connector added in Fin)]チェックボックスを選択します。
- [接続をテスト(Test connection)]を選択して、エージェントがPendoに接続できることを確認します。テストをお勧めします。
- [続行(Continue)]を選択します。
ヒント:FinでカスタムMCPデータコネクタを追加する手順は見落としやすいですが、追加しないとエージェントはPendoのデータにアクセスできません。
ステップ3:Webhookを使用してプロアクティブサポートを設定する
Webhook接続により、リアルタイムのPendoイベントがエージェントにプッシュされ、タスクナッジやフラストレーションシグナルなどの先手を打つサポート機能が有効になります。これにより、Intercom Finワークスペースが接続されます。これらの機能が不要で、MCPに接続している場合は、[スキップ(Skip)]を選択します。
注:MCPをスキップした場合、続行してエージェントを作成するにはWebhook接続が必要です。
Webhookを使用したプロアクティブサポートを設定するには、動画ウォークスルーをご覧いただくか、以下の手順に従ってください。
- [Intercomと接続(Connect with Intercom)]を選択して、Intercomワークスペースに接続します。これにより、新しいタブで認証ページが開き、PendoエージェントツールキットがIntercomに接続できるようになります。
- [アクセスを許可(Authorize access)]を選択します。これによりエージェントツールキットの設定ウィザードが再開されます。
- [プロアクティブサポートを接続(Connect Proactive Support)]で、OAuthを使用してIntercomに接続します。いずれかを選択します:
- 新しい接続を作成します。エージェントの名前を付けた新しいIntercom Fin Webhookを作成し、ステップ1で設定したエージェントがアクセス可能なアプリをスコープとして設定します。
- 既存の接続を使用します。エージェントと同じアプリスコープを持つ既存のIntercom Fin Webhookを選択します。存在しない場合は、新しい接続を作成するよう促されます。
-
[接続を作成(Create connection)]を選択します。これにより、Webhookが作成され、Intercom Finエージェントにリンクされます。
注:Webhookは非アクティブな状態で開始され、エージェントのセットアップ完了後にその機能(タスクナッジとフラストレーションシグナル)を設定して有効にするまでイベントは送信されません。
- [続行(Continue)]を選択します。
ステップ4:レビュー
レビューの段階で、エージェントの詳細と接続設定を確認します。MCPまたはWebhookの少なくとも一方に接続する必要があります。
エージェントを確認および作成するには、動画ウォークスルーをご覧いただくか、以下の手順に従ってください。
- 概要(エージェントタイプ、名前、アプリ、MCPステータス、Webhookステータス)を確認します。
- [エージェントを追加(Add agent)]を選択します。
Pendoはエージェントを作成し、概要ページを開き、そこで機能の有効化を始めることができます。
次のステップ
まだ行っていない場合は、ID同期の設定を完了してください。手順については、「PendoとIntercom間でIDを同期する」をご覧ください。
MCP ベースの機能を有効にすると、次のことが可能になります:
Webhookベースの機能を有効にすると、次のことが可能になります: