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.
L’orchestrateur Microsoft 365 Copilot coordonne le modèle de langage, le contexte disponible et les fonctionnalités qu’il utilise pour répondre à une demande utilisateur. Pour les agents déclaratifs, ces fonctionnalités peuvent inclure la récupération des connaissances, les fonctionnalités intégrées et les actions fournies par MCP ou les plug-ins d’API.
Cet article explique comment la configuration de votre agent influence la sélection et l’appel des actions. Vous fournissez des instructions, des définitions d’outils et des services externes ; Microsoft gère le runtime de conversation. Pour une division plus large des responsabilités, voir Architecture de l’agent déclaratif.
Copilot Orchestrator
L’orchestrateur utilise la configuration de l’agent et le contexte disponible pour déterminer s’il doit répondre directement, récupérer des connaissances ou appeler un outil. Toutes les demandes ne nécessitent pas une action extérieure.
Par exemple, un utilisateur peut demander : « Quels sont les tickets qui m’ont été attribués en ce moment ? » Un agent disposant d’une action de ticketing appropriée peut récupérer les informations actuelles du service de ticketing plutôt que de s’appuyer sur les connaissances du modèle.
Le diagramme suivant illustre une interaction API-action. Il s’agit d’une vue conceptuelle, et non d’une séquence d’exécution fixe ou d’une garantie que chaque requête utilise Microsoft Graph ou une API externe.
- Interpréter la demande. Copilot utilise l’invite, les instructions de l’agent, l’historique des conversations et le contexte de l’application disponible pour identifier la tâche de l’utilisateur. Les vérifications de la sécurité et des stratégies de la plateforme peuvent déterminer si et comment la demande est traitée.
- Sélectionnez les fonctionnalités pertinentes. Copilot détermine si les connaissances configurées ou les outils peuvent aider. Pour une action externe, les descriptions des plugins et des outils aident à identifier une opération appropriée.
- Déterminer les entrées et appeler l’outil. Copilot mappe les informations disponibles aux paramètres de l’outil. Les instructions devraient le guider pour demander les informations requises manquantes plutôt que d’inventer des valeurs. Les appels externes utilisent le comportement d’authentification et deconfirmation configuré.
- Interprétez le résultat. Copilot utilise les données renvoyées ou l’erreur pour déterminer l’étape suivante. L’interaction peut inclure un autre appel, une demande de clarification ou une réponse à l’utilisateur.
- Répondre à l’utilisateur. Copilot génère une réponse à l’aide du contexte et des résultats disponibles. La réponse doit refléter ce que le service a réellement renvoyé ou modifié.
Les agents déclaratifs prennent en charge le chaînage des appels de fonction, notamment la transmission de la sortie d’un appel d’API à un autre et la combinaison des actions d’API avec les connaissances SharePoint ou l’interpréteur de code. Concevez et testez les interactions requises plutôt que de supposer un nombre fixe d’appels toujours terminés à un tour. Suivez les limitations actuelles des plugins et les limites de vos services externes.
Les protections de plateforme et les confirmations de l’utilisateur ne remplacent pas les vérifications d’autorisation ou de règle métier dans votre service externe. Si le flux de travail nécessite un ordre d’exécution, des transactions ou une récupération exacts, implémentez ces exigences dans le service plutôt que de vous fier aux instructions du modèle.
Comment l’orchestrateur de Copilot fait correspondre les actions aux requêtes des utilisateurs
La sélection des plugins et l’appel d’outils individuels sont des décisions différentes. La description d’un plug-in aide Copilot à identifier le service ou le domaine approprié. Les outils disponibles à partir de ce plug-in décrivent ensuite les opérations que Copilot peut appeler et les entrées dont elles ont besoin.
Lorsque la sélection du plugin utilise la correspondance sémantique, la correspondance est basée sur la description du plugin, et non sur les descriptions des fonctions individuelles. Un plugin correspondant rend ses fonctions ou outils disponibles ; Il ne s’agit pas d’une liste restreinte fixe de cinq fonctions. Pour connaître le comportement de sélection actuel et les contraintes de contexte, consultez Limitations des plug-ins MCP et API.
Fournissez des descriptions utiles à chaque niveau :
| Configuration | Que décrire ? |
|---|---|
| Description du plug-in | L’objectif du service, les tâches utilisateur prises en charge et le domaine. Rendez la description suffisamment spécifique pour la distinguer des autres plugins. |
| Définition d’une fonction ou d’un outil | Objectif de l’opération, quand l’utiliser et si elle récupère ou modifie des données. Pour les plugins API, mappez le nom de la fonction à l’OpenAPI operationId. |
| Paramètres | Entrées, types, formats et exemples significatifs requis. Distinguez les identificateurs des noms complets et indiquez clairement les comportements facultatifs. |
| Résultats et erreurs | Les données renvoyées, ce que signifie une opération réussie et comment les échecs sont représentés. Conservez les charges utiles pertinentes par rapport à la tâche. |
Pour les plugins d’API, suivez Créer des descriptions OpenAPI effectives. Pour les plug-ins MCP, case activée si les définitions d’outils sont découvertes dynamiquement ou épinglées dans le manifeste du plug-in. Avec la découverte dynamique, les modifications apportées aux définitions des outils du serveur peuvent affecter la sélection sans republier l’agent.
Améliorer et évaluer la sélection des actions
Les descriptions et les instructions influencent la sélection. Ils ne garantissent pas qu’un outil particulier est invoqué pour chaque formulation d’une requête.
- Clarifier les opérations qui se chevauchent. Si plusieurs outils semblent appropriés, expliquez leurs différents objectifs et les intrants requis. Distinguer les opérations de lecture des opérations qui modifient les données.
- Relier les tâches aux outils indiqués dans les instructions. Expliquez quand utiliser les outils configurés, comment collecter les informations manquantes et comment utiliser les résultats antérieurs dans les demandes de suivi. Consultez Instructions pour les agents avec plug-ins API.
- Concentrez-vous sur les outils disponibles. Exposez les opérations nécessaires aux tâches de l’agent. Un plus grand nombre de définitions d’outils et des charges utiles plus importantes consomment du contexte et peuvent réduire la qualité des réponses.
- Testez les sélections et les résultats réels. Incluez les invites paraphrasées, les demandes ambiguës, les entrées manquantes, les tâches en plusieurs étapes, les confirmations annulées et les échecs de service. Vérifiez les opérations et les paramètres reçus par le service, pas seulement la formulation finale.
- Répétez les tests lorsque les définitions changent. Réexécutez des cas représentatifs après avoir modifié les descriptions des plugins, les définitions d’outils, les instructions ou la plateforme. Inclure les mises à jour du serveur MCP lors de l’utilisation de la découverte dynamique.
Importante
Une réponse conversationnelle manquante ou incomplète n’établit pas si une opération externe a abouti. Vérifiez le résultat du service avant de réessayer une opération qui modifie les données, et concevez le service pour qu’il traite les demandes répétées en toute sécurité.
Pour obtenir des recommandations de conception plus larges, consultez Meilleures pratiques relatives aux agents déclaratifs. Pour des cas de test et des assertions répétables, consultez Vue d’ensemble de l’évaluation des agents.