重要
/beta バージョンの API は変更される可能性があります。 運用アプリケーションでのこれらの API の使用はサポートされていません。
Work IQ Chat API を使用すると、organization内で定義されたアクセス制御を尊重しながら、Microsoft 365 Copilotで複数ターンの会話を作成して続行できます。 Chat API を使用して、Microsoft 365 Copilotをジェネレーティブ AI ソリューションに統合します。
このドキュメントでは、Chat API を使用した Copilot 会話の作成について説明します。 Chat API を使用して 同期会話 または ストリーミングされた会話を続行する 方法について説明します。
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | WorkIQAgent.Ask | 注意事項なし。 |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | サポートされていません。 | サポートされていません。 |
HTTP 要求
POST https://workiq.svc.cloud.microsoft/rest/conversations
POST https://workiq.svc.cloud.microsoft/rest/beta/conversations
要求ヘッダー
| 名前 | 説明 |
|---|---|
Authorization |
Bearer {token}. 必須です。 |
Content-Type |
application/json. 必須。 |
要求本文
要求本文で、空の JSON 本文を指定します。
応答
成功した場合、このアクションは応答本文に 201 Created 応答コードと copilotConversation を返します。
例
次の例は、Work IQ Chat API を使用して Copilot 会話を作成する方法を示しています。 会話が作成されると、応答本文の id が、同期エンドポイントまたはストリーミング エンドポイントを使用して、会話を続行するためのパス パラメーターとして使用されます。
要求
次の例は要求を示しています。
POST https://workiq.svc.cloud.microsoft/rest/conversations
Content-Type: application/json
{}
POST https://workiq.svc.cloud.microsoft/rest/beta/conversations
Content-Type: application/json
{}
応答
次の例は応答を示しています。
HTTP/1.1 201 Created
Content-Type: application/json
{
"id": "0d110e7e-2b7e-4270-a899-fd2af6fde333",
"createdDateTime": "2025-09-30T15:28:46.1560062Z",
"displayName": "",
"status": "active",
"turnCount": 0
}