> For the complete documentation index, see [llms.txt](https://docs.nexthink.com/platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexthink.com/platform/ja/user-guide/ai-tools/setting-up-and-managing-ai-tools/configuring-ai-tools/configuring-microsoft-copilot-using-api-credentials.md).

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

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

このページの [#configuring-the-tool-in-the-nexthink-web-interface](#configuring-the-tool-in-the-nexthink-web-interface "mention") セクションを参照してください。
{% endhint %}

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

Nexthink で [Entra ID コネクター](/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/inbound-connectors/connector-for-microsoft-entra-id-azure-ad.md) を設定したら、**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 ツールのセットアップと管理](/platform/ja/user-guide/ai-tools/setting-up-and-managing-ai-tools.md#configure-connector-credentials) を参照してください。
5. 利用可能であれば、Microsoft Copilot の**ライセンス**を追加します。
6. **AI ツール** の設定を保存.

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

{% hint style="danger" %}
*以下の問題を修正してください：*

* *認証情報エラー：クライアント ID が無効です。*
  {% endhint %}

<figure><img src="/files/ZCdnZLW4CmpxJkAnzQrK" alt=""><figcaption></figcaption></figure>

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

<details>

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

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` を含めます。

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

</details>

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

はい、Microsoft Copilot から AI インタラクションデータを正しく取得するには、[Microsoft Entra ID 用コネクタ](/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/inbound-connectors/connector-for-microsoft-entra-id-azure-ad.md)が必要です。

<details>

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

Nexthink の監視用 **AI ツール** で [Microsoft Copilot の設定](#exception-configuring-microsoft-365-copilot-using-api-credentials) を保存する際、システムはコネクターの認証情報を自動的に確認します。

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

</details>

<details>

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

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

この処理は即時には行われません。データは通常、インタラクション発生から1分以内に届きますが、AI インタラクションに関しては、[Microsoft Graph API](https://learn.microsoft.com/en-us/graph/change-notifications-overview#latency) の最大遅延が60分となっています。

</details>

<details>

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

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

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

</details>

<details>

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

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

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

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

* `appClass`
* `conversationType`
* `createdDateTime`
* `from`
* `interactionType`
* `requestId`
* `sessionId`

フィールドの説明および詳細については、[Microsoft Copilot API](https://learn.microsoft.com/en-us/microsoft-365-copilot/extensibility/api/ai-services/interaction-export/resources/aiinteraction?pivots=graph-v1) のドキュメントを参照してください。

{% hint style="warning" %}
Nexthink は、ペイロードの残りの部分にアクセスも保存も行いません。
{% endhint %}

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.nexthink.com/platform/ja/user-guide/ai-tools/setting-up-and-managing-ai-tools/configuring-ai-tools/configuring-microsoft-copilot-using-api-credentials.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.