重要
/beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。
Microsoft 365 Copilot Chat API を使用すると、organization内で定義されたアクセス制御を尊重しながら、Microsoft 365 Copilotで複数ターンの会話を作成して続行できます。 Chat API を使用して、Microsoft 365 Copilotをジェネレーティブ AI ソリューションに統合します。
このドキュメントでは、Chat API を使用した Copilot 会話の作成について説明します。 Chat API を使用して 同期会話 または ストリーミングされた会話を続行する 方法について説明します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | Sites.Read.All、Mail.Read、People。Read.All、OnlineMeetingTranscript.Read.All、Chat.Read、ChannelMessage.Read.All、ExternalItem.Read.All* | サポートされていません。 |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | サポートされていません。 | サポートされていません。 |
* Microsoft 365 Copilot Chat API を正常に呼び出すには、これらすべての Microsoft Graph アクセス許可が必要です。
HTTP 要求
POST https://graph.microsoft.com/beta/copilot/conversations
要求ヘッダー
| 名前 | 説明 |
|---|---|
Authorization |
Bearer {token}. 必須です。
認証と認可についての詳細をご覧ください。 |
Content-Type |
application/json. 必須。 |
要求本文
要求本文で、空の JSON 本文を指定します。
応答
成功した場合、このアクションは応答本文に 201 Created 応答コードと copilotConversation を返します。
例
次の例は、Microsoft 365 Copilot Chat API を使用して Copilot 会話を作成する方法を示しています。 会話が作成されると、応答本文の id が、同期エンドポイントまたはストリーミング エンドポイントを使用して、会話を続行するためのパス パラメーターとして使用されます。
要求
次の例は要求を示しています。
POST https://graph.microsoft.com/beta/copilot/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
}