エージェントツールキット(ベータ版)でエージェントを設定する

最終更新日:

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

  1. メインナビゲーションの Agent Toolkit にアクセスします。
  2. エージェントを追加(Add agent)]を選択して、設定ウィザードを開きます。
  3. メインナビゲーションで[エージェントツールキット(Agent Toolkit)]に移動します。IntercomのFin(Fin by Intercom)は、現時点では唯一利用できるオプションです。その他のプラットフォームも近日中にサポートされる予定です。
  4. エージェントの[名前(Name)]を入力し、必要に応じて[説明(Description)]も入力します。
  5. アクセス可能なアプリ(Accessible apps)]で、エージェントがアクセスできるアプリを1つ以上選択します。このフィールドは必須です。
  6. [続行(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に接続している場合は、[スキップ(Skip)]を選択します。

注: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:レビュー

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

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

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

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

次のステップ

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

MCP ベースの機能を有効にすると、次のことが可能になります:

Webhookベースの機能を有効にすると、次のことが可能になります:

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