Freigeben über

Verwenden der Copilot-Connectors-API

Sie können Microsoft 365 Copilot Connectors (früher Microsoft Graph-Connectors) verwenden, um Daten aus externen Diensten in Microsoft Graph zu übertragen. Mit der Copilot-Connectors-API können Sie externe Daten indizieren, um intelligente Umgebungen in Microsoft 365 wie Copilot und Microsoft Search zu unterstützen.

Anforderungen zum Indizieren von Daten werden im Auftrag einer Anwendung ohne das Vorhandensein eines angemeldeten Benutzers über ein Zugriffstoken mit Anwendungsberechtigung ausgeführt.

Erstellen eines benutzerdefinierten Copilot-Connectors

Das Erstellen eines benutzerdefinierten Copilot-Connectors umfasst vier Schritte:

  1. Erstellen Sie eine Entra ID-App-Registrierung (früher als Azure Active Directory bezeichnet). Zusammen mit der Anforderung an Microsoft Graph übermitteln Sie den Namen der App-Registrierung und api-Berechtigungen, die Ihre App benötigt. Microsoft Graph antwortet mit Informationen zur neu erstellten App-Registrierung.
  2. Erstellen Sie eine externe Verbindung. Jede Verbindung erfordert eine eindeutige ID, einen Namen und eine Beschreibung.
  3. Erstellen Sie das Schema für die externe Verbindung. Das Schema definiert die Form von externen Inhalten, die Sie über diese Microsoft Graph-Verbindung erfassen. Das Erstellen des Schemas ist ein Zeitintensiver Vorgang. Nachdem Sie das Schema zum Erstellen der Verbindung übermittelt haben, antwortet Microsoft Graph mit einer URL, mit der Sie die status des Vorgangs überprüfen können. Das Schema wird bereitgestellt, solange der Vorgang status istinprogress. Nach Abschluss der Bereitstellung gibt der Vorgang eine completed status zurück.
  4. Erfassen externer Inhalte. Extrahieren Sie es für jedes externe Element aus dem Quellinhaltsrepository, transformieren Sie es so, dass es dem Schema für Ihre externe Verbindung entspricht, und übermitteln Sie es als externes Element an Microsoft Graph. Fügen Sie zusammen mit dem Element Informationen darüber ein, wer darauf zugreifen darf, auch als Zugriffssteuerungsliste (Access Control List, ACL) bezeichnet.

Im Folgenden finden Sie ein Sequenzdiagramm, das die vier Schritte zum Erstellen eines Copilot-Connectors veranschaulicht.

Diagramm der vier Schritte zum Erstellen eines Copilot-Connectors

Allgemeine Anwendungsfälle

In der folgenden Tabelle sind häufige Anwendungsfälle für die Copilot-Connectors-API aufgeführt.

Anwendungsfälle REST-Ressourcen Siehe auch
Konfigurationsaktionen
Erstellen, Aktualisieren oder Löschen einer Verbindung externalConnection externalConnection Methoden
Registrieren eines Schemas für die externen Daten schema schema Methoden
Indizierungsaktionen
Hinzufügen, Aktualisieren oder Löschen eines benutzerdefinierten Elements im Index externalItem externalItem Methoden

Bekannte Einschränkungen

Im folgenden werden die aktuell bekannten Beschränkungen aufgeführt:

  • Eine Anwendung ist auf 25 gleichzeitige Vorgänge für eine Verbindung beschränkt.
  • Die maximale Größe einer externalItem Entität beträgt 4 MB.

Verwandte Inhalte

  • Last updated on