Ajouter les expériences d’agent et de Microsoft 365 Copilot

S’applique à : Développeur

Les expériences des agents SharePoint Embedded permettent à votre application de répondre à des questions sur des fichiers stockés dans des conteneurs SharePoint Embedded. Deux produits distincts ancrent ces expériences dans le contenu conteneur :

  • Service d’agent Microsoft Foundry avec une source de connaissances SharePoint : pour les agents, vous créez sur Foundry. Foundry exécute la récupération pour vous en tant que membre de l’agent. Pour connaître les étapes de configuration, voir Configurer SharePoint Embedded en tant que source de connaissances Foundry.
  • API de récupération Microsoft 365 Copilot : pour les agents personnalisés et les applications qui exécutent leur propre étape d’ancrage. Appelez-le à partir de n’importe quelle application, y compris un agent Foundry qui n’utilise pas la source de connaissances SharePoint.

Choisissez la source de connaissances lorsque vous souhaitez que Foundry gère la récupération et l’orchestration de l’agent. Choisissez l’API de récupération lorsque vous souhaitez contrôler vous-même l’étape de mise à la terre, l’invite et le modèle.

Attention

L’ancien SDK de l’agent SharePoint Embedded (le contrôle ReactChatEmbedded) a été déconseillé en mars 2026 et remplacé par le service d’agent Microsoft Foundry avec une source de connaissances SharePoint (préversion) configurée pour SharePoint Embedded. Utilisez l’une des deux options décrites dans cet article pour vos nouveaux travaux.

Utiliser l’API de récupération

L’API de récupération de Microsoft 365 Copilot renvoie des extraits de texte pertinents que votre application transmet à son propre modèle en tant que données d’ancrage. Définir dataSource sur sharePointEmbedded pour récupérer du contenu SharePoint Embedded.

Remarque

La prise en charge de l’API de récupération pour la sharePointEmbedded source de données est en préversion.

Conditions préalables de l’API de récupération

  • Une application SharePoint Embedded avec au moins un conteneur, plus l’ID de type de conteneur.
  • Facturation à l’utilisation configurée pour le type de conteneur.
  • Au moins un utilisateur du client disposant d’une licence Microsoft 365 Copilot pour initialiser l’index sémantique. Pour plus d’informations, consultez Index sémantique pour Microsoft 365 Copilot.

La sharePointEmbedded source de données facture à l’utilisation, de sorte que chaque utilisateur qui interroge l’API de récupération n’a pas besoin d’une licence Microsoft 365 Copilot individuelle.

Récupérer du contenu à partir d’un type de conteneur

Appelez POST /copilot/retrieval avec un jeton délégué. Définissez dataSource et transmettez votre ID de sharePointEmbedded type de conteneur dans dataSourceConfiguration. La demande nécessite l’autorisation FileStorageContainer.Selected déléguée, et le service réduit les résultats au contenu auquel l’utilisateur connecté peut accéder.

POST https://graph.microsoft.com/v1.0/copilot/retrieval
Content-Type: application/json

{
  "queryString": "What are the terms of the Contoso agreement?",
  "dataSource": "sharePointEmbedded",
  "dataSourceConfiguration": {
    "sharePointEmbedded": {
      "containerTypeId": "{containerTypeId}"
    }
  }
}

Remplacez-le {containerTypeId} par l’ID de votre type de conteneur.

La réponse renvoie une retrievalHits collection. Chaque accès identifie un fichier source et webUrl comporte un ou plusieurs extracts, ordonné par relevanceScore.

{
  "retrievalHits": [
    {
      "webUrl": "https://contoso.com/spe/file",
      "extracts": [
        {
          "text": "The agreement renews annually unless either party gives 30 days' notice.",
          "relevanceScore": 0.8421
        }
      ]
    }
  ]
}

La forme de webUrl dépend du paramètre du type de conteneur. Traitez-le donc comme un lien opaque plutôt que de l’analyser urlTemplate . Pour résoudre les détails d’un fichier, appelez Obtenir un élément de lecteur. Pour plus d’informations sur urlTemplate, consultez la section Créer et configurer un type de conteneur.

Pour retourner des champs supplémentaires tels que title ou author avec chaque accès, ajoutez une resourceMetadata collection à la requête. Demander uniquement les champs utilisés par votre application, car chacun d’eux ajoute à la charge utile de la réponse.

Transmettez les extraits à votre propre modèle ou étape de génération de réponses en tant que données de base. Cet extrait envoie la requête et lit l’extrait supérieur de chaque accès :

const response = await fetch("https://graph.microsoft.com/v1.0/copilot/retrieval", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`
  },
  body: JSON.stringify({
    queryString: query,
    dataSource: "sharePointEmbedded",
    dataSourceConfiguration: {
      sharePointEmbedded: { containerTypeId: containerTypeId }
    }
  })
});

const data = await response.json();
const grounding = (data.retrievalHits ?? []).map(hit => ({
  url: hit.webUrl,
  text: hit.extracts?.[0]?.text?.trim(),
  score: hit.extracts?.[0]?.relevanceScore
}));

L’extraction couvre tous les conteneurs du type de conteneur auxquels l’utilisateur connecté peut accéder. Si une requête ne renvoie aucun résultat, vérifiez que l’index sémantique a été initialisé, que l’indexation s’est terminée et que l’utilisateur a accès au contenu.

Facturation de l’API de récupération

Demandes d’API de récupération qui utilisent la facture de sharePointEmbedded source de données sur le compteur de messages Copilot Studio. Les frais suivent le modèle de facturation configuré pour le type de conteneur. Standard facturation facture l’abonnement Azure du client propriétaire et la facturation directe facture l’abonnement du client consommateur.

Pour plus de détails sur les compteurs, consultez Compteurs de facturation. Pour comparer les modèles, voir Choisir un modèle de facturation.

Tester l’expérience de l’utilisateur

Connectez-vous avec un utilisateur qui peut accéder au contenu du conteneur. Chargez les fichiers pris en charge dans un conteneur, attendez l’indexation, ouvrez la conversation et posez les questions auxquelles le contenu du fichier peut répondre. Si les réponses omettent les fichiers attendus, cochez la case activée :

  • Détectabilité.
  • Formats de fichiers pris en charge.
  • Accès à l’application.
  • Accès utilisateur.
  • Sélection de l’étendue.
  • Retard d’indexation.

Étapes suivantes

  • Last updated on