Créer un agent déclaratif

Lors de la génération ou de la réutilisation, implémentez le composant d’agent déclaratif sélectionné dans votre plan de composants. Cet article vous aide à choisir la procédure du produit et à confirmer que le composant est prêt. Vous terminez avec un agent fonctionnel, ses dépendances et des preuves de test pour l’intégration du plugin.

Vous n’avez pas besoin d’un agent pour chaque plug-in. Pour votre propre orchestration, vos propres modèles, votre hébergement ou votre environnement d’exécution, suivez plutôt le chemin d’accès de l’application .

Vérifier un agent existant avant d’en créer un

  1. Examinez les utilisateurs prévus, les expériences prises en charge, les instructions, les connaissances, les actions, les autorisations et les limitations connues de l’agent existant avec son propriétaire.

    Vérifiez : Ses fonctionnalités documentées correspondent à l’expérience de la tâche et de la cible dans votre plan de composants.

  2. Sélectionnez la voie de réutilisation ou d’extension documentée du produit. Vous pouvez commencer avec un modèle d’agent ou copier un agent Agent Builder dans Copilot Studio lorsque ce flux de travail convient.

    Vérifiez : L’itinéraire prend en charge votre source et votre destination. Ne présumez pas que l’ajout d’un composant d’agent à un plug-in importe un projet existant.

  3. Mettez-vous d’accord sur la propriété, le contrôle de version, la prise en charge et la gestion des modifications, puis testez les tâches représentatives.

    Vérifiez : Enregistrez les résultats et les écarts non résolus avant de décider d’utiliser l’agent tel quel, de le configurer ou de créer un nouveau composant.

Démarrage avec les outils de développement Work IQ

Pour le développement professionnel, commencez avec Work IQ Dev Tools, choisissez un environnement documenté et ajoutez Agents Toolkit uniquement lorsque votre composant a besoin de ses contrôles de projet spécifiques.

Votre point de départ Procédure produit Résultat attendu
Un nouveau plug-in nécessitant un composant d’agent Créer un plug-in avec les outils de développement Work IQ wiqd plugin create crée le conteneur ; wiqd plugin add agent Créez un modèle automatique du composant d’agent facultatif.
Un projet source d’agent déclaratif existant Cycle de vie des composants de l’agent Continuez la création et l’itération spécifiques à l’agent avec les commandes documentées wiqd agent .
Instructions, connaissances ou actions de l’agent qui doivent être modifiées Agents déclaratifs dans WIQD et la référence de commande Source enregistrée configurée pour le composant et l’environnement sélectionnés.

Utilisez le plug-in coding-assistant WIQD pour le travail guidé ou l’interface CLI directe pour les commandes répétables. Installez le plug-in de l’assistant de codage et l’interface de ligne de commande en tant que prérequis distincts si nécessaire. GitHub Copilot aide à créer des fichiers, des instructions, une configuration et des tests ; il ne remplace pas l’outil de création, le runtime ou les exigences des composants.

Pour un projet d’agent existant, sélectionnez explicitement la validation hors ligne :

wiqd agent validate --mode source --env dev

Vérifiez : Lisez les résultats de la source enregistrée et corrigez les erreurs signalées. Une case activée de code source réussie n’établit pas le comportement d’exécution, l’accessibilité des points de terminaison, l’exactitude de l’authentification ou l’acceptation du package final. Le mode par défaut package consomme un fichier ZIP existant, le charge à des fins de validation et peut nécessiter une connexion.

Pour ajouter une compétence à un projet d’agent WIQD existant, case activée l’indicateur de fonctionnalité et les agent-skills exigences de schéma actuelles dans la référence de commande de compétence de l’agent. Une compétence de plugin de haut niveau et une compétence attachée à un agent déclaratif sont des enregistrements différents ; ni l’un ni l’autre n’établit de soutien chez chaque hôte.

Utiliser une autre voie de produit lorsqu’elle correspond au composant

Configuration Procédure produit
Création gérée dans Microsoft 365 Copilot Vue d’ensemble d’Agent Builder et création d’agents
Logique low-code, environnements gérés ou connecteurs Power Platform Copilot Studio et Connect et configurer un agent pour Teams et Microsoft Copilot
Manifestes d’agent de niveau inférieur et intégrations de développement prises en charge Outils de développement Work IQ (recommandé pour les scénarios pro-code pris en charge)
Compétences dans un agent Toolkit existant Ajouter des compétences avec Agents Toolkit

Les agents Copilot Studio autonomes apparaissent dans le registre des agents, et non sous les plug-ins. Ne présumez pas que la publication d’un agent autonome le reconditionne en tant que plug-in.

Configurer et tester l’agent

Pour obtenir des étapes de mise en œuvre détaillées, suivez les instructions sur les produits à agent déclaratif :

Travail à terminer Conseils faisant autorité Vérifier
Définir l’identité, le comportement, les limites des tâches et les amorces de conversation Agent de build ou Générez avec JSON, puis Écrire des instructions efficaces Les invites représentatives produisent le comportement attendu et restent dans la tâche prévue.
Configurer les connaissances et les fonctionnalités Sources de connaissances et Ajouter des fonctionnalités et des actions personnalisées Les données obligatoires sont disponibles pour l’utilisateur concerné et indisponibles lorsque les autorisations ne le permettent pas.
Ajouter des actions MCP ou d’API prises en charge Plug-ins MCP et API pour les agents déclaratifs La sélection d’outil, l’authentification, le consentement, les confirmations, les erreurs et les demandes non prises en charge se comportent comme prévu.
Ajouter une compétence prise en charge Compétences en agents déclaratifs et procédure de création sélectionnée L’agent cible charge la compétence et effectue la tâche définie dans les limites de ce produit.
Gérer la configuration de votre itinéraire de création Environnements et versions de Toolkit ou environnements WIQD Les valeurs d’identité, les dépendances et les paramètres appartiennent à l’environnement de test prévu.

Enregistrez la version de l’agent, le propriétaire, les expériences prises en charge, les dépendances, les limitations connues et les résultats des tests. Des essais propres au produit sont requis ; La validation du code source ou du package ne prouve pas que tous les utilisateurs peuvent exécuter la tâche.

Pour obtenir des conseils de conception, consultez Meilleures pratiques pour les agents déclaratifs et Comment l’orchestrateur Copilot choisit les actions. Lorsque le comportement requis fonctionne, vous pouvez éventuellement activer les commentaires des utilisateurs et optimiser la récupération de contenu.

Étape suivante

Continuez tous les composants restants dans la génération ou la réutilisation. Lorsqu’ils sont prêts, entrez dans le package & tester avec Intégrer et tester vos composants.