Utiliser l'API Copilot Retrieval pour les recherches Microsoft 365

Introduction

L'API Copilot Retrieval constitue une avancée pour les professionnels IT cherchant à optimiser leurs intégrations avec Microsoft 365 Copilot. Cet outil permet d'effectuer des recherches ciblées sur des contenus dans SharePoint Online, OneDrive for Business, et des connecteurs externes, et fournit des extraits textuels pertinents pour enrichir les requêtes utilisateur.

Fonctionnalités clés de l'API Copilot Retrieval

Qu'est-ce que le "Grounding" des requêtes ?

Le grounding consiste à contextuellement enrichir les requêtes utilisateur en utilisant des extraits textuels issus des sources approuvées de Microsoft 365. Contrairement à des outils comme ChatGPT qui traitent des documents uploadés, l'API Copilot Retrieval permet des recherches profondes dans les données Microsoft 365.

Différences entre l'API Search et l'API Retrieval

• API Search : Effectue des recherches sémantiques.
• API Retrieval : Exécute des recherches basées sur la méthode RAG, complétées par des extraits textuels.

Ce positionnement facilité par Microsoft offre un contexte riche pour les applications intégrées telles que Word, Excel ou PowerPoint.

Accès et permissions de l'utilisateur connecté

L'utilisation de cette API est limitée au contexte du utilisateur connecté. Cela signifie que l'API nécessite des permissions déléguées comme :

• Files.Read.All
• Sites.Read.All
• ExternalItem.Read.All pour les connecteurs

Ces permissions garantissent que l'API ne retourne que les résultats accessibles à l'utilisateur connecté.

Tutoriel : Utiliser l'API Copilot Retrieval avec le Microsoft Graph PowerShell SDK

Voici une série d'étapes pour exécuter une recherche via l'API Copilot Retrieval :

1Connect-MgGraph -NoWelcome -Scopes Files.Read.All, Sites.Read.All

1$Uri = 'https://graph.microsoft.com/v1.0/copilot/retrieval'

1$BodyRequest = @{}
2$BodyRequest.Add("datasource", "sharepoint")
3$BodyRequest.Add("queryString", "Comment écrire un script PowerShell pour Microsoft 365")
4$BodyRequest.Add("maximumNumberOfResults", "3")

1$BodyRequest.add("filterexpression", 'FileExtension:"DOCX" AND LastModifiedTime>=2025-11-01 AND LastModifiedTime<=2026-01-31')

1[array]$Data = Invoke-MgGraphRequest -Uri $Uri -Method Post -Body $BodyRequest -OutputType PsObject

1$Hits = $Data.RetrievalHits
2ForEach ($Hit in $Hits) {
3    Write-Host "Titre du fichier :" $Hit.ResourceMetaData.Title
4    Write-Host "Date de création :" $Hit.ResourceMetadata.Created
5    Write-Host "Pertinence :" $Hit.extracts.relevanceScore
6    Write-Host "Label de sensibilité :" $Hit.SensitivityLabel.DisplayName
7    Write-Host "Extrait :" $Hit.extracts.text.substring(0,120)
8}

Utilisations possibles et avantages

• Contextualisation optimisée des requêtes pour les applications Copilot.
• Amélioration des résultats en utilisant les filtres avancés et métadonnées.
• Intégration facilitée avec Microsoft Graph et PowerShell.

Conclusion

L'API Copilot Retrieval ouvre la voie à une recherche contextuelle avancée dans l'environnement Microsoft 365, offrant aux équipes IT un outil puissant pour exploiter les données dans leurs processus automatisés ou leurs applications personnalisées. À mesure que Microsoft continue de renforcer ses fonctionnalités dans Microsoft 365 Copilot, rester agile avec ces outils permettra de maximiser leurs avantages.