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.
Die Microsoft 365 Copilot APIs ermöglichen Ihnen den sicheren Zugriff auf Microsoft 365 Copilot Funktionen in Ihren eigenen Anwendungen und benutzerdefinierten Engine-Agents, während sie den Compliancestandards von Microsoft 365 entsprechen. Unabhängig davon, ob Sie einen benutzerdefinierten Engine-Agent für Microsoft 365 Copilot mit Ihren eigenen Modellen oder Orchestrator oder eine Unterhaltungserfahrung in Ihren eigenen Anwendungen erstellen, bieten die Copilot-APIs Zugriff auf Komponenten, die Microsoft 365 Copilot Erfahrungen unterstützen.
Unternehmensentwickler stehen heute vor einer kritischen Herausforderung: Wie können sie die Leistungsfähigkeit von KI nutzen und gleichzeitig einen sicheren Zugriff auf das Wissen des Unternehmens aufrechterhalten, ohne die Compliance oder Governance zu beeinträchtigen? Herkömmliche Ansätze zwingen Sie dazu, komplexe KI-Systeme von Grund auf neu zu erstellen und sensible Daten in externe Quellen zu extrahieren. Die Microsoft 365 Copilot-APIs bieten Zugriff auf produktionsbereite KI-Funktionen, die direkt mit Ihren Microsoft 365-Daten zusammenarbeiten.
Durch den Zugriff auf oder die Verwendung der Microsoft 365 Copilot-APIs stimmen Sie den Nutzungsbedingungen für Microsoft 365 Copilot-APIs (Vorschau) zu.
Tipp
Möchten Sie die APIs erkunden, bevor Sie Code schreiben? Probieren Sie die interaktive Demo aus, um Live-API-Anforderungen und -Antworten mit Ihren Microsoft 365-Daten anzuzeigen.
Copilot-API-Funktionen
Die Copilot-APIs bieten eine umfassende Reihe von Funktionen, mit denen Sie KI-gestützte Anwendungen auf Grundlage von Unternehmensdaten erstellen können.
In der folgenden Tabelle sind die APIs aufgeführt und ihre Funktionen und Szenarien beschrieben.
| API | Verwenden Sie es, um | Beispielszenario |
|---|---|---|
| Retrieval API | Rufen Sie relevante Informationen aus Microsoft 365-Inhalten auf sichere und konforme Weise ab. | Verbinden Sie Ihre eigenen KI-Modelle mit Microsoft 365-Inhalten ohne Datenextraktion. Erstellen Sie spezialisierte Assistenten, die basierend auf der aktuellen Dokumentation, den Richtlinien und den Wissensdatenbanken Ihrer Organization antworten. Diese Anwendungen können abteilungsübergreifend kontextbezogene Informationen bereitstellen und gleichzeitig die Dokumentzugriffskontrollen und Vertraulichkeitsbezeichnungen berücksichtigen. |
| Such-API (Vorschau): | Führen Sie eine Hybridsuche (semantisch und lexikalisch) für OneDrive für Geschäfts-, Schul- oder Uniinhalte durch, indem Sie Abfragen in natürlicher Sprache mit kontextbezogenem Verständnis und intelligenten Ergebnissen verwenden. | Erstellen Sie KI-gestützte Suchanwendungen, die Benutzern helfen, relevante Dokumente und Dateien mithilfe von Abfragen in natürlicher Sprache anstelle von genauen Schlüsselwortübereinstimmungen) zu finden, und gleichzeitig Sicherheit und Compliance gewährleisten. |
| Interaktionsexport-API | Aktivieren Sie Compliancelösungen, um Benutzerinteraktionen mit Copilot in Microsoft 365-Anwendungen zu erfassen und zu archivieren. | Entwickeln Sie Systeme, die umfassende Aufzeichnungen über KI-Interaktionen führen, die Überwachung der KI-Nutzung ermöglichen und die Einhaltung von Unternehmensrichtlinien und gesetzlichen Anforderungen sicherstellen. Diese Lösungen sind wertvoll für regulierte Branchen, in denen die Dokumentation und Überprüfung einer KI-gestützten Inhaltsgenerierung erforderlich ist. |
| KI-Interaktionen Änderungsbenachrichtigungs-API (Vorschau) | Abonnieren Sie Änderungsbenachrichtigungen für Copilot-Interaktionen in Microsoft 365. | Erstellen Sie Anwendungen, die KI-Interaktionen in Echtzeit überwachen und protokollieren und proaktive Compliance-Prüfungen, Anomalieerkennung und Audits ermöglichen. |
| Meeting Insights-API | Extrahieren Sie KI-generierte Besprechungsnotizen, Aktionselemente und Diskussionsthemen für Teams-Besprechungen. | Erstellen Sie Anwendungen, die Aktionselemente, Entscheidungen und Zusammenfassungen aus Teams-Besprechungen automatisch extrahieren und organisieren. Verknüpfen Sie diese mit Projektmanagement-Tools, CRM-Systemen oder benutzerdefinierten Workflows. Diese Systeme können Besprechungen von der aufgewendeten Zeit in einen Mehrwert verwandeln, indem sie Besprechungsergebnisse automatisch erfassen, organisieren und aktivieren. |
| KI Insights-Änderungsbenachrichtigungs-API (Vorschau) | Abonnieren Sie Änderungsbenachrichtigungen für Copilot KI Insights von Teams-Besprechungen. | Erstellen Sie Anwendungen, die Teams Meeting KI Insights verwenden, um eine konsistente Erfassung wichtiger Details zu gewährleisten und die Abstimmung zu fördern. |
| Chat-API (Vorschau) | Aktivieren Sie Unterhaltungserlebnisse, die von Microsoft 365 Copilot unterstützt werden, in Ihren benutzerdefinierten Anwendungen. | Integrieren Sie Microsoft 365 Copilot in Ihre Unternehmensanwendungen, die basierend auf Microsoft 365-Daten und Benutzerkontext Fragen beantworten, Aufgaben ausführen und Anleitungen bereitstellen können. Diese Schnittstellen können die Produktivität der Benutzer verbessern, indem sie KI-Funktionen direkt in die Tools bringen, die sie täglich verwenden, von benutzerdefinierten Portalen bis hin zu mobilen Apps. |
| API für Copilot-Nutzungsberichte | Fragen Sie die Anzahl der Benutzer und Nutzungsdaten für Microsoft 365 Copilot in Ihrer organization ab. | Erstellen Sie Berichte, um die Akzeptanz von Microsoft 365 Copilot durch Ihre Benutzer nachzuverfolgen. |
| Paketverwaltungs-API | Anzeigen und Verwalten von Agents in Ihrer gesamten organization. | Erstellen Sie eine Bestandsaufnahme aller Agents in Ihrer organization. |
Hinweis
Die Chat-API gibt textuelle Antworten zurück; sie beantwortet Fragen und stellt Anleitungen bereit, führt jedoch keine Aktionen wie das Erstellen von Dateien, das Senden von E-Mails oder das Planen von Besprechungen aus. Weitere Informationen finden Sie in der Liste der bekannten Einschränkungen der Chat-API.
Hauptvorteile
Die Copilot-APIs bieten die folgenden Vorteile für Ihre Anwendungen:
- Sichere Fundierung, Governance und Compliance – Greifen Sie direkt auf den Wissensindex von Microsoft 365 zu. Alle vorhandenen Berechtigungen, Vertraulichkeitsbezeichnungen, Konformitätskontrollen, Überwachung, Protokollierung, Überwachung und Richtlinienerzwingung werden automatisch berücksichtigt. Weitere Informationen zum Sicherheits- und Authentifizierungsmodell finden Sie unter Sicherheit und Authentifizierung für Microsoft 365 Copilot-APIs.
- Produktionsbereite KI: Beschleunigen Sie die Entwicklung Ihrer benutzerdefinierten RAG-Pipelines (Retrieval Augmented Generation) und die Verarbeitung von Besprechungstranskriptionen, indem Sie dieselben KI-Funktionen für die Produktion nutzen, die auch Microsoft 365 Copilot unterstützen. Unabhängig davon, ob Sie Ihre Lösungen mit Azure AI Foundry , Microsoft Copilot Studio oder dem Microsoft Agents SDK entwickeln, sind die Copilot-APIs nahtlos in die Plattform integriert.
- Verantwortungsvolle KI: Wenn Sie diese Copilot- und intelligenten Erfahrungen verwenden, sind Sie über RAI-Validierungsprüfungen vor schädlichen Inhalten geschützt.
Anforderungen
Um das volle Potenzial der Copilot-APIs in Ihre Anwendungen und benutzerdefinierten Engine-Agenten zu integrieren und zu nutzen, benötigen Sie Zugriff auf Folgendes:
Microsoft 365 Copilot Lizenz – erforderlich für jeden Benutzer, der über diese APIs auf Microsoft 365 Copilot Funktionen zugreift. Diese Lizenz ermöglicht den Zugriff auf die KI-Funktionen, die die APIs unterstützen.
Microsoft 365-Abonnement: Ein E3- oder E5-Abonnement (oder ein gleichwertiges Abonnement) ist die Grundlage für Microsoft 365 Copilot. Dieses Abonnement bietet Zugriff auf die Microsoft 365-Dienste und -Daten, auf denen Copilot aufbaut.
Von der App-Registrierung zum API-Client
Das Erstellen eines Agents oder einer Anwendung für Microsoft 365 folgt einer Kette, die das App-Modell mit den Copilot-APIs verbindet:
- Sie erstellen ein App-Paket – das Bündel aus Manifest, Symbolen und Metadaten, das vom Microsoft 365-App-Modell definiert wird.
- Als Teil dieses Pakets führen Sie eine App-Registrierung in Microsoft Entra ID durch, die eine Anwendungs-ID (Client-ID) erstellt.
- Zur Laufzeit geben Sie diese Anwendungs-ID (Client-ID) an einen Authentifizierungsanbieter (z. B. MSAL) an, um Zugriffstoken im Namen des angemeldeten Benutzers abzurufen.
- Sie übergeben das resultierende Token, wenn Sie die Copilot-APIs ( z. B. die Retrieval-API) aufrufen.
Die App-Registrierung ist die Brücke zwischen dem Paketmodell und dem API-Verbrauchsmodell – hier wird Ihre App-Paketidentität zum Berechtigungsnachweis, der Copilot-API-Aufrufe autorisiert.
Das id Feld im App-Manifest und die Entra-Anwendungs-ID (Client-ID) sind unterschiedliche Bezeichner, die unterschiedlichen Zwecken dienen. Das Manifest id identifiziert Ihre App innerhalb des Microsoft 365-Paketierungs- und Verteilungssystems und wird für die Verwaltung des App-Lebenszyklus (Veröffentlichung, Aktualisierung, Querladen) verwendet. Die Entra-Anwendungs-ID (Client-ID) wird für die OAuth-Authentifizierung verwendet, wenn Ihre App die Copilot-APIs aufruft.
Ausführliche Informationen zum App-Paket, zu Manifestfeldern und zur Verteilung finden Sie unter Agents sind Apps für Microsoft 365. Eine vollständige Erläuterung der Anwendung von Authentifizierungs- und Organisationsrichtlinien auf Copilot-API-Aufrufe finden Sie unter Sicherheit und Authentifizierung für Microsoft 365 Copilot-APIs.
Hinweis
Work IQ Dev Tools (Vorschau) — Wenn Sie einen deklarativen Agenten erstellen, wiqd können Sie diesen Einrichtungsschritt reduzieren: mit benannten Umgebungen, führt die Microsoft 365-App-Registrierung wiqd agent provision für den Agenten durch und schreibt die resultierenden IDs zurück in die Umgebungsdatei, sodass die App-Registrierung kein manueller erster Schritt ist. Dieser Prozess gilt für die Bereitstellung deklarativer Agents, nicht für Copilot-API-Clients im Allgemeinen. Weitere Informationen finden Sie in der Work IQ DevTools-Dokumentation.
REST-API-Integration
Die Copilot-APIs sind als Standard-REST-APIs unter dem Microsoft Graph-Namespace (graph.microsoft.com/v1.0/copilot und graph.microsoft.com/beta/copilot) verfügbar. Durch diese Integration können die APIs von jeder Programmiersprache oder Plattform aus zugänglich gemacht werden, die HTTP-Anforderungen unterstützt. Die APIs verwenden denselben Authentifizierungs- und Autorisierungsprozess wie andere Microsoft Graph-APIs. Alle Copilot-APIs respektieren standardmäßig die vorhandenen Richtlinien Ihrer Organization, einschließlich Identitätszugriff, bedingten Zugriff, Vertraulichkeitsbezeichnungen und Berechtigungskürzung.
Copilot-APIs im Vergleich zu Microsoft Graph-APIs
Microsoft Graph-APIs stellen im Allgemeinen CRUD-Vorgänge für Microsoft 365-Daten bereit. Die Copilot-APIs bieten KI-gestützte Funktionen, die auf Microsoft 365-Daten basieren. Verwenden Sie Microsoft Graph-APIs, wenn Sie Daten bearbeiten und darauf zugreifen müssen. Verwenden Sie die Copilot-APIs, wenn KI diese Daten analysieren muss. Dieser grundlegende Unterschied spiegelt sich im Lizenzmodell wider: Die Microsoft Graph-APIs sind unter den Standard-Lizenzbedingungen von Microsoft 365 verfügbar; für die Copilot-APIs ist eine Microsoft 365 Copilot-Lizenz erforderlich. Dieses Lizenzierungsmodell bietet höherwertige KI-Funktionen, die über den Standarddatenzugriff hinausgehen.
Verwandte Inhalte
- Mit Graph Explorer ausprobieren
- Erfahren Sie, wie Sie ein Authentifizierungstoken in Ihrer App abrufen.
- Abrufen aller Unternehmensinteraktionen
- KI-Erkenntnisse aufrufen
- Benutzerdefinierte Engine-Agents für Microsoft 365
- Sicherheit und Authentifizierung für Microsoft 365 Copilot APIs
- Lizenzierungs- und Kostenüberlegungen für Copilot-Erweiterungsoptionen
- Herstellen einer Verbindung mit anderen Agents über einen deklarativen Agent