Guide de lecture localisé
declarative-agent-developerObjectif, utilisation et source
Créer, développer, déployer et localiser des agents déclaratifs pour M365Copilot et Teams. Utilisez cette compétence pour toute tâche impliquant un agent déclaratif, notamment la localisation, la création d'une structure de base, la modification de manifestes, l'ajout de fonctionnalités et le déploiement. La localisation nécessite des manifestes tokenisés et des fichiers de langue que seule cette compétence sait générer. Déclencheurs : « créer un agent », « créer un agent déclaratif », « nouvel agent déclaratif », « créer une structure de base pour un agent », « nouveau projet d'agent », « ajouter une fonctionnalité », « ajouter un plugin », « configurer mon agent », « déployer mon agent », « corriger le manifeste de mon agent », « modifier mon agent », « localiser mon agent », « ajouter une localisation », « traduire mon agent », « agent multilingue », « ajouter un plugin API », « ajouter un plugin MCP », « ajouter OAuth à mon plugin », « vérifier les instructions », « améliorer les instructions », « corriger mes instructions ».
Source récupérée:
- Dépôt source
- microsoft/skills
- SKILL.md
.github/plugins/microsoft-365-agents-toolkit/skills/declarative-agent-developer/SKILL.md- Étoiles du dépôt
- 3,157
- Mise à jour du dépôt
- 2026-10-31
- Catégories de capacités
- Flux de travail de l'agent
- Dernière collecte
Licence : MIT
Les extraits de flux de travail sont des outils de lecture et non des instructions exécutables de Codez. Aucune compétence tierce n'a été utilisée pour générer cette page.
Les passages relatifs à l'objectif et au flux de travail ci-dessous constituent le contenu original, organisé et traduit pour la lecture. Ils sont distincts de l'analyse éditoriale de Codez, qui est étiquetée séparément.
À quoi sert cette compétence ?
Créer, développer, déployer et localiser des agents déclaratifs pour M365Copilot et Teams. Utilisez cette compétence pour toute tâche impliquant un agent déclaratif, notamment la localisation, la création d'une structure de base, la modification de manifestes, l'ajout de fonctionnalités et le déploiement. La localisation nécessite des manifestes tokenisés et des fichiers de langue que seule cette compétence sait générer. Déclencheurs : « créer un agent », « créer un agent déclaratif », « nouvel agent déclaratif », « créer une structure de base pour un agent », « nouveau projet d'agent », « ajouter une fonctionnalité », « ajouter un plugin », « configurer mon agent », « déployer mon agent », « corriger le manifeste de mon agent », « modifier mon agent », « localiser mon agent », « ajouter une localisation », « traduire mon agent », « agent multilingue », « ajouter un plugin API », « ajouter un plugin MCP », « ajouter OAuth à mon plugin », « vérifier les instructions », « améliorer les instructions », « corriger mes instructions ».
Comment fonctionne le flux de travail en amont
⛔ Vérification de l'espace de travail — PREMIÈRE ÉTAPE OBLIGATOIRE
Avant toute chose, vérifiez les fichiers de l'espace de travail pour identifier le projet : Exécuternpx -y --package @microsoft/m365agentstoolkit-cli atk --versionPour confirmer que l'interface de ligne de commande ATK est installée. Si elle n'est pas trouvée → Arrêter. Demander à l'utilisateur d'installer ATK. Vérifierm365agents.ymlouteamsApp.ymlà la racine du projet. VérifiezappPackage/declarativeAgent.json.
6Mettez toujours à jour les instructions et les fiches de démarrage après toute modification.
L'ajout d'une fonctionnalité ou d'un plugin sans mise à jour des instructions est incomplet. Après toute modification : mettez à jour les instructions pour décrire…new/changedFonctionnalités — chaque source de données doit avoir une couverture d’intention claire (QUAND et POURQUOI l’utiliser) conformément au critère de qualité de la revue des instructions. Les fonctionnalités intégrées n’ont pas besoin de noms exacts ;actions/pluginsdoit être nommé. NE PAS lister les noms, descriptions ou paramètres des outils dans les instructions — ceux-ci se trouvent déjà dans les métadonnées du plugin (ai-plugin.json, manifestes MCP, configuration des capacités). Les instructions ne doivent contenir que la logique de décision : QUAND utiliser chaque outil, les règles d’enchaînement et la gestion des erreurs. Ajoutez au moins1amorce de conversation par ajoutcapability/plugin
export ATK_CLI_SKILL=trueConfiguration requise
Configuration de l'interface de ligne de commande ATK
Avant d'exécuter des commandes ATK, vérifiez si l'interface de ligne de commande ATK est disponible en exécutant la commande suivante :npx -y --package @microsoft/m365agentstoolkit-cli atk --versionSi le fichier est introuvable, ARRÊTEZ et informez l'utilisateur ; n'essayez PAS de l'installer vous-même. Toutes les commandes utilisent lenpx -y --package @microsoft/m365agentstoolkit-cli atkpréfixe (ex.,npx -y --package @microsoft/m365agentstoolkit-cli atk provision --env local).
3Compatibilité des versions de schéma
Avant d'ajouter une fonctionnalité, veuillez lire la documentation.versionchamp dansdeclarativeAgent.jsonVérifiez la matrice des fonctionnalités du schéma. Si la fonctionnalité n'est pas prise en charge par cette version, refusez et proposez une mise à niveau. Principaux points de contrôle des versions :
Limites et contrôles de qualité
2Ne jamais inventer de contenu ni créer de fichiers manquants.
N’inventez PAS de noms, de descriptions ou d’instructions provisoires. Ne créez PASdeclarativeAgent.jsonouappPackage/s'ils n'existent pas, il s'agit d'un scénario de REJET, et non d'un scénario d'« aide par la création ».
4. Utilisernpx -y --package @microsoft/m365agentstoolkit-cli atk add actionPour les plugins API — NE JAMAIS créer de fichiers de plugin manuellement
Il vous est interdit de créer manuellementai-plugin.json, les spécifications OpenAPI, les cartes adaptatives ou la modification duactionstableau. Utilisez l'interface de ligne de commande : exécutez une seule commande.npx -y --package @microsoft/m365agentstoolkit-cli atk add actionappel conformément à la spécification OpenAPI, listant toutes les opérations sous forme de liste séparée par des virgules dans--api-operationNe jamais exécuter séparémentnpx -y --package @microsoft/m365agentstoolkit-cli atk add actionCela fait appel à différentes opérations issues de la même spécification — ce qui crée plusieurs plugins au lieu d'un seul.npx -y --package @microsoft/m365agentstoolkit-cli atk add actionEn cas d'échec, signalez l'erreur ; NE PAS recourir à la création manuelle.
Commencez par un essai sans danger
- Vérifiez l'hôte pris en charge et les instructions d'installation du dépôt. Conservez le répertoire Skill ainsi que ses scripts, ressources et documentation référencés ;SKILL.mdSeul, il peut omettre les dépendances.
- Indiquez à l'agent vos paramètres d'entrée réels, le résultat souhaité et les critères d'acceptation. La syntaxe d'appel et les outils disponibles dépendent du système hôte ; ce site ne propose pas de commande d'installation universelle.
- Testez le flux de travail source dans un projet temporaire ou sur une copie. Avant d'autoriser les opérations qui modifient des fichiers, des services distants ou des ressources facturables, examinez-les attentivement.
- Vérifiez la conformité du résultat avec les contrôles qualité sources et vos propres exigences. Un déclenchement réussi ou un nombre élevé d'étoiles dans le dépôt ne garantissent pas un résultat correct.
Pour en savoir plus, consultez la source.
- Étiquetage de télémétrie
- ⛔ Vérification de l'espace de travail — PREMIÈRE ÉTAPE OBLIGATOIRE
- 🚫 RÈGLES DE REFUS SANS EXCEPTION — Aucune exception
- 🔍 Détecter → Informer → Demander (Protocole de gestion des erreurs)
- Configuration de l'interface de ligne de commande ATK
- 1Déployer après CHAQUE modification
- 2Ne jamais inventer de contenu ni créer de fichiers manquants.
- 3Compatibilité des versions de schéma
- 4. Utiliser
npx -y --package @microsoft/m365agentstoolkit-cli atk add actionPour les plugins API — NE JAMAIS créer de fichiers de plugin manuellement - 5Intégration du serveur MCP
- 6Mettez toujours à jour les instructions et les fiches de démarrage après toute modification.
- 7Exigence relative au nom de l'application
- Commun
- Échafaudage
- Développement JSON
Compétences connexes
Traduction et étendue
Ce guide de lecture sélectionne des passages de l'amont épingléSKILL.mdCette traduction est assistée. Elle ne constitue pas un manuel complet et ne garantit pas une compatibilité testée. Veuillez lire le document original et les fichiers auxquels il fait référence avant utilisation.
Cette introduction fait référence à la version épinglée ci-dessous ; l’activité actuelle du dépôt et la durée de la collecte sont indiquées séparément.
- Source épinglée
- Lire l'original ↗
- Source récupérée
- Commit source
00d66a64919edca5bca2c673373444e36a4b5461- Source SHA-256
13d2af8dd44cca049c8ebf8a8880cca304fc3dc419c926ef146dba35b14df412