Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Wichtig
APIs unter der /beta Version können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.
Die Microsoft 365 Copilot Chat-API ermöglicht ihnen das Erstellen und Fortsetzen von Konversationen mit mehreren Durchläufen mit Microsoft 365 Copilot, wobei die definierten Zugriffssteuerungen innerhalb der organization beachtet werden. Verwenden Sie die Chat-API, um Microsoft 365 Copilot in Ihre generativen KI-Lösungen zu integrieren.
In dieser Dokumentation wird das Erstellen von Copilot-Unterhaltungen mithilfe der Chat-API behandelt. Erfahren Sie, wie Sie synchrone Unterhaltungen oder gestreamte Unterhaltungen mit der Chat-API fortsetzen.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
| Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
|---|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | Sites.Read.All, Mail.Read, Personen. Read.All, OnlineMeetingTranscript.Read.All, Chat.Read, ChannelMessage.Read.All, ExternalItem.Read.All* | Nicht unterstützt |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
| Application | Nicht unterstützt | Nicht unterstützt |
* Sie benötigen alle diese Microsoft Graph-Berechtigungen, um die Microsoft 365 Copilot Chat-API erfolgreich aufrufen zu können.
HTTP-Anforderung
POST https://graph.microsoft.com/beta/copilot/conversations
Anforderungsheader
| Name | Beschreibung |
|---|---|
Authorization |
Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
Content-Type |
application/json. Erforderlich. |
Anforderungstext
Geben Sie im Anforderungstext einen leeren JSON-Text an.
Antwort
Bei erfolgreicher Ausführung gibt diese Aktion einen 201 Created Antwortcode und eine copilotConversation im Antworttext zurück.
Beispiel
Das folgende Beispiel zeigt, wie Sie eine Copilot-Konversation über die Microsoft 365 Copilot Chat-API erstellen. Nachdem die Konversation erstellt wurde, wird der id im Antworttext als Pfadparameter für die Fortsetzung der Konversation verwendet, wobei entweder der synchrone Endpunkt oder der gestreamte Endpunkt verwendet wird.
Anforderung
Das folgende Beispiel zeigt die Antwort.
POST https://graph.microsoft.com/beta/copilot/conversations
Content-Type: application/json
{}
Antwort
Das folgende Beispiel zeigt die Antwort.
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
}