このガイドを参照して、Salesforce Agentforce を Microsoft Agent 365 に接続し、サードパーティ製のエージェント監視向けに Agentforce のセッションアクティビティを収集してください。
始める前の準備
- Agent 365のAI管理者がMicrosoft 365 管理センターで接続を作成できるか確認してください。
- この記事に記載のSalesforceの手順をSalesforce管理者に実施してもらってください。
- Salesforce組織でEinstein生成AIとAgentforceが有効になっているか確認してください。
- 活動を収集するには、組織内でData 360(旧Data Cloud)が利用可能かどうかを確認してください。
Salesforce外部クライアントアプリを作成する
- Salesforceで 「セットアップ」を選択し、「 App Manager」を検索してください。
- 外部クライアントアプリマネージャーを開き、「新しい外部クライアントアプリ」を選択します。
- アプリ名と連絡先メールアドレスを入力してください。
-
「OAuthを有効にする」を選択し、
https://login.salesforce.com/services/oauth2/success( など)を入力してください。 -
OAuthスコープの下に、以下のスコープを追加してください:
- チャットボット サービスへのアクセス (
chatbot_api) - Salesforce API プラットフォームへのアクセス (
sfap_api) - API を使用してユーザー データを管理する (
api) - いつでも要求を実行する (
refresh_token、offline_access)
- チャットボット サービスへのアクセス (
- フローの有効化 で クライアント資格情報フローを有効にする を選択し、作成を選択します。
- アプリの ポリシー タブで 編集 を選択してください。 OAuth ポリシーで、クライアントの資格情報フローを有効にするをオンにします。
- APIアクセス権を持つアクティブなユーザーに 「Run As 」を設定し、その後「 保存」を選択します。 アクティビティを収集するには、このユーザーはData 360のデータ空間にもクエリできる必要があります。
- アプリの 設定 タブで 「OAuth 設定」を展開し、「 Consumer Key and Secret」を選択し、Consumer KeyとConsumer secretを記録します。 次に、>My Domainから現在のMy Domain URLをコピーします。
Agentforceのセッショントレーシングをオンにしてください
Agent 365はData 360内のAgentforce Session TracingデータからAgentforceのアクティビティを収集します。 エージェントが実行される前にトレースをオンにしてください。 トレーシングがオフの状態で実行されたセッションは記録されず、後で回収できません。
- もしData 360が設定されていない場合は、セットアップ>Data 360セットアップ(一部の組織ではData Cloud Setup)に移動し、Get Startedを選択してください。 プロビジョニングには最大1時間かかることがあります。
- セットアップで「インストール済みパッケージ」を検索し、Salesforce標準データモデルがバージョン1.130以降であることを確認しましょう。 アップグレードするには、Agentforceのセッショント トレースの設定を参照してください。
- セットアップで「Einstein Generative AI」を検索し、「Einstein Audit, Analytics, and Monitoring Setup」を選択してください。
- もしまだ有効になっていなければ、 Agentforce Session Tracing をオンにしてください。 データスペースを求められたら、 デフォルトを選択してください。
- エージェントプラットフォームのトレースと監査とフィードバックを有効にしてください。
接続の作成
- Microsoft 365 管理センターを開きます。
- エージェント>すべてのエージェントを選択します。
- 接続プラットフォームで「管理」を選択します。
- +Connect a platformを選択し、「Salesforce Agentforce」を選択してください。
- 「パスを含まない My Domain URL」、コンシューマーキー、コンシューマーシークレットを入力します。
- 資格情報を検証します。
- 接続を保存します。
- 同期エージェントを選択します。
新しい接続はデフォルトでオブザーバビリティ データを集めます。 オブザーバビリティ機能が利用可能になる前に接続を作成していた場合は、それを編集して エージェントのオブザーバビリティ データを収集 を選択してください。
接続とアクティビティを確認します
- 接続を開き、同期が成功し、期待されるエージェントが現れたことを確認してください。
- アクティブなエージェントとの会話を実行します。 例えば、Agentforce Builderでプレビューパネルをライブテストモードで使い、セッションIDをメモしてください。
- (任意)Data 360アプリでData Explorerを開き、有効になっているデータ空間、Data Model Objects、AIエージェントセッションを選択します。 セッションIDの行が存在するか確認してください。
- Microsoft 365 管理センターで接続を開き、「同期エージェント」を選択します。 エージェント365は接続が同期するたびに新しいセッションを収集します。
- Agents>All Agentsでエージェントを開き、Activityを選択し、Sessionsが少なくとも1であることを確認します。
トレーシングをオンにして最初のセッションは、Data 360に反映されるまで最大2時間かかることがあります。 セッション数がまだ0なら、数分待ってから再度同期してください。 アクティブユーザーはN/Aと表示されます。なぜならAgentforceセッションにはMicrosoft Entraのアイデンティティが含まれていないからです。
Note
場合によっては、Data 360はスケジュール通りにデータストリームを更新しません。 Data 360アプリでData Streamsを開き、各Agentforceセッショントレースストリームを開いて「 今すぐリフレッシュ」を選択します。
Troubleshoot
| 症状: | 考えられる原因 | Resolution |
|---|---|---|
| 資格情報の検証が失敗します | アプリ設定と OAuth ポリシーの両方でクライアント資格情報フローが有効になっていない、または実行者が設定されていない、あるいは URL が My Domain URL ではない | アプリ名と URL を修正します。 新しいアプリの場合、フローの承認に数分かかることがあります。 |
| 同期後にエージェントが現れません | エージェントはアクティブでないか、Run As ユーザーがそれにアクセスできない状態です | Agentforce Builderでエージェントを有効化し、 Run As ユーザーの権限を確認し、再度同期します。 |
| Agentforceのセッショントレーシング は利用できません | Data 360はプロビジョニングされておらず、Agentforceはオフで、Salesforce標準データモデルは1.130未満です | Agentforce のセッショントレースを有効にするを完了します。 |
| Data 360ではセッションが表示されません | 会話中にトレースがオフだったか、データストリームが更新されていない | トレースをオンにした後で、新しい会話セッションを開始してください。 Developer Editionの組織で、データストリームの「 今すぐリフレッシュ 」を選択してください。 |
| Data 360にセッションが表示されますが、 アクティビティ は空です | コレクションがオフになっている、会話以降接続が同期されていない、トレースが別のデータ空間を使っている、または Run As ユーザーがData 360にクエリできない | エージェントの監視データを収集するを選択し、再度同期を行ってから、実行者ユーザーにそのデータへのアクセス許可を付与します。たとえば、Data Cloud Architect (旧 Data Cloud Admin) のアクセス許可セットを使用します。 |
アクセスを取り消す
Salesforceの外部クライアントアプリを無効化または削除、コンシューマーシークレットのローテーション、または Run As ユーザーのAPIアクセスを解除することでアクセスを取り消します。
Salesforce Agentforceに特有でない接続の問題については、「 接続プラットフォームのトラブルシューティング」をご覧ください。