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.
Les agents déclaratifs s’exécutent sur l’infrastructure d’orchestration gérée et de modèle de langage de Microsoft 365 Copilot. Configurez les instructions, les sources de connaissances et les fonctionnalités prises en charge de l’agent plutôt que d’implémenter et d’héberger votre propre environnement d’exécution de conversation.
Un agent peut utiliser les sources de connaissances Microsoft 365, des fonctionnalités intégrées telles que l’interprétation de code, les compétences personnalisées (préversion) et les actions fournies par les serveurs MCP ou les API REST. Il peut également déléguer des tâches à des agents connectés. La disponibilité dépend de l’outil de création, de la version du manifeste, de l’expérience cible, des licences et des stratégies organisationnelles.
Cet article vous permet de comprendre la frontière entre la plateforme gérée et les composants que vous configurez ou exploitez. Pour une comparaison avec une architecture qui vous permet de contrôler l’orchestration et l’hébergement de modèle, voir Comparer les agents de moteur déclaratifs et personnalisés.
Composants d’architecture
Microsoft 365 Copilot fournit le runtime qui interprète les demandes des utilisateurs, récupère le contexte pertinent, sélectionne les fonctionnalités et génère des réponses. Votre configuration et les services externes déterminent ce que l’agent peut utiliser pour effectuer une tâche.
| Composant | Plateforme gérée | Responsabilités du développeur |
|---|---|---|
| Client | Héberge les conversations dans les expériences Microsoft 365 prises en charge. | Choisissez des expériences cibles et testez leurs interactions prises en charge, le contexte du document et les formats de réponse. |
| Infrastructure | Héberge l’orchestration Copilot et le runtime du modèle. | Configurez l’agent et hébergez les API externes, les serveurs MCP ou les autres services qu’il utilise. |
| Catalogue et distribution | Fournit des expériences d’acquisition, de publication et d’administration prises en charge. | Sélectionnez le package pris en charge et l’itinéraire de distribution, gérez les versions et travaillez avec les administrateurs sur l’accès et le déploiement. |
| Sécurité et conformité | Applique les protections d’identité, d’accès aux données et de plateforme Microsoft 365. | Configurez les autorisations et l’authentification, évaluez les flux de données et appliquez l’autorisation et la protection des données dans les services externes. |
| Orchestrator et modèle de langage | Sélectionne et appelle des fonctionnalités et génère des réponses. | Rédigez des instructions et des descriptions d’outils, configurez les paramètres de comportement pris en charge et évaluez le comportement obtenu. Vous ne remplacez pas l’orchestrateur géré par un code d’exécution personnalisé. |
| Connaissances et capacités | Récupère les connaissances prises en charge et exécute les fonctionnalités intégrées activées. | Sélectionnez les sources et fonctionnalités pertinentes, confirmez l’accès utilisateur et testez la qualité de la récupération. |
| Appel de l’outil | Appelle les actions MCP ou d’API configurées par le biais de l’intégration prise en charge. | Définissez les entrées et les sorties des outils, configurez l’authentification et les confirmations, et implémentez un comportement de service fiable. |
Les paramètres de configuration pris en charge influencent l’environnement d’exécution géré ; ils ne vous donnent pas un contrôle total sur sa mise en œuvre. Par exemple, le manifeste prend en charge un mode de réponse par défaut, que les utilisateurs peuvent remplacer. Suivez le schéma de manifeste sélectionné et l’outil de création pour connaître les paramètres disponibles.
Remarque
Le contenu récupéré et les réponses des outils peuvent contenir des instructions non approuvées. Les protections de plateforme ne remplacent pas les vérifications d’autorisation dans vos services ou l’évaluation du comportement de l’agent. Planifiez les exigences applicables en matière de données, de confidentialité et de sécurité.
Flux de données de l’agent déclaratif
Le flux conceptuel suivant décrit comment un agent utilise sa configuration et ses fonctionnalités. Il ne s’agit pas d’une séquence d’exécution fixe ou d’une garantie du nombre de récupérations ou d’appels d’outils qui se produisent.
- Recevoir une demande. L’utilisateur envoie une invite dans une expérience prise en charge. L’historique des conversations et le contexte d’application disponible peuvent contribuer à la demande.
- Sélectionnez le contexte et les fonctionnalités appropriés. Copilot utilise les instructions de l’agent, la configuration des connaissances et les descriptions des outils pour déterminer comment répondre à la demande.
- Récupérer des informations ou appeler des actions. Copilot récupère les connaissances disponibles ou appelle une fonctionnalité activée. Les actions externes utilisent le comportement d’authentification et de confirmation configuré. Les services externes appliquent leurs propres règles d’entreprise et d’autorisation.
- Générer une réponse. Copilot utilise le contexte disponible et les résultats de capacité pour répondre. En fonction de la tâche, l’interaction peut inclure d’autres appels, des demandes d’entrée utilisateur ou la délégation à un agent connecté.
Les agents déclaratifs peuvent enchaîner les appels d’API, utiliser la sortie d’un appel comme entrée d’un autre appel et combiner les connaissances SharePoint ou l’interpréteur de code avec des actions d’API. Pour obtenir des modèles et des exemples pris en charge, consultez Chaînage d’appels de fonction dans les plug-ins d’API.
Les instructions guident le comportement du modèle ; Ils ne remplacent pas la logique d’application qui doit appliquer une transaction, un ordre d’exécution exact ou une procédure de récupération. Implémentez ces exigences dans un service d’API ou de flux de travail, ou évaluez une architecture de moteur personnalisée lorsque vous devez posséder l’orchestration.
Conception pour des limites spécifiques à la capacité
Vérifiez les limites dans les instructions pour chaque fonctionnalité et intégration. La limite de caractères d’un champ manifeste, une limite de configuration de source de connaissances et une limite de contexte d’exécution décrivent différentes contraintes.
| Zone | Considérations relatives à la conception | Aide |
|---|---|---|
| Configuration de l’agent | Utilisez les propriétés et les fonctionnalités prises en charge par la version de schéma et l’outil de création sélectionnés. | Référence au manifeste de l’agent déclaratif |
| Récupération des connaissances | Sélectionnez les sources appropriées et respectez les exigences spécifiques en matière de fichiers, d’étendue, d’accès et d’indexation. Une réponse n’inclut pas nécessairement tous les éléments d’une source. | Sources de connaissances et Optimiser la récupération de contenu |
| Définitions d’outils et charges utiles | Gardez les outils ciblés et les entrées et les sorties pertinentes. Les entrées et sorties de plug-in volumineuses peuvent être tronquées, et les limites de contexte effectives peuvent changer en fonction des modèles et de la surcharge du système. | Limitations des plug-ins MCP et API |
| Contexte de document | Suivez les interactions de document et les formats de contenu pris en charge par l’application hôte plutôt que de supposer que tout le contenu du document est représenté de manière identique. | Interagir avec des documents |
| Comportement et latence du service | Testez les temps de réponse, les échecs d’authentification, les erreurs de service et les limites de vos API externes ou de vos serveurs MCP. | Intégrer et tester des composants |
Pour les grands ensembles de données, concevez des API pour filtrer, agréger ou retourner le sous-ensemble pertinent plutôt que d’envoyer tous les enregistrements dans une conversation. Lorsqu’un scénario nécessite du contenu documentaire, testez l’expérience hôte prise en charge : les agents déclaratifs peuvent accéder à l’intégralité du document ouvert dans Word et PowerPoint, sous réserve des considérations relatives au format du document.
Avantages et limites
Les principaux avantages et les principales limitations des agents déclaratifs permettent de déterminer si cette architecture est appropriée pour des cas d’utilisation spécifiques.
Principaux avantages
Les agents déclaratifs offrent des avantages significatifs aux organisations qui souhaitent implémenter des solutions d’IA dans des environnements Microsoft 365 existants :
- Runtime conversationnel géré : Microsoft héberge l’orchestrateur et l’infrastructure de modèle, vous n’avez donc pas besoin d’implémenter ce runtime.
- Accès aux fonctionnalités Microsoft : les agents peuvent utiliser des sources de connaissances prises en charge et des fonctionnalités intégrées en plus des outils externes.
- Personnalisation basée sur la configuration : les instructions, les fonctionnalités et les actions personnalisent l’expérience sans nécessiter de moteur de conversation personnalisé. Les intégrations externes peuvent toujours nécessiter du code et un hébergement.
Principales limitations
L’approche déclarative introduit également des contraintes qui peuvent limiter certains cas d’utilisation :
- Orchestration gérée : vous influencez le comportement par le biais d’une configuration prise en charge plutôt que de contrôler chaque décision d’exécution. Évaluez les tâches représentatives au lieu de traiter les instructions comme un moteur de flux de travail déterministe.
- Dépendances de la plateforme et de l’hôte : les fonctionnalités, la présentation des réponses, les licences et l’administration dépendent de l’expérience Microsoft 365 sélectionnée. Confirmez la prise en charge dans chaque hôte cible.
- Contraintes de contexte et de récupération : La récupération des connaissances et les résultats de l’outil doivent correspondre au contexte disponible. Les sources ou charges utiles volumineuses ne garantissent pas une couverture complète dans une réponse.
- Considérations relatives au contenu web dynamique : La recherche web étendue utilise du contenu indexé Bing plutôt que d’interroger directement la source de données sous-jacente. Le contenu généré dynamiquement peut être incomplet ou obsolète. Utilisez une intégration d’API prise en charge lorsque la tâche nécessite un accès direct aux données structurées actuelles. Voir Ancrage de la recherche web et contenu dynamique.
- Évaluation continue : les mises à jour de plateformes et de modèles peuvent modifier les comportements. Les instructions de test, la récupération et l’utilisation de l’outil au fur et à mesure de l’évolution de l’agent et de ses dépendances.
Alignement des cas d’utilisation
Choisissez l’architecture en fonction du contrôle requis par votre solution, et pas seulement en fonction des multiples étapes de la tâche.
Scénarios optimaux
Les agents déclaratifs sont optimaux pour :
- Récupération d’informations : agents qui ont principalement besoin de rechercher et de résumer des informations provenant de Microsoft 365 ou de sources externes.
- Actions assistées : agents qui combinent les connaissances et les actions API ou MCP prises en charge pour aider les utilisateurs à effectuer une tâche.
- Assistance et analyse de documents : agents qui travaillent avec le contexte de document pris en charge ou qui utilisent des fonctionnalités telles que l’interpréteur de code.
- Amélioration de la productivité : tâches qui bénéficient d’une expérience de conversation managée dans Microsoft 365.
Scénarios inadaptés
Envisagez un agent de moteur personnalisé ou un workflow implémenté séparément lorsque vos besoins incluent :
- Contrôle d’exécution personnalisé : vous devez implémenter votre propre orchestration, votre propre hébergement de modèle ou votre propre interface utilisateur plutôt que d’utiliser le runtime Copilot géré.
- Processus d’entreprise durables : le système doit appliquer l’ordre d’exécution exact, les limites des transactions, les tentatives ou la récupération indépendamment d’une conversation.
- Traitement des données à grande échelle : La tâche nécessite le traitement exhaustif d’un ensemble de données plutôt que la récupération ou l’analyse du contexte conversationnel pertinent. Effectuer ce traitement dans un service et exposer le résultat approprié à l’agent.
- Accès direct aux sources dynamiques : la tâche nécessite des résultats actuels et ordonnés à partir d’une source qui n’est pas correctement représentée dans la recherche web. Fournir une intégration API ou MCP prise en charge au lieu de vous fier uniquement à la recherche web étendue.
Ces exigences n’excluent pas toujours un agent déclaratif comme interface de conversation. Un service peut être propriétaire du processus d’entreprise pendant que l’agent recueille les entrées, appelle une action prise en charge et présente le résultat.