1. Pendoヘルプセンター
  2. エージェントのためのPendo
  3. エージェントツールキット

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

最終更新日:

この記事では、Fin上で動作するAIエージェントを設定し、そのエージェントをPendoのデータに接続して、エージェントが使用する機能を設定する方法について説明します。

カスタムAIエージェント（社内で開発するエージェント、または設定するサードパーティ製エージェント）を設定する方法については、「エージェントツールキットでカスタムエージェントを設定する」を参照してください。エージェントツールキットの詳細については、「エージェントツールキットの概要」を参照してください。

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

仕組み

Fin AIエージェントの場合、5つのステップからなる1つのウィザードでAIエージェントを設定します：

  • 詳細。AIエージェントのタイプとしてFinを選択し、AIエージェントに名前を付け、実行するアプリを選択します。
  • 会話中のヘルプ。セッションコンテキスト、ガイド、フィードバックの送信を支えるPendoデータにFinを接続してください。
  • 積極的なサポート。Intercomのワークスペースを接続して、ワークフローのナッジやフラストレーションシグナルを可能にするWebhookを作成してください。
  • 訪問者IDをIntercomと同期。PendoはAIエージェントのウェブアプリで訪問者IDの同期を有効にするため、PendoとIntercomは同じ訪問者を認識します。
  • レビュー。詳細を確認してから、AIエージェントを追加します。

会話内ヘルプまたはプロアクティブヘルプの少なくとも一方を設定する必要があります。設定が完了したら、AIエージェントの［概要（Overview）］ページや各タブから、個々の機能を有効にして設定します。

注： AIエージェントを追加または更新する際、Pendoでは、別のAgent Toolkit AIエージェントにすでにリンクされているサービスアカウントまたはWebhookをリンクできないようにしています。別のAIエージェントにリンクする前に、既存のAIエージェントからリンクを解除してください。

始める前に

Agent ToolkitでFin AIエージェントを設定するには、次のものが必要です：

  • Agent Toolkitにアクセスするためのサブスクリプション管理者権限。MCPを有効にするには、これらの権限も必要です。
  • Webhooksはサブスクリプションで有効になっていること。AIエージェントのワークフロー・ナッジとフラストレーションシグナルを設定するには、Webhooksが必要です。
  • Finの設定にアクセスできる、Intercom内のFinワークスペース。
  • Pendoが訪問者IDをIntercomと同期できるように、Finが稼働するウェブアプリにPendoエージェントのバージョン2.336.0以降がインストールされていること。

重要：Finは、Pendoの訪問者IDとIntercomのユーザーIDが一致する場合にのみ、訪問者を認識できます。一致しない場合、その訪問者に対してAIエージェントの機能は動作しません。ウィザードによってFin AIエージェントの訪問者IDの同期が有効になり、PendoがIntercomで必要とする設定手順が案内されます。設定全体と確認方法については、「PendoとIntercom間でIDを同期する」を参照してください。この要件は、Intercomを使用しないカスタムAIエージェントには適用されません。

ステップ1：AIエージェントを追加する

Agent Toolkit で Fin AI エージェントの設定を始めるには、動画による手順解説をご覧いただくか、以下の手順に従ってください。

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

ステップ2：会話内ヘルプを設定する

会話中のヘルプはFinをPendoデータに接続し、会話中にセッションコンテキスト、ガイド、フィードバック送信を利用できるようにします。これらの機能が不要な場合は、代わりに［スキップ］を選択して、プロアクティブヘルプを設定します。

ウィザードでは、Finのセットアップを順を追って案内します。また、リンクから該当するFinの設定ページを開けます。

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

会話内ヘルプを設定するには、動画のウォークスルーをご覧になるか、以下の手順に従ってください。

  1. ウィザードでMCPサーバーをオンにしてサービスアカウントを設定し、FinがMCPサーバー経由でPendoのライブデータをクエリできるようにします。

  2. 接続の作成の下で、ウィザードに表示される詳細をコピーします。 接続では、「詳細」ステップで指定した名前とアプリを使用します。次のステップで、これらの詳細をFinに貼り付けます：

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

    重要： クライアントシークレットは安全な場所に保存してください。セットアップを終了すると、再度表示することはできません。

  3. ［Finで認証トークンを作成（Create an authentication token in Fin）］の下にある［Finの設定を開く（Open Fin settings）］を選択します。これにより、Finの認証設定が開きます。ウィザードの値を使用して、新しいトークンを作成します：

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

    Finでトークンをテストして、200 OKレスポンスが返されることを確認してください。

  4. Finにトークンを保存します。ウィザードに戻り、［Finで認証トークンを作成しました（I created the authentication token in Fin）］チェックボックスを選択します。

  5. ［FinでカスタムMCPコネクタを追加（Add a custom MCP connector in Fin）］の下で、MCPサーバーURLをコピーし、［Finの設定を開く（Open Fin settings）］を選択します。Finの［データコネクタ（Data connectors）］設定で、［カスタムMCP（Custom MCP）］を選択し、次の内容を入力します：

    • 名前： 例えばPendo MCPなど、認識しやすい名前です。
    • URL：ウィザードの［MCPサーバーURL（MCP server URL）］。
    • 認証：前の手順で作成した認証トークン。
  6. Finで接続をテストし、FinからPendoに接続できることを確認します。
  7. ウィザードに戻り、［FinでカスタムMCPコネクタを追加してテストしました（I added and tested the custom MCP connector in Fin）］チェックボックスを選択します。
  8. ［続行（Continue）］を選択します。

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

ステップ3：プロアクティブヘルプを設定する

訪問者がタスクを途中で中断したり、フラストレーションの兆候を示したときにFinがサポートを提供できるよう、プロアクティブヘルプはリアルタイムのPendoイベントをFinに送信します。ワークフローへの働きかけやフラストレーションの兆候の検知を可能にし、Finが設定されているIntercomワークスペースに接続します。会話内ヘルプを設定し、これらの機能が不要な場合は、［スキップ（Skip）］を選択します。

注：会話中のヘルプをスキップした場合、AIエージェントを追加する前にプロアクティブヘルプが必要です。

プロアクティブヘルプを設定するには、ビデオウォークスルーをご覧いただくか、以下の手順に従ってください。

  1. ［Intercomに接続（Connect to Intercom）］で、［Intercomで接続（Connect with Intercom）］を選択します。Finが設定されているIntercomワークスペースにサインインできるよう、認証ページが新しいタブで開きます。
  2. ［アクセスを許可（Authorize access）］を選択します。これにより、Agent Toolkitのセットアップウィザードが再度開きます。後で接続の有効期限が切れた場合は、［再接続（Reconnect）］を選択します。
  3. Webhookを作成するで、次のいずれかを選択します：
    • 新しいWebhookを作成する。AIエージェントの名前を付け、Detailsステップで選択したアプリを対象範囲に設定した新しいIntercom Webhookを作成します
    • 既存のWebhookを使用する。AIエージェントと同じアプリスコープの既存のIntercom Webhookを選択してください。該当するものがない場合は、新しいWebhookを作成するよう求められます。

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

    注： セットアップ完了後に、プロアクティブ機能（ワークフローのナッジまたはフラストレーションシグナル）を設定して有効にするまで、Webhookからイベントは送信されません。

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

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

このステップは、Fin AIエージェントの場合にのみ表示されます。Finは、Pendoの訪問者IDとIntercomのユーザーIDが一致した場合にのみ訪問者を認識できるため、すべてのAIエージェントのウェブアプリで訪問者IDの同期を自動的に有効にします。設定を有効にする必要はありません。このステップでは、IDがすでに一致しているかどうかを確認し、一致していない場合は、PendoとIntercomに必要なマッピングを設定します。

IDが一致しない場合、Pendoは各訪問者のIntercomユーザーIDを訪問者メタデータ（intercomUserId）として保存し、Pendoの訪問者IDをカスタム属性（pendoVisitorId）としてIntercomに送信します。Intercomは、Pendoと同じページにインストールする必要があります。

  1. ［IDがすでに一致しているかどうかの確認］にある次の2つのオプションから1つを使用します。

    • オプションA：ブラウザ内（推奨）。 PendoとIntercomの両方がインストールされているページで、ブラウザのコンソールを開き、pendo.checkIntegrationIdMatch('intercom')を実行します。
    • オプションB：手動。 IntercomのユーザーIDを［ピープル（People）］ > ［訪問者（Visitors）］で確認し、同じ人物のPendo訪問者IDと比較します。

  2. ［PendoとIntercom間でIDは一致していますか？］の下で、［はい］または［いいえ］を選択します。［いいえ］を選択した場合は、続行する前に両方のチェックボックスを選択してください：

    • PendoでintercomUserIdのメタデータマッピングを作成する。サブスクリプションのIntercomユーザーIDデータマッピングを、intercomUserIdメタデータフィールドに設定します。
    • FinでpendoVisitorIdカスタム属性を作成する。Intercomワークスペースに、pendoVisitorIdというテキストのコンタクト属性を作成します。これには、Proactive helpのステップで設定したIntercom接続が必要です。
  3. ［続行（Continue）］を選択します。

同期は、PendoとIntercomの両方がインストールされているページを訪問者が読み込んだ後に有効になります。同期が正常に動作していることを確認する場合、またはIntercomの設定を手動で完了する場合は、PendoとIntercom間のIDの同期をご参照ください。

ステップ5：確認する

レビューステップで、完了する前にAIエージェントの詳細を確認してください。AIエージェントを追加した後、使用する機能を設定します。

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

  1. 概要を確認してください：AIエージェントのタイプ、名前、アプリ、会話中のヘルプのステータス、プロアクティブヘルプのステータス。
  2. ［AIエージェントを追加（Add AI agent）］を選択します。

PendoはAIエージェントを追加し、その［概要（Overview）］ページを開きます。［概要］ページには、［会話型ヘルプ（In-conversation help）］と［プロアクティブヘルプ（Proactive help）］に分類された5つの機能のうち、設定済みの機能数が表示され、各機能には［セットアップ（Set up）］ボタンが用意されています。

次のステップ

訪問者IDの同期が機能していることを確認するには、「PendoとIntercom間でIDを同期する」をご覧ください。

会話内ヘルプを設定すると、次のことができます：

プロアクティブヘルプを設定すると、次のことができます：

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

このセクションの記事