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

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

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

RAG est essentiel lorsque vous créez des solutions d’IA génératives et que vous souhaitez utiliser les connaissances microsoft 365. Lorsque vous implémentez RAG, vos solutions peuvent fournir des réponses plus précises et contextuellement pertinentes, ancrées dans le vaste référentiel de données de votre organisation. L’API de récupération accomplit RAG en extrayant des extraits de texte à jour et pertinents à partir des connecteurs SharePoint, OneDrive et Copilot. L’API récupération conserve vos données en place et respecte 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 Graph Explorer.

Pourquoi utiliser l’API récupération ?

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

Les applications de connaissances personnalisées peuvent utiliser l’API de récupération pour présenter des réponses sur des informations spécifiques à organization stockées dans les connecteurs SharePoint, OneDrive et Copilot. Au lieu de créer et de gérer des index vectoriels distincts, ces applications peuvent à la place récupérer un contexte pertinent à partir de sources de données Microsoft 365 pour ancrer des réponses LLM (Large Language Model) de la même façon que Microsoft 365 Copilot.

Les applications financières et juridiques qui nécessitent une haute précision dans la récupération des informations peuvent utiliser les fonctionnalité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 obstacles à l’information et les contrôles d’accès.

Les applications multi-sources peuvent combiner du contenu SharePoint et/ou OneDrive avec des informations provenant de connecteurs Microsoft 365 Copilot, créant ainsi un base de connaissances unifié qui couvre les référentiels Microsoft 365 et tiers tout en conservant des contrôles de sécurité et de conformité cohérents.

Imaginez un cabinet de conseil spécialisé dans la fourniture de solutions sur mesure à ses clients, avec une part importante de leur travail axé sur les données stockées dans SharePoint. Le cabinet développe un agent de moteur personnalisé pour aider ses consultants à se préparer à des réunions clientes importantes. Cet agent doit accéder et récupérer des informations précises et à jour à partir de SharePoint. Le cabinet travaille avec deux clients importants qui sont des concurrents directs sur le marché. Par conséquent, l’entreprise a un besoin critique 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é et à garantir la pertinence et l’actualisation des données, ce qui simplifie l’effort de développement global.

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

L’API 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 conservé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. Dans un organization, le modèle d’autorisations dans Microsoft 365 garantit que les individus peuvent uniquement obtenir des résultats à partir du contenu auquel ils sont autorisés à accéder.

Résoudre pour la pertinence et l’actualisation

Étant donné que l’API de récupération récupère le contexte pertinent sans duplication de données, ses résultats sont actualisés et pertinents, et elle élimine la nécessité de gérer des pipelines de données distincts et coûteux.

Réduction du coût de possession et de l’effort de développement

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

• Gestion des moteurs de recherche
• Robots
• 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 et de conformité stricts dans Microsoft 365.

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

L’API 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 de base approprié dans la limite d’approbation Microsoft 365. Vous pouvez utiliser l’API pour étendre votre récupération à l’aide de Langage de requête par mots-clés (KQL) pour récupérer du contenu le plus important pour votre cas d’usage. Avec KQL, vous pouvez filtrer par URL, plages de dates, types de fichiers, etc.

Licences

L’API récupération est disponible sans frais supplémentaires pour les utilisateurs disposant d’une licence de module complémentaire Microsoft 365 Copilot. La prise en charge des utilisateurs sans licence de module complémentaire Microsoft 365 Copilot n’est pas disponible actuellement.

En accédant ou en utilisant l’API de récupération Microsoft 365 Copilot, vous acceptez les conditions d’utilisation des API Microsoft 365 Copilot (préversion) .

Meilleures pratiques

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

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

Appliquez la meilleure pratique suivante aux requêtes filtrées (requêtes avec un filterExpression) :

• Si vous souhaitez filtrer à l’aide du paramètre path dans SharePoint ou OneDrive, n’utilisez pas de lien de partage ou copiez l’URL à partir de la barre d’adresses. Au lieu de cela, accédez à l’emplacement du dossier ou du fichier dans SharePoint ou OneDrive en ligne et choisissez les trois points pour ouvrir Plus d’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 d’accès.

Limitations connues

Voici la limitation actuelle et d’autres limitations de l’API de récupération :

• Vous avez besoin des autorisations Files.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 des autorisations Files.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 requête queryString a une limite de 1 500 caractères.
• Vous devez récupérer à 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 le paramètre de requête filterExpression a une syntaxe KQL incorrecte, la requête s’exécute correctement 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 les informations de référence sur l’API.
• Le paramètre de requête maximumNumberOfResults a une valeur maximale de 25.
• La pertinenceScore dans la charge utile de réponse mesure la similarité du cosinus entre queryString et l’extrait, normalisée à la plage 0-1.
• Il est possible qu’un extrait soit retourné sans pertinenceScore lors de la récupération à partir des connecteurs Copilot.
• Jusqu’à 200 demandes par utilisateur et par heure sont prises en charge.
• La récupération du texte dans les tableaux est limitée aux fichiers .doc, .docx et .pptx dans OneDrive et SharePoint.
• La récupération à 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.
• En cas de récupération à partir de SharePoint ou OneDrive, la récupération sémantique et la récupération hybride ne sont prises en charge que pour les extensions de fichier .doc, .docx, .pptx, .pdf, .aspx et .one . Toutes les autres extensions de fichier prennent uniquement en charge la récupération lexicale.
• L’API de récupération est soumise à toutes les limitations de l’index sémantique Microsoft 365 Copilot.
• Si retrievalHits dans la charge utile de réponse est vide, aucun résultat pertinent n’a été trouvé.

Étape suivante