Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Les API Microsoft 365 Copilot vous permettent d’accéder en toute sécurité aux fonctionnalités de Microsoft 365 Copilot dans vos propres applications et agents de moteur personnalisés, tout en vous alignant sur les normes de conformité de Microsoft 365. Que vous créiez un agent de moteur personnalisé pour Microsoft 365 Copilot avec vos propres modèles ou orchestrateur ou une expérience conversationnelle dans vos propres applications, les API Copilot fournissent un accès aux composants qui alimentent les expériences Microsoft 365 Copilot.
Les développeurs d’entreprise sont confrontés aujourd’hui à un défi critique : comment exploiter la puissance de l’IA tout en conservant un accès sécurisé aux connaissances organisationnelles, sans compromettre la conformité ou la gouvernance. Les approches traditionnelles vous obligent à créer des systèmes d’IA complexes à partir de zéro et à extraire des données sensibles vers des sources externes. Les API Microsoft 365 Copilot offrent un accès à des fonctionnalités d’IA prêtes pour la production qui fonctionnent directement avec vos données Microsoft 365.
En accédant aux API Microsoft 365 Copilot ou en les utilisant, vous acceptez les conditions d’utilisation des API Microsoft 365 Copilot (préversion).
Conseil
Voulez-vous explorer les API avant d’écrire du code ? Essayez la démonstration interactive pour voir les demandes et réponses d’API en direct avec vos données Microsoft 365.
Fonctionnalités de l’API Copilot
Les API Copilot fournissent un ensemble complet de fonctionnalités qui vous permettent de créer des applications basées sur l’IA et ancrées dans les données d’entreprise.
Le tableau suivant répertorie les API et décrit leurs fonctionnalités et scénarios.
| API | Utilisez-le pour | Exemple de scénario |
|---|---|---|
| API de récupération | Récupérer des informations pertinentes à partir du contenu Microsoft 365 de manière sécurisée et conforme. | Connectez vos propres modèles IA au contenu Microsoft 365 sans extraction de données. Créez des assistants spécialisés qui répondent en fonction de la documentation, des stratégies et des bases de connaissances à jour de votre organisation. Ces applications peuvent fournir des informations contextuelles pertinentes aux utilisateurs de tous les départements tout en respectant les contrôles d’accès aux documents et les étiquettes de confidentialité. |
| API de recherche (préversion) | Effectuez une recherche hybride (sémantique et lexicale) dans OneDrive professionnel ou scolaire à l’aide de requêtes en langage naturel avec une compréhension contextuelle et des résultats intelligents. | Créez des applications de recherche basées sur l’IA qui aident les utilisateurs à découvrir des documents et des fichiers pertinents à l’aide de requêtes en langage naturel plutôt que de correspondances exactes de mots clés, tout en maintenant la sécurité et la conformité. |
| API d’exportation d’interaction | Activez les solutions de conformité pour capturer et archiver les interactions des utilisateurs avec Copilot dans les applications Microsoft 365. | Développez des systèmes qui conservent des enregistrements complets des interactions avec l’IA, permettent de surveiller l’utilisation de l’IA et garantissent la conformité aux stratégies organisationnelles et aux exigences réglementaires. Ces solutions sont précieuses pour les secteurs réglementés où la documentation et la révision de la génération de contenu assistée par l’IA sont nécessaires. |
| API notifications de modification des interactions IA (préversion) | S’abonner pour modifier les notifications pour les interactions Copilot dans Microsoft 365. | Créez des applications qui surveillent et enregistrent les interactions d’IA en temps réel, ce qui permet des contrôles de conformité proactifs, la détection des anomalies et les audits. |
| API d’informations sur les réunions | Extrayez les notes de réunion, les éléments d’action et les sujets de discussion générés par l’IA pour les réunions Teams. | Créez des applications qui extraient et organisent automatiquement les éléments d’action, les décisions et les résumés des réunions Teams. Reliez-les à des outils de gestion de projet, des systèmes CRM ou des flux de travail personnalisés. Ces systèmes peuvent transformer les réunions du temps passé en valeur créée en capturant, en organisant et en activant automatiquement les résultats des réunions. |
| API notifications de modification d’Insights IA (préversion) | S’abonner pour modifier les notifications pour Copilot Insights IA des réunions Teams. | Créez des applications qui utilisent Teams meeting Insights IA, ce qui garantit la capture cohérente des détails clés et favorise l’alignement. |
| API de chat (préversion) | Activez les expériences conversationnelles optimisées par Microsoft 365 Copilot dans vos applications personnalisées. | Intégrez Microsoft 365 Copilot dans vos applications d’entreprise qui peuvent répondre aux questions, effectuer des tâches et fournir des conseils en fonction des données Microsoft 365 et du contexte utilisateur. Ces interfaces peuvent améliorer la productivité des utilisateurs en apportant des fonctionnalités d’IA directement dans les outils qu’ils utilisent quotidiennement, des portails personnalisés aux applications mobiles. |
| API Rapports d’utilisation Copilot | Interroger le nombre d’utilisateurs et les données d’utilisation de Microsoft 365 Copilot dans votre organisation. | Créez des rapports pour suivre l’adoption de Microsoft 365 Copilot par vos utilisateurs. |
| API de gestion des packages | Affichez et gérez les agents au sein de votre organisation. | Créez un inventaire de tous les agents au sein de votre organisation. |
Remarque
L’API de chat renvoie des réponses textuelles ; elle répond aux questions et fournit des conseils, mais n’effectue pas d’actions telles que la création de fichiers, l’envoi d’e-mails ou la planification de réunions. Pour plus d’informations, voir les limitations connues de l’API de Chat.
Avantages clés
Les API Copilot offrent les avantages suivants pour vos applications :
- Ancrage, gouvernance et conformité sécurisés : accédez directement à l’index de connaissances de Microsoft 365. Toutes les autorisations, étiquettes de confidentialité, contrôles de conformité, audit, journalisation, surveillance et application des stratégies existantes sont automatiquement respectés. Pour plus d’informations sur le modèle de sécurité et d’authentification, consultez Sécurité et authentification pour les API Microsoft 365 Copilot.
- IA prête pour la production - Accélérez le développement de vos pipelines de génération augmentée (RAG) personnalisés et le traitement de la transcription des réunions en utilisant les mêmes fonctionnalités d’IA de production que celles qui alimentent Microsoft 365 Copilot. Que vous développiez vos solutions à l’aide d’Azure AI Foundry, de Microsoft Copilot Studio ou du SDK Microsoft Agents, les API Copilot sont intégrées de manière transparente à la plateforme.
- IA responsable : lorsque vous utilisez ces expériences Copilot et intelligentes, vous êtes protégé contre les contenus nuisibles via les vérifications de validation RAI.
Configuration requise
Pour intégrer et libérer tout le potentiel des API Copilot dans vos applications et agents de moteur personnalisés, vous devez accéder aux éléments suivants :
Licence Microsoft 365 Copilot - Obligatoire pour chaque utilisateur qui accède aux fonctionnalités de Microsoft 365 Copilot via ces API. Cette licence permet d’accéder aux fonctionnalités d’IA qui alimentent les API.
Abonnement Microsoft 365 : Un abonnement E3 ou E5 (ou équivalent) constitue la base de Microsoft 365 Copilot. Cet abonnement permet d’accéder aux services et données Microsoft 365 sur lesquels Copilot s’appuie.
De l’inscription de l’application au client API
La génération d’un agent ou d’une application pour Microsoft 365 suit une chaîne qui connecte le modèle d’application aux API Copilot :
- Vous créez un package d’application , c’est-à-dire l’ensemble du manifeste, des icônes et des métadonnées défini par le modèle d’application Microsoft 365.
- Dans le cadre de ce package, vous effectuez une inscription d’application dans Microsoft Entra ID, qui génère un ID d’application (client).
- Au moment de l’exécution, vous fournissez cet ID d’application (client) à un fournisseur d’authentification (tel que MSAL) pour acquérir des jetons d’accès pour le compte de l’utilisateur connecté.
- Vous transmettez le jeton résultant lorsque vous appelez les API Copilot (par exemple, l’API de récupération).
L’inscription d’application est le pont entre le modèle d’empaquetage et le modèle de consommation d’API. C’est là que l’identité de votre package d’application devient les informations d’identification qui autorisent les appels d’API Copilot.
Le id champ dans le manifeste de l’application et l’ID de l’application (client) d’Entra sont des identificateurs différents qui servent à des fins différentes. Le manifeste id identifie votre application dans le système d’empaquetage et de distribution Microsoft 365 et est utilisé pour la gestion du cycle de vie des applications (publication, mise à jour, chargement indépendant). L’ID de l’application (client) Entra est utilisé pour l’authentification OAuth lorsque votre application appelle les API Copilot.
Pour plus d’informations sur le package d’application, les champs de manifeste et la distribution, consultez Les agents sont des applications pour Microsoft 365. Pour obtenir une explication complète de la façon dont l’authentification et les stratégies organisationnelles s’appliquent aux appels d’API Copilot, consultez Sécurité et authentification pour les API Microsoft 365 Copilot.
Remarque
Work IQ Dev Tools (préversion) : si vous créez un agent déclaratif, wiqd vous pouvez réduire cette étape de configuration : avec les environnements nommés, wiqd agent provision effectue l’inscription de l’application Microsoft 365 pour l’agent et réécrit les ID résultants dans le fichier d’environnement, de sorte que l’inscription de l’application n’est pas une première étape manuelle. Ce processus s’applique au provisionnement de l’agent déclaratif, et non aux clients d’API Copilot en général. Pour plus d’informations, consultez la documentation sur les outils de développement Work IQ.
Intégration de l’API REST
Les API Copilot sont disponibles en tant qu’API REST standard sous l’espace de noms Microsoft Graph (graph.microsoft.com/v1.0/copilot et graph.microsoft.com/beta/copilot). Cette intégration rend les API accessibles à partir de n’importe quel langage de programmation ou plateforme prenant en charge les requêtes HTTP. Les API utilisent le même processus d’authentification et d’autorisation que les autres API Microsoft Graph. Toutes les API Copilot respectent les stratégies existantes de votre organisation, notamment l’accès à l’identité, l’accès conditionnel, les étiquettes de confidentialité et le découpage des autorisations, par défaut.
API Copilot et API Microsoft Graph
Les API Microsoft Graph fournissent généralement des opérations CRUD sur les données Microsoft 365. Les API Copilot offrent des fonctionnalités basées sur l’IA et les données Microsoft 365. Utilisez les API Microsoft Graph lorsque vous devez manipuler et accéder aux données ; utilisez les API Copilot lorsque vous avez besoin de l’IA pour analyser ces données. Cette différence fondamentale se reflète dans le modèle de licence : les API Microsoft Graph sont disponibles sous les termes du contrat de licence standard Microsoft 365 ; les API Copilot nécessitent une licence Microsoft 365 Copilot. Ce modèle de licence offre des fonctionnalités d’IA à plus forte valeur ajoutée au-delà de l’accès standard aux données.
Contenu connexe
- Essayer avec l’Afficheur Graph Explorer
- Découvrez comment obtenir un jeton d’authentification dans votre application
- Obtenir toutes les interactions avec l’entreprise
- Appelez des informations sur l’IA
- Agents de moteur personnalisés pour Microsoft 365
- Sécurité et authentification pour les API Microsoft 365 Copilot
- Considérations relatives aux licences et aux coûts pour les options d’extensibilité de Copilot
- Se connecter à d’autres agents à partir d’un agent déclaratif