Vue d’ensemble de l’API de récupération de Microsoft 365 Copilot

Les API Microsoft 365 Copilot donnent accès aux composants qui alimentent les expériences Copilot, ce qui vous permet d’améliorer vos agents de moteur personnalisés et vos solutions d’IA générative avec les fonctionnalités de Microsoft 365 Copilot. L’API de récupération de Microsoft 365 Copilot vous permet d’ancrer vos solutions d’IA générative sur vos connaissances Microsoft 365 et non Microsoft en renvoyant des blocs de texte pertinents à partir de l’index hybride qui alimente Microsoft 365 Copilot.

L’API Retrieval offre une solution rationalisée pour la génération augmentée de récupération (RAG) sans avoir besoin de répliquer, d’indexer, de segmenter et de sécuriser vos données dans un index séparé. L’API comprend le contexte et l’intention de l’utilisateur et effectue des transformations de requête pour obtenir les résultats les plus pertinents, ce qui est plus difficile à obtenir avec une recherche lexicale ou même un RAG de base à partir d’autres sources.

Le RAG est essentiel lorsque vous créez des solutions d’IA générative et que vous souhaitez utiliser les connaissances de Microsoft 365. Lorsque vous mettez en œuvre RAG, vos solutions peuvent fournir des réponses plus précises et contextuellement pertinentes basées sur le vaste référentiel de vos données organisationnelles. L’API de récupération accomplit RAG en extrayant des extraits de texte à jour et pertinents à partir de connecteurs SharePoint, OneDrive et Copilot. L’API de récupération maintient vos données en place et maintient vos contrôles d’accès et de gouvernance. L’API de récupération garantit que les réponses synthétisées sont informées par les données les plus récentes et les plus pertinentes. Ce processus améliore la fiabilité et l’utilité de vos solutions d’IA générative.

Pour explorer l’API, essayez une requête dans la démonstration interactive.

Pourquoi utiliser l’API de récupération ?

L’API de récupération offre un moyen sécurisé et conforme de récupérer des blocs de texte pertinents à partir de connecteurs SharePoint, OneDrive et Copilot tout en optimisant le rappel de contexte. Ainsi, vous n’avez pas besoin de sortir des données, de casser les autorisations ou de faire des compromis sur la sécurité et la conformité.

Les applications de connaissances personnalisées peuvent utiliser l’API Retrieval pour fonder des réponses sur des informations spécifiques à l’organization stockées dans des connecteurs SharePoint, OneDrive et Copilot. Plutôt que de créer et de gérer des index vectoriels distincts, ces applications peuvent récupérer le contexte pertinent à partir de sources de données Microsoft 365 pour mettre en place des réponses de modèle de langage volumineux (LLM) de la même manière que Microsoft 365 Copilot.

Les applications financières et juridiques qui nécessitent une grande précision dans la récupération d’informations peuvent utiliser les capacités de filtrage de l’API pour étendre les recherches à des bibliothèques de documents ou à des types de contenu spécifiques, garantissant que les réponses incluent uniquement des sources approuvées tout en respectant les barrières d’information et les contrôles d’accès.

Les applications multi-sources peuvent combiner du contenu SharePoint et OneDrive avec des informations provenant de connecteurs Microsoft 365 Copilot, créant ainsi une base de connaissances unifiée qui couvre à la fois Microsoft 365 et des dépôts tiers tout en maintenant des contrôles de sécurité et de conformité cohérents.

Imaginez une société de conseil spécialisée dans la fourniture de solutions sur mesure à ses clients, avec une part importante de leur travail axée sur les données stockées dans SharePoint. La société développe un agent moteur personnalisé pour aider ses consultants à se préparer aux réunions importantes avec les clients. Cet agent doit accéder à des informations précises et à jour de SharePoint et les récupérer. Le cabinet travaille avec deux clients majeurs qui sont des concurrents directs sur le marché. Par conséquent, l’entreprise a un besoin essentiel de maintenir des normes de sécurité et de conformité rigoureuses pour s’assurer que les documents et les données d’un client ne sont jamais accessibles à l’autre. L’API de récupération aide l’entreprise à gérer les risques de conformité et de sécurité, à garantir la pertinence et l’actualisation des données, ce qui simplifie l’effort global de développement.

Gérer les risques de sécurité et de conformité

L’API de récupération utilise les fonctionnalités de sécurité et de conformité intégrées dans Microsoft 365 pour garantir que les autorisations de source de données et les paramètres de conformité sont préservés. En récupérant les données sur place, il empêche les fuites de données et garantit que les informations sensibles d’un client ne sont jamais accessibles à un autre, ce qui est essentiel pour maintenir des normes de sécurité et de conformité strictes. Au sein d’une organisation, le modèle d’autorisations dans Microsoft 365 garantit que les individus ne peuvent obtenir des résultats qu’à partir du contenu auquel ils sont autorisés à accéder.

Recherchez la pertinence et la fraîcheur

Parce que l’API de récupération récupère le contexte pertinent sans duplication de données, ses résultats restent à jour et pertinents, et elle élimine le besoin de maintenir des pipelines de données distincts et coûteux.

Réduction du coût de possession et des efforts de développement

L’API de récupération élimine le besoin de créer un pipeline sécurisé d’exportation et d’indexation des données qui peut entraîner des coûts importants pour les organisations. L’API prend en charge les fonctionnalités requises suivantes :

• Gestion du moteur de recherche
• Robots d’exploration
• Connecteurs de données
• Stockage des données
• Analyseurs de contenu
• Indexation
• Sécurité

Les organisations peuvent utiliser ces fonctionnalités intégrées pour éviter les dépenses et les complexités, et maintenir des contrôles d’accès stricts et une conformité dans Microsoft 365.

Fonctionnalités de l’API de récupération

L’API de récupération vous permet de récupérer des données à partir des sources de données suivantes :

• SharePoint
• OneDrive
• Connecteurs Copilot

L’API prend en charge les requêtes en langage naturel et utilise la pile Microsoft 365 Copilot pour récupérer le contexte d’ancrage pertinent dans la limite d’approbation Microsoft 365. Vous pouvez utiliser l’API pour étendre votre récupération à l’aide du langage de requête par mots-clés (KQL) afin de récupérer le contenu le plus important pour votre cas d’utilisation. Avec KQL, vous pouvez filtrer par URL, plages de dates, types de fichiers, etc.

Licences

L’API de récupération est disponible sans frais supplémentaires pour les utilisateurs disposant d’une licence de module complémentaire Microsoft 365 Copilot. En accédant à l’API de récupération de Microsoft 365 Copilot ou en l’utilisant, vous acceptez les conditions d’utilisation des API de Microsoft 365 Copilot (préversion).

Pour les utilisateurs sans licence de module complémentaire Microsoft 365 Copilot, l’API de récupération est disponible via la consommation de paiement à l’utilisation (préversion) pour les sources de données au niveau du locataire telles que les connecteurs SharePoint et Copilot. Les sources de données au niveau de l’utilisateur telles que OneDrive ne sont pas disponibles.

Les utilisateurs titulaires d’une licence non-Copilot qui ont activé le paiement à l’utilisation pour l’API de récupération peuvent utiliser l’outil SharePoint dans Microsoft Foundry via la consommation avec paiement à l’utilisation.

Pour plus d’informations sur la façon d’activer et de désactiver la consommation de paiement à l’utilisation de l’API de récupération, ainsi que sur la tarification, consultez Présentation du paiement à l’utilisation de l’API de récupération.

Meilleures pratiques

Les bonnes pratiques suivantes s’appliquent aux requêtes non filtrées (requêtes sans filterExpression) et aux requêtes filtrées (requêtes avec une filterExpression) :

• Les résultats et extraits renvoyés par l’API de récupération ne sont pas ordonnés. Pour cette raison, nous vous recommandons de ne pas limiter le maximumNumberOfResults , sauf si vous avez des exigences strictes quant au nombre de jetons que votre LLM peut consommer.
• Envoyez tous les extraits renvoyés par l’API de récupération à votre LLM/orchestrator pour la génération de réponses.
• Évitez les requêtes génériques qui peuvent s’appliquer à une grande variété de contenu.
• Fournissez autant de contexte que possible dans la requête.
• Votre queryString doit être une phrase unique.
• Évitez les fautes d’orthographe dans les mots clés riches en contexte lorsque vous construisez votre queryString.

Appliquez les bonnes pratiques suivantes aux requêtes filtrées (requêtes avec une expression filterExpression) :

• Si vous souhaitez filtrer à l’aide du paramètre path dans SharePoint ou OneDrive, n’utilisez pas de lien de partage et ne copiez pas l’URL à partir de la barre d’adresses. Accédez plutôt à l’emplacement du dossier ou du fichier dans SharePoint ou OneDrive en ligne, puis sélectionnez les trois points pour ouvrir Autres actions. Faites défiler le volet vers le bas et choisissez Détails. À partir de là, vous pouvez faire défiler le volet de navigation gauche pour rechercher et copier le chemin.

Limitations connues

Voici les limitations actuelles et autres limitations de l’API de récupération :

• Vous avez besoin du Files. Autorisations Read.All et Sites.Read.All pour récupérer du contenu SharePoint à l’aide de l’API de récupération.
• Vous avez besoin du Files. Autorisations Read.All et Sites.Read.All pour récupérer du contenu OneDrive à l’aide de l’API de récupération.
• Vous avez besoin de l’autorisation ExternalItem.Read.All pour récupérer le contenu des connecteurs Copilot à l’aide de l’API de récupération.
• L’API de récupération est optimisée pour le rappel de contexte.
• Le paramètre de demande queryString a une limite de 1 500 caractères.
• Vous devez effectuer une récupération à partir d’une source de données à la fois à l’aide du paramètre de requête dataSource . Les résultats entrelacés ne sont pas pris en charge.
• Si la syntaxe KQL du paramètre de demande filterExpression est incorrecte, la requête s’exécute sans étendue.
• Toutes les propriétés SharePoint et OneDrive ne sont pas prises en charge dans filterExpression. Pour obtenir la liste des propriétés prises en charge, consultez la référence de l’API.
• Le paramètre de requête maximumNumberOfResults a une valeur maximale de 25.
• Le repertinenceScore dans la charge utile de réponse mesure la similarité cosinus entre queryString et l’extrait, normalisée à la plage 0-1.
• Il est possible qu’un extrait soit retourné sans repertinenceScore lors de la récupération à partir de connecteurs Copilot.
• Jusqu’à 200 demandes par utilisateur et par heure sont prises en charge.
• L’extraction à partir du texte des tableaux est limitée aux fichiers .doc, .docx et .pptx dans OneDrive et SharePoint.
• L’extraction à partir de contenu non textuel, y compris les images et les graphiques, n’est pas prise en charge.
• Les résultats des fichiers avec des extensions .docx, .pptx et .pdf supérieures à 512 Mo ne sont pas pris en charge. Les résultats des fichiers dont l’extension est supérieure à 150 Mo ne sont pas pris en charge.
• Si vous récupérez à partir de SharePoint ou OneDrive, la récupération sémantique et hybride est prise en charge uniquement pour les extensions de fichier.doc, .docx, .pptx, .pdf, .aspx et .one . Toutes les autres extensions de fichier ne prennent en charge que la récupération lexicale.
• L’API de récupération est soumise à toutes les limitations de l’index sémantique de Microsoft 365 Copilot.
• Si retrievalHits dans la charge utile de réponse est vide, aucun résultat pertinent n’a été trouvé.

Étape suivante