Utiliser l’API des connecteurs Copilot

Vous pouvez utiliser Microsoft 365 Copilot connecteurs (anciennement connecteurs Microsoft Graph) pour importer des données de services externes dans Microsoft Graph. L’API des connecteurs Copilot vous permet d’indexer des données externes afin d’alimenter des expériences intelligentes dans Microsoft 365, telles que Copilot et Microsoft Search.

Les demandes d’indexation des données sont effectuées pour le compte d’une application sans la présence d’un utilisateur connecté via un jeton d’accès avec l’autorisation de l’application.

Créer un connecteur Copilot personnalisé

La création d’un connecteur Copilot personnalisé implique quatre étapes :

1. Créez une inscription d’application Entra ID (anciennement Appelée Azure Active Directory). En plus de la demande adressée à Microsoft Graph, vous envoyez le nom de l’inscription de l’application et des autorisations d’API dont votre application a besoin. Microsoft Graph répond avec des informations sur l’inscription de l’application nouvellement créée.
2. Créez une connexion externe. Chaque connexion nécessite un ID, un nom et une description uniques.
3. Créez le schéma pour la connexion externe. Le schéma définit la forme du contenu externe que vous allez ingérer via cette connexion Microsoft Graph. La création du schéma est une opération de longue durée. Une fois que vous avez envoyé le schéma pour créer la connexion, Microsoft Graph répond avec une URL que vous pouvez utiliser pour case activée le status de l’opération. Le schéma est en cours d’approvisionnement tant que l’opération status est inprogress. Une fois l’approvisionnement terminé, l’opération retourne un completed status.
4. Ingérer du contenu externe. Pour chaque élément externe, extrayez-le du référentiel de contenu source, transformez-le pour qu’il corresponde au schéma de votre connexion externe et envoyez-le à Microsoft Graph en tant qu’élément externe. En plus de l’élément, incluez des informations sur les personnes autorisées à y accéder, également appelée liste de contrôle d’accès (ACL).

Voici un diagramme de séquence qui illustre les quatre étapes de création d’un connecteur Copilot.

Cas d’utilisation courants

Le tableau suivant répertorie les cas d’usage courants pour l’API des connecteurs Copilot.

Limitations connues

Les éléments suivants sont les limitations connues à ce jour :

• Une application est limitée à 25 opérations simultanées sur une connexion.
• La taille maximale d'une entité externalItem est de 4 Mo.

Contenu connexe

• Vue d’ensemble des connecteurs Copilot