1. Pendoヘルプセンター
  2. エージェント分析
  3. Intercom Finインテグレーション

Agent ToolkitでFinを設定する（ベータ版）

最終更新日:

この記事では、Intercom Finで動作するエージェントを設定し、Pendoに接続して利用可能な機能を有効にする方法について説明します。

社内で開発したエージェントや設定したサードパーティのエージェントなど、カスタムエージェントを設定するには、Agent Toolkitでカスタムエージェントを設定するを参照してください。Agent Toolkitの詳細については、Agent Toolkitの概要を参照してください。

Agent Toolkitはメインナビゲーションですべてのユーザーに表示されますが、エージェントを追加および設定できるのはサブスクリプション管理者のみです。

仕組み

Fin by Intercomエージェントでは、5つのステップからなる1つのウィザードでエージェントを設定します。

  • エージェントの詳細。エージェントをFin by Intercomで実行するかカスタムエージェントにするかを選択し、エージェントに名前を付けて、アクセスできるアプリを選択してください。
  • MCPを接続する。ガイド、セッションコンテキスト、フィードバックの送信を支えるMCP接続を設定します。
  • プロアクティブサポートを設定します。Webhook経由でメッセージングプラットフォームを接続すると、ワークフローナッジやフラストレーションシグナルが有効になります。
  • 訪問者IDをIntercomと同期する。Pendoの訪問者IDとIntercomのユーザーIDがまだ一致していない場合は、選択したウェブアプリで訪問者IDの同期を有効にします。
  • 確認を行う。情報やコネクションを確認してからエージェントを作成します。

MCPまたはWebhookの少なくとも1つを接続する必要があります。セットアップが完了したら、エージェントの各タブから個々の機能を有効にして設定します。

注：エージェントを追加または更新する際、Pendoは、すでに別のエージェントツールキットエージェントにリンクされているサービスアカウントまたはWebhookのリンクを防止します。別のエージェントにリンクする前に、既存のエージェントとのリンクを解除してください。

始める前に

Agent Toolkitでエージェントを設定するには、以下の条件が必要です：

  • 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エージェントの設定を開始するには、動画ウォークスルーをご覧いただくか、以下の手順に従ってください。

  1. メインナビゲーションの Agent Toolkit にアクセスします。
  2. ［エージェントを追加（Add agent）］を選択して、設定ウィザードを開きます。
  3. ［エージェントタイプ］で、Intercom Finを選択します。エージェントが別のプラットフォームで動作している場合は、代わりにAgent Toolkitでカスタムエージェントを設定するの手順に従ってください。
  4. エージェントの［名前（Name）］を入力し、必要に応じて［説明（Description）］も入力します。
  5. ［アクセス可能なアプリ］で、エージェントがアクセスできるアプリを少なくとも1つ選択します。このフィールドは必須です。モバイルアプリと拡張アプリはサポート対象外です。
  6. ベータ版の免責事項を確認し、チェックボックスを選択してベータ利用規約に同意してください。続行する前に、免責事項に同意する必要があります。
  7. ［続行（Continue）］を選択します。

ステップ2：MCPに接続する

MCP接続により、エージェントはライブの Pendoデータを照会して、ガイド、セッションコンテキスト、フィードバックの送信に役立てることができます。これらの機能が不要な場合は、［スキップ（Skip）］を選択し、代わりにWebhookを設定します。

ウィザードに従ってIntercomでの設定を進めることができます。適切なIntercomページを開くリンクも用意されています。

注： MCPサーバーをオンにすると、サブスクリプションのMCPが有効になります。つまり、ユーザーはPendoアプリケーションの外部でPendoデータを読み書きできます。詳細については、「Pendo MCP serverの概要」を参照してください。

エージェントにMCPを接続するには、動画のウォークスルーをご覧いただくか、以下の手順に従ってください。

  1. ウィザードでMCPサーバーをオンにしてサービスアカウントを設定すると、エージェントがMCPサーバー経由でPendoのリアルタイムデータを照会できるようになります。

  2. ［接続を作成（Create connection）］で、ウィザードに表示される認証情報をコピーします。次のステップでこれらをIntercomに貼り付けます：

    • OAuthトークンURL
    • クライアントID
    • クライアントシークレット
    • 範囲

    重要：クライアントシークレットは安全な場所に保存します。Pendoはウィザードを離れると、再度表示することはできません。

  3. ［Finで認証トークンを作成（Create authentication token in Fin）］を選択します。これでIntercomの認証設定が開きます。ウィザードの値で新しいトークンを作成します：

    • タイプ：OAuth。
    • HTTPS URL：ウィザードから取得したOAuthトークンのURL。
    • クライアントIDとクライアントシークレット：ウィザードで取得した値。
    • 範囲：read:me。
    • リクエストフォーマット：フォームエンコード形式。

    Intercomでトークンをテストして、200 OKレスポンスが返されることを確認します。

  4. Intercomにトークンを保存します。ウィザードに戻り、［Finで作成された認証トークン（Authentication token created in Fin）］チェックボックスをにチェックを入れます。
  5. ウィザードの［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）］。
    • 認証：前のステップで作成した認証トークンを選択します。
  6. ウィザードに戻り、［FinにMCPコネクタを追加済み（MCP connector added in Fin）］チェックボックスを選択します。
  7. ［接続をテスト（Test connection）］を選択して、エージェントがPendoに接続できることを確認します。テストをお勧めします。
  8. ［続行（Continue）］を選択します。

ヒント：FinでカスタムMCPデータコネクタを追加する手順は見落としやすいですが、追加しないとエージェントはPendoのデータにアクセスできません。

ステップ3：Webhookを使用してプロアクティブサポートを設定する

Webhook接続により、リアルタイムのPendoイベントがエージェントにプッシュ送信され、ワークフローナッジやフラストレーションシグナルなどのプロアクティブなサポート機能が実現します。これにより、Intercom Finワークスペースが接続されます。これらの機能が不要で、MCPを接続している場合は、［スキップ］を選択します。

注：MCPをスキップした場合、続行してエージェントを作成するにはWebhook接続が必要です。

Webhookを使用したプロアクティブサポートを設定するには、動画ウォークスルーをご覧いただくか、以下の手順に従ってください。

  1. ［Intercomと接続（Connect with Intercom）］を選択して、Intercomワークスペースに接続します。これにより、新しいタブで認証ページが開き、PendoエージェントツールキットがIntercomに接続できるようになります。
  2. ［アクセスを許可（Authorize access）］を選択します。これによりエージェントツールキットの設定ウィザードが再開されます。
  3. ［プロアクティブサポートを接続（Connect Proactive Support）］で、OAuthを使用してIntercomに接続します。いずれかを選択します：
    • 新しい接続を作成します。エージェントの名前を付けた新しいIntercom Fin Webhookを作成し、ステップ1で設定したエージェントがアクセス可能なアプリをスコープとして設定します。
    • 既存の接続を使用します。エージェントと同じアプリスコープを持つ既存のIntercom Fin Webhookを選択します。存在しない場合は、新しい接続を作成するよう促されます。

  4. ［接続を作成（Create connection）］を選択します。これにより、Webhookが作成され、Intercom Finエージェントにリンクされます。

    注：Webhookは最初は無効で、エージェントの設定が完了した後にその機能（ワークフローナッジとフラストレーションシグナル）を設定して有効にするまで、イベントは送信されません。

  5. ［続行（Continue）］を選択します。

ステップ4：訪問者IDをIntercomと同期する

このステップは、Fin by Intercomエージェントにのみ表示されます。これを使用して選択したWebアプリのID同期をオンにすると、PendoとIntercomが同じ訪問者を認識できるようになります。Pendoの訪問者IDとIntercomのユーザーIDがすでに一致している場合は、同期をオフのままにしておくことができます。

  1. 選択したWebアプリの同期を有効にするには、［Intercomと訪問者IDを同期］をオンにします。
  2. ［続行（Continue）］を選択します。

Intercomで完了する手順を含むID同期の完全な設定については、PendoとIntercom間でIDを同期するをご参照ください。

ステップ5：確認する

レビューの段階で、エージェントの詳細と接続設定を確認します。MCPまたはWebhookの少なくとも一方に接続する必要があります。

エージェントを確認および作成するには、動画ウォークスルーをご覧いただくか、以下の手順に従ってください。

  1. 概要（エージェントタイプ、名前、アプリ、MCPステータス、Webhookステータス）を確認します。
  2. ［エージェントを追加（Add agent）］を選択します。

Pendoはエージェントを作成し、概要ページを開き、そこで機能の有効化を始めることができます。

次のステップ

まだ行っていない場合は、ID同期の設定を完了してください。手順については、「PendoとIntercom間でIDを同期する」をご覧ください。

MCPベースの機能をオンにしている場合、次の操作を実行できます。

Webhookベースの機能をオンにしている場合、次の操作を実行できます。

この記事は役に立ちましたか？
0人中0人がこの記事が役に立ったと言っています

このセクションの記事