API 資格情報を使用した Microsoft Copilot の構成

Nexthink AI Tools は、AI Tools で Microsoft Copilot を構成していない場合でも、デフォルトで Microsoft Copilot 向けのユーザーライセンスデータを収集します。

このページの API 資格情報を使用した Microsoft Copilot の構成 セクションを参照してください。

Nexthink では、Microsoft Copilot に対して API ベースのセットアップのみがサポートされています。システムは、ユーザーライセンスデータを収集し、従業員が Microsoft Copilot の無料版またはライセンス版を使用しているかに基づいてインタラクションイベントにタグ付けするために、構成が必要な Entra ID コネクターを使用します。

Nexthink で Entra ID コネクター を設定したら、AI Tools で Microsoft Copilot を構成するために次の手順に従ってください。

1. メインナビゲーションから AI Tools > Manage AI tools に移動します。
2. Manage AI tools ページの表に一覧表示されている Microsoft Copilot のハイパーリンクをクリックするか、項目のアクションメニューを使用して Copilot の設定を Edit します。
3. AI ツールの構成ページで、内部使用向けの AI ツールの詳細を提供するために Description を入力します。

   • Microsoft Copilot の場合、name と NQL ID フィールドは事前に決定されており、編集できません。
4. API 認証情報 のドロップダウンから、Microsoft Copilot 用に Nexthink で事前設定しておく必要がある対応する コネクター認証情報 を選択します。 AI ツールのセットアップと管理 を参照してください。
5. 利用可能であれば、Microsoft Copilot のライセンスを追加します。
6. AI ツール の設定を保存.

有効なコネクターの認証情報のみが、AI ツールで Microsoft Copilot の設定を保存できるようにします。 それ以外の場合、Nexthink は既存のエラーを表示します。

以下の問題を修正してください：

• 認証情報エラー：クライアント ID が無効です。

Microsoft Copilot のデータ取得に関する F.A.Q

資格情報の設定が成功したのに、Copilot ダッシュボードにデータが表示されないのはなぜですか？

Microsoft の通知システムが、サブスクリプション通知で validationTokens プロパティを送信していません。 これらのトークンがない場合、Nexthink は受信イベントを安全に検証して取り込むことができず、その結果、Nexthink AI Tools の Copilot ダッシュボードが空の状態になります。

根本原因

Copilot コネクタの資格情報を構成するために使用される Azure 登録アプリケーションで、appRoleAssignmentRequired が true に設定されている可能性があります。

この設定（appAssignmentsRequired=true）が有効な場合、Microsoft はサブスクリプション通知から validationTokens プロパティを省略するため、Nexthink はイベントを検証できなくなります。

解決方法

オプション 1 — 推奨: appRoleAssignmentRequired を無効にする

1. Azure ポータルにサインインします。
2. Azure Active Directory > Enterprise Applications に移動します。
3. Copilot コネクタに使用されるアプリケーションを選択します。
4. Manage > Properties に移動します。
5. Assignment required を No に設定します。

これにより、Microsoft がサブスクリプション通知に validationTokens を含め、Nexthink がデータを安全に検証して処理できるようになります。

---

オプション 2：アプリ ロールを割り当てる

内部ポリシーにより appRoleAssignmentRequired を無効化できない場合:

1. Microsoft のガイダンスに従って、ユーザーまたはサービス プリンシパルを Azure アプリケーションに手動で割り当ててください。
2. 関連するすべてのユーザーまたはシステムに、Enterprise Application 内で役割が割り当てられていることを確認してください。

その後、Microsoft はプッシュ通知に validationTokens を含めます。

これらの変更を適用しても問題が引き続き発生する場合は、Nexthink サポートにお問い合わせください。

<0>Copilot と従業員のインタラクションデータを取得するには、Microsoft Entra ID 用のコネクタが常に必要ですか？</0>

はい、Microsoft Copilot から AI インタラクションデータを正しく取得するには、Microsoft Entra ID 用コネクタが必要です。

サブスクリプションが正しく構成されていることを確認するにはどうすればよいですか？

Nexthink の監視用 AI ツール で Microsoft Copilot の設定 を保存する際、システムはコネクターの認証情報を自動的に確認します。

有効な認証情報のみが、AI ツールで Microsoft Copilot の設定を保存できるようにします。 それ以外の場合、Nexthink は既存のエラーを表示します。

Copilot AI のインタラクションデータはどれくらいの頻度で更新されますか？ 即時ですか？

現在の仕組みは、Graph API からデータを受け取るためにサブスクリプションを使用しています。 AI のインタラクションが発生するたびに、システムはそのインタラクションの詳細を Nexthink プラットフォームにプッシュします。

この処理は即時には行われません。データは通常、インタラクション発生から1分以内に届きますが、AI インタラクションに関しては、Microsoft Graph API の最大遅延が60分となっています。

Copilot を監視するために Nexthink が必要とする Microsoft Graph API のアクセス許可は何ですか？

Copilot を監視するには、Copilot のインタラクションデータを収集できるようにするために AiEnterpriseInteraction.Read.All 権限が必要です。

残念ながら、現在の Microsoft Graph API エンドポイント copilot/interactionHistory/getAllEnterpriseInteractions は、前述の権限のみに対応しています。 これは、より細かな権限や、より厳しい権限を付与できないことを意味します。

Nexthink は Copilot API のレスポンスからどのような情報を処理しますか？

現在、Copilot API は特定のペイロード要素の選択やフィルタリングを許可しておらず、代わりに Nexthink の機能には不要な追加情報も返します。

そのため、Nexthink は必要な高レベルのメトリックのみを処理し、残りのペイロードにはアクセスせず、保存もしません。 その結果、この追加情報は破棄されます。

Nexthink は以下のフィールドにのみアクセスします。

• appClass
• conversationType
• createdDateTime
• from
• interactionType
• requestId
• sessionId

フィールドの説明および詳細については、Microsoft Copilot API のドキュメントを参照してください。

Nexthink は、ペイロードの残りの部分にアクセスも保存も行いません。