Übersicht über Microsoft 365 Copilot-APIs

Mit den Microsoft 365 Copilot-APIs können Sie sicher auf Microsoft 365 Copilot Funktionen in Ihren eigenen Anwendungen und benutzerdefinierten Engine-Agents zugreifen und gleichzeitig die Compliancestandards von Microsoft 365 einhalten. Unabhängig davon, ob Sie einen benutzerdefinierten Engine-Agent für Microsoft 365 Copilot mit Ihren eigenen Modellen oder Orchestratoren oder eine Konversationsumgebung 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 den sicheren Zugriff auf Organisationswissen erhalten, ohne Die Compliance oder Governance zu beeinträchtigen. Herkömmliche Ansätze zwingen Sie, komplexe KI-Systeme von Grund auf neu zu erstellen und vertrauliche Daten in externe Quellen zu extrahieren. Die Microsoft 365 Copilot-APIs bieten Zugriff auf produktionsbereite KI-Funktionen, die direkt mit Ihren Microsoft 365-Daten arbeiten.

Indem Sie auf die Microsoft 365 Copilot-APIs zugreifen oder diese verwenden, stimmen Sie den nutzungsbedingungen für Microsoft 365 Copilot APIs (Vorschau) zu.

Tipp

Möchten Sie die APIs vor dem Schreiben von Code untersuchen? Testen Sie die interaktive Demo (Vorschau), 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 erstellen können, die auf Unternehmensdaten basieren.

In der folgenden Tabelle sind die APIs aufgeführt und ihre Funktionen und Szenarien beschrieben.

API Verwenden Sie es, um Beispielszenario
Abruf-API Abrufen relevanter Informationen aus Microsoft 365-Inhalten auf sichere und konforme Weise. Verbinden Sie Ihre eigenen KI-Modelle ohne Datenextraktion mit Microsoft 365-Inhalten. Erstellen Sie spezialisierte Assistenten, die auf der Grundlage der aktuellen Dokumentation, Richtlinien und Wissensdatenbanken Ihrer organization reagieren. Diese Anwendungen können benutzern abteilungsübergreifend kontextrelevante Informationen bereitstellen und dabei Die Zugriffssteuerungen und Vertraulichkeitsbezeichnungen berücksichtigen.
Such-API (Vorschau): Durchführen einer hybriden Suche (semantisch und lexikalisch) in OneDrive für Arbeits- oder Schulinhalte mithilfe von Abfragen in natürlicher Sprache mit kontextbezogenem Verständnis und intelligenten Ergebnissen. Erstellen Sie KI-gestützte Suchanwendungen, die Benutzern helfen, relevante Dokumente und Dateien mithilfe von Abfragen in natürlicher Sprache zu ermitteln, anstatt genaue Schlüsselwort (keyword) Übereinstimmungen zu verwenden, und gleichzeitig die Sicherheit und Compliance aufrechtzuerhalten.
Interaktionsexport-API Ermöglichen Sie Compliancelösungen, um Benutzerinteraktionen mit Copilot in Microsoft 365-Anwendungen zu erfassen und zu archivieren. Entwickeln Sie Systeme, die umfassende Aufzeichnungen von KI-Interaktionen verwalten, die Überwachung der KI-Nutzung ermöglichen und die Einhaltung von Organisationsrichtlinien und gesetzlichen Anforderungen sicherstellen. Diese Lösungen sind für regulierte Branchen nützlich, in denen die Generierung von INHALTEn mit KI-Unterstützung dokumentiert und überprüft werden muss.
API für Änderungsbenachrichtigungen für KI-Interaktionen (Vorschau) Abonnieren Sie Änderungsbenachrichtigungen für Copilot-Interaktionen in Microsoft 365. Erstellen Sie Anwendungen, die KI-Interaktionen in Echtzeit überwachen und protokollieren, um proaktive Konformitätsprüfungen, Anomalieerkennung und Überwachung zu ermöglichen.
Meeting Insights-API Extrahieren sie KI-generierte Besprechungsnotizen, Aktionselemente und Diskussionsthemen für Teams-Besprechungen. Erstellen Sie Anwendungen, die automatisch Aktionselemente, Entscheidungen und Zusammenfassungen aus Teams-Besprechungen extrahieren und organisieren. Verknüpfen Sie diese mit Projektmanagementtools, CRM-Systemen oder benutzerdefinierten Workflows. Diese Systeme können Besprechungen von der aufgewendeten Zeit in einen Mehrwert transformieren, indem besprechungsergebnisse automatisch erfasst, organisiert und aktiviert werden.
KI Insights-API für Änderungsbenachrichtigungen (Vorschau) Abonnieren Sie Änderungsbenachrichtigungen für Copilot KI Insights von Teams-Besprechungen. Erstellen Sie Anwendungen, die Teams-Besprechungs-KI Insights verwenden, um eine konsistente Erfassung wichtiger Details sicherzustellen und die Ausrichtung zu fördern.
Chat-API (Vorschau) Aktivieren Sie Unterhaltungen, die von Microsoft 365 Copilot in Ihren benutzerdefinierten Anwendungen unterstützt werden. Integrieren Sie Microsoft 365 Copilot in Ihre Unternehmensanwendungen, die Fragen beantworten, Aufgaben ausführen und Anleitungen basierend auf Microsoft 365-Daten und Benutzerkontext bereitstellen können. Diese Schnittstellen können die Benutzerproduktivität verbessern, indem ki-Funktionen direkt in die Tools integriert werden, die sie täglich verwenden, von benutzerdefinierten Portalen bis hin zu mobilen Apps.
API für Copilot-Nutzungsberichte Abfragen von Benutzeranzahlen und Nutzungsdaten für Microsoft 365 Copilot in Ihrem organization. Erstellen Sie Berichte, um die Einführung von Microsoft 365 Copilot durch Ihre Benutzer nachzuverfolgen.
Paketverwaltungs-API Anzeigen und Verwalten von Agents in Ihrem organization. Erstellen Sie ein Inventar aller Agents in Ihrem organization.

Hinweis

Die Chat-API gibt Textantworten zurück. Es beantwortet Fragen und bietet Anleitungen, führt jedoch keine Aktionen wie das Erstellen von Dateien, das Senden von E-Mails oder das Planen von Besprechungen durch. Weitere Informationen finden Sie unter Bekannte Einschränkungen für die Chat-API.

Hauptvorteile

Die Copilot-APIs bieten die folgenden Vorteile für Ihre Anwendungen:

  • Sicheres Grounding, 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 erfüllen Sie die Transkriptionsverarbeitung, indem Sie die gleichen KI-Funktionen auf Produktionsniveau verwenden, die 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 durch RAI-Überprüfungen vor schädlichen Inhalten geschützt.

Anforderungen

Um das volle Potenzial der Copilot-APIs in Ihre Anwendungen und benutzerdefinierten Engine-Agents 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 Funktionalität zugreift. Diese Lizenz bietet 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:

  1. Sie erstellen ein App-Paket – das Bündel aus Manifesten, Symbolen und Metadaten, die vom Microsoft 365-App-Modell definiert werden.
  2. Als Teil dieses Pakets führen Sie eine App-Registrierung in Microsoft Entra ID durch, die eine Anwendungs-ID (Client-ID) erzeugt.
  3. Zur Laufzeit geben Sie diese Anwendungs-ID (Client-ID) an einen Authentifizierungsanbieter (z. B. MSAL) an, um Zugriffstoken im Namen des angemeldeten Benutzers abzurufen.
  4. Sie übergeben das resultierende Token, wenn Sie die Copilot-APIs aufrufen (z. B . die Abruf-API).

Die App-Registrierung ist die Brücke zwischen dem Paketmodell und dem API-Verbrauchsmodell – hier wird Ihre App-Paketidentität zu den Anmeldeinformationen, die Copilot-API-Aufrufe autorisieren.

Das id Feld im App-Manifest und die Entra Anwendungs-ID (Client) sind unterschiedliche Bezeichner, die unterschiedlichen Zwecken dienen. Das Manifest id identifiziert Ihre App im Microsoft 365-Paket- und Verteilungssystem und wird für die Verwaltung des App-Lebenszyklus (Veröffentlichen, Aktualisieren, Querladen) verwendet. Die Entra-Anwendungs-ID (Client) 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.

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. Diese Integration ermöglicht den Zugriff auf die APIs über jede Programmiersprache oder Plattform, die HTTP-Anforderungen unterstützt. Die APIs verwenden den gleichen Authentifizierungs- und Autorisierungsprozess wie andere Microsoft Graph-APIs. Alle Copilot-APIs respektieren die vorhandenen Richtlinien Ihrer organization, einschließlich Identitätszugriff, bedingter Zugriff, Vertraulichkeitsbezeichnungen und Berechtigungskürzungen.

Copilot-APIs im Vergleich zu Microsoft Graph-APIs

Microsoft Graph-APIs bieten in der Regel CRUD-Vorgänge für Microsoft 365-Daten. 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 Sie KI benötigen, um diese Daten zu ermitteln. Dieser grundlegende Unterschied spiegelt sich im Lizenzierungsmodell wider: Die Microsoft Graph-APIs sind unter den Standardmäßigen Microsoft 365-Lizenzbedingungen verfügbar; Die Copilot-APIs erfordern eine Microsoft 365 Copilot-Lizenz. Dieses Lizenzierungsmodell bietet höherwertige KI-Funktionen, die über den Standarddatenzugriff hinausgehen.

Verwandte Inhalte

  • Last updated on