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.
Importante
Le KIT de développement logiciel (SDK) TeamsFx sera officiellement déconseillé d’ici septembre 2025, et le support se poursuivra jusqu’en septembre 2026. Nous vous recommandons de planifier votre transition vers le Kit de développement logiciel (SDK) Teams pour créer des agents dans Microsoft Teams. Pour étendre les fonctionnalités de votre agent à d’autres plateformes Microsoft 365, utilisez le Microsoft 365 Agents SDK.
L’interface de ligne de commande du Kit de ressources Microsoft 365 Agents (interface CLI agents Toolkit) est une interface de ligne de commande basée sur du texte qui peut aider à générer, valider et déployer des applications pour Microsoft 365 à partir du terminal ou d’un processus CI/CD. Pour plus d’informations, consultez code source et package npm.
Que vous préfériez les opérations de développement centrées sur le clavier ou que vous automatisiez votre pipeline CI/CD, l’interface CLI Agents Toolkit offre les mêmes fonctionnalités que les extensions IDE. Il fournit les fonctionnalités suivantes pour faciliter le développement d’agents ou d’applications pour Microsoft 365 Copilot, Microsoft Teams et Microsoft 365 :
- Collaboration : invitez d’autres développeurs à collaborer sur votre projet Agent Toolkit pour déboguer et déployer.
- Création de l’agent/de l’application : générez un agent ou une application à l’aide de modèles et d’exemples disponibles.
- Aperçu de l’agent/de l’application : chargez et affichez un aperçu de votre agent ou application dans Teams, Outlook et l’application Microsoft 365.
- Provisionnement et déploiement des ressources : approvisionnez les ressources cloud nécessaires et déployez votre application sur Azure.
- Validation, empaquetage et publication : validez, empaquetez et publiez votre agent ou votre application à l’aide de commandes CLI.
- Gestion de l’environnement : gérez plusieurs environnements, applications Microsoft Entra et inscription d’applications Teams.
Prise en main
Installez @microsoft/m365agentstoolkit-cli à partir de npm et exécutez atk -h pour vérifier toutes les commandes disponibles :
npm install -g @microsoft/m365agentstoolkit-cli
atk -h
Commandes prises en charge
Le tableau suivant répertorie les commandes prises en charge pour aider les développeurs à créer et à gérer des agents ou des applications :
| Command | Description |
|---|---|
atk doctor |
Outil de vérification des prérequis pour la génération de Microsoft 365 Apps. |
atk new |
Créez une application Microsoft 365. |
atk add |
Ajoutez une fonctionnalité à votre application Microsoft 365. |
atk auth |
Gérer les comptes Microsoft 365 et Azure. |
atk entra-app |
Gérez l’application Microsoft Entra dans l’application actuelle. |
atk env |
Gérer des environnements. |
atk help |
Afficher l’aide de l’interface CLI de Microsoft 365 Agents Toolkit. |
atk install |
Chargez un package d’application donné dans Microsoft 365. |
atk launchinfo |
Obtenez les informations de lancement d’une application Microsoft 365 acquise. |
atk list |
Répertoriez les exemples et modèles d’application Microsoft 365 disponibles. |
atk provision |
Exécutez la phase d’approvisionnement dans m365agents.yml ou m365agents.local.yml. |
atk deploy |
Exécutez la phase de déploiement dans m365agents.yml ou m365agents.local.yml. |
atk package |
Générez votre application Microsoft 365 dans un package à des fins de publication. |
atk validate |
Validez l’application Microsoft 365 à l’aide du schéma de manifeste, des règles de validation ou des cas de test. |
atk publish |
Exécutez la phase de publication dans m365agents.yml. |
atk preview |
Affichez un aperçu de l’application actuelle. |
atk update |
Mettez à jour le manifeste de l’application Microsoft 365 vers le Portail des développeurs. |
atk upgrade |
Mettez à niveau le projet pour qu’il fonctionne avec la dernière version de Microsoft 365 Agents Toolkit. |
atk collaborator |
Vérifiez, accordez et répertoriez les autorisations pour qui peut accéder et gérer l’application Microsoft 365 et Microsoft Entra application. |
atk uninstall |
Nettoyez les ressources associées à l’ID de manifeste, à l’ID de titre ou à un environnement. |
Options globales
Voici les options globales que vous pouvez utiliser avec chaque commande :
| Options | Description |
|---|---|
--version -v |
Afficher la version de l’interface CLI de Microsoft 365 Agents Toolkit. |
--help -h |
Afficher l’aide de l’interface CLI de Microsoft 365 Agents Toolkit. |
--interactive -i |
Exécutez la commande en mode interactif. La valeur par défaut est True. |
--debug |
Imprimer les informations de débogage. La valeur par défaut est false. |
--verbose |
Imprimer les informations de diagnostic. La valeur par défaut est false. |
--telemetry |
Active la télémétrie. La valeur par défaut est True. |
Mode interactif
Les commandes ont différents modes interactifs par défaut. Certaines commandes sont interactives par défaut et d’autres non interactives. Pour déterminer le mode interactif par défaut d’une commande, utilisez l’option -h avec la commande spécifique.
atk doctor
La atk doctor commande vérifie les prérequis nécessaires pour générer Microsoft 365 Apps.
atk new
La atk new commande fonctionne en mode interactif par défaut et fournit des conseils pour créer une application Microsoft 365. Pour travailler atk new en mode non interactif, définissez l’indicateur sur false--interactive .
atk new
atk new -i false
| Command | Description |
|---|---|
atk new sample |
Créez une application à partir d’un exemple existant. |
atk list samples |
Affiche la liste de tous les exemples préexistants disponibles. |
atk new Paramètres
Le tableau suivant répertorie les paramètres disponibles pour atk new:
| Paramètre | Obligatoire | Description |
|---|---|---|
--app-name -n |
Oui | Nom de votre application. |
--capability -c |
Oui | Spécifie la fonctionnalité de l’application. Les options disponibles sont declarative-agent, basic-custom-engine-agent et weather-agent. Utilisez atk list templates pour afficher toutes les options disponibles. |
--programming-language -l |
Non | Langage de programmation. Les options disponibles sont javascript, typescriptet csharp. La valeur par défaut est javascript. |
--folder -f |
Non | Répertoire où le dossier du projet est créé. La valeur par défaut est ./. |
--spfx-solution -s |
Non | Créez ou importez une solution SharePoint Framework existante. Les options disponibles sont new et import. La valeur par défaut est new. |
--spfx-install-latest-package |
Non | Installez la dernière version de SharePoint Framework. La valeur par défaut est true. |
--spfx-framework-type -k |
Non | Applicable si la capacité framework est sélectionnée. Les options disponibles sont minimal, reactet none. La valeur par défaut est react. |
--spfx-webpart-name -w |
Non | Nom du composant WebPart SharePoint Framework. La valeur par défaut est helloworld. |
--spfx-folder |
Non | Répertoire ou chemin d’accès qui contient la solution SharePoint Framework existante. |
--me-architecture -m |
Non | Architecture de l’extension de message basée sur la recherche. Les options disponibles sont new-api, api-specet bot. La valeur par défaut est new-api. |
--openapi-spec-location -a |
Non | Emplacement du document de description OpenAPI. |
--api-operation -o |
Non | Sélectionnez une ou plusieurs opérations avec lesquelles Teams peut interagir. |
--bot-host-type-trigger -t |
Non | Spécifie le déclencheur pour Chat Notification Message le modèle d’application. Les options disponibles sont http-express, http-webapiet http-and-timer-functions. La valeur par défaut est http-express. |
atk new Scénarios
Voici une liste de scénarios permettant de contrôler tous les paramètres avec atk new:
Créez un agent météorologique.
atk new -c weather-agent -l typescript -n myagent -i falseCréez un bot de notification déclenché par le minuteur.
atk new -c notification -t timer-functions -l typescript -n myapp -i falseImporter une solution SharePoint Framework existante.
atk new -c tab-spfx -s import --spfx-folder <folder-path> -n myapp -i false
atk add
Ajoutez une fonctionnalité à votre application Microsoft 365.
| Command | Description |
|---|---|
atk add spfx-web-part [options] |
Composant WebPart SPFx auto-hébergé étroitement intégré à Microsoft 365. |
atk add action [options] |
Action pour étendre Copilot à l’aide de vos API. |
atk add auth-config [options] |
Ajoutez des configurations pour prendre en charge les actions avec l’authentification dans l’agent déclaratif. |
atk add capability [options] |
Possibilité d’étendre Copilot à l’aide de vos API. |
atk auth
Gérer les comptes Microsoft 365 et Azure.
| Command | Description |
|---|---|
atk auth list |
Afficher tous les comptes Microsoft 365 et Azure connectés. |
atk auth login |
Connectez-vous à Microsoft 365 ou Azure compte. |
atk auth logout <service> |
Déconnectez-vous du compte Microsoft 365 ou Azure. |
atk entra-app
Gérez l’application Microsoft Entra dans l’application actuelle.
| Command | Description |
|---|---|
atk entra-app update |
Mettez à jour l’application Microsoft Entra dans l’application actuelle. |
atk env
Gérer les environnements d’application.
| Command | Description |
|---|---|
atk env add |
Ajoutez un nouvel environnement en copiant à partir de l’environnement spécifié. |
atk env list |
Répertorie tous les environnements disponibles. |
atk env reset |
Réinitialiser le fichier d’environnement. |
atk env Scénario
Créez un environnement en copiant à partir de l’environnement de développement existant :
atk env add staging --env dev
atk help
La atk help commande affiche toutes les commandes disponibles pour l’interface CLI du Kit de ressources Microsoft 365 Agents.
atk install
Chargez un package d’application donné dans Microsoft 365.
atk install Paramètres
Le tableau suivant répertorie les paramètres disponibles pour atk install:
| Command | Description |
|---|---|
--file-path |
Chemin d’accès au package zip du manifeste de l’application. |
--xml-path |
Chemin d’accès au fichier xml du manifeste XML. |
--scope |
Étendue de l’application. Les options disponibles sont Personnel et Partagé. |
atk install Scénarios
Chargez le package d’application avec un manifeste JSON dans Teams, Outlook et l’application Microsoft 365.
atk install --file-path appPackage.zip
Chargez le package d’application dans Étendue partagée avec manifeste JSON dans Teams, Outlook et l’application Microsoft 365.
atk install --file-path appPackage.zip --scope Shared
Chargez le package d’application de complément Outlook avec un manifeste XML dans Outlook.
atk install --xml-path manifest.xml
atk launchinfo
Obtenez les informations de lancement d’une application Microsoft 365 acquise.
atk launchinfo Paramètres
Le tableau suivant répertorie les paramètres disponibles pour atk launchinfo:
| Command | Description |
|---|---|
--title-id |
Spécifie l’ID de titre de l’application Microsoft 365 acquise. |
--manifest-id |
Spécifie l’ID de manifeste de l’application Microsoft 365 acquise. |
atk launchinfo Scénarios
Obtenez les informations de lancement de l’application Microsoft 365 acquise par ID de titre.
atk launchinfo --title-id U_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Obtenez les informations de lancement de l’application Microsoft 365 acquise par ID de manifeste.
atk launchinfo --manifest-id xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
atk list
Répertorier les exemples et modèles d’application Microsoft 365 disponibles.
atk list Paramètres
Le tableau suivant répertorie les paramètres disponibles pour atk list:
| Command | Description |
|---|---|
atk list samples |
Affiche la liste des exemples d’applications disponibles. |
atk list templates |
Affiche la liste des modèles d’application disponibles. |
atk provision
La atk provision commande exécute la phase d’approvisionnement dans m365agents.yml.
Pour déclencher la phase d’approvisionnement dans m365agents.local.yml, exécutez atk provision --env local.
atk provision Paramètres
Le tableau suivant répertorie les paramètres disponibles pour atk provision:
| Paramètres | Requis | Description |
|---|---|---|
--env |
Non | Spécifie le nom d’environnement du projet généré par microsoft 365 Agents Toolkit. |
--folder -f |
Non | Spécifie le dossier racine du projet. La valeur par défaut est ./. |
--ignore-env-file |
Non | Pour ignorer le chargement du fichier .env lorsque --env n’est pas spécifié. |
atk deploy
La atk deploy commande exécute la phase de déploiement dans m365agents.yml.
Pour déclencher la phase de déploiement dans m365agents.local.yml, exécutez atk deploy --env local.
atk deploy Paramètres
Le tableau suivant répertorie les paramètres disponibles pour atk deploy:
| Paramètre | Obligatoire | Description |
|---|---|---|
--env |
Oui | Spécifie le nom d’environnement du projet généré par microsoft 365 Agents Toolkit. |
--folder -f |
Non | Spécifie le dossier racine du projet. La valeur par défaut est ./. |
--ignore-env-file |
Non | Pour ignorer le chargement du fichier .env lorsque --env n’est pas spécifié. |
--config-file-path -c |
Non | Spécifie le chemin du fichier yaml de configuration. |
atk package
Générez votre application Microsoft 365 dans un package à des fins de publication.
atk package Paramètres
Le tableau suivant répertorie les paramètres disponibles pour atk package:
| Paramètre | Obligatoire | Description |
|---|---|---|
--env |
Non | Spécifie le nom d’environnement du projet généré par microsoft 365 Agents Toolkit. |
--env-file |
Non | Spécifie le fichier .env qui définit les variables à remplacer dans le fichier de modèle de manifeste d’application. |
--manifest-file |
Non | Spécifie le chemin du fichier manifeste de l’application. La valeur par défaut est ./appPackage/manifest.json. |
--output-folder |
Non | Spécifie le dossier de sortie contenant le ou les manifestes. La valeur par défaut est ./appPackage/build. |
--output-package-file |
Non | Spécifie le chemin du fichier de package d’application compressé de sortie. La valeur par défaut est ./appPackage/build/appPackage.${env}.zip. |
--folder -f |
Non | Spécifie le dossier racine du projet. La valeur par défaut est ./. |
atk validate
Validez l’application Microsoft 365 à l’aide du schéma de manifeste, des règles de validation ou des cas de test.
atk validate Paramètres
Le tableau suivant répertorie les paramètres disponibles pour atk validate:
| Paramètre | Obligatoire | Description |
|---|---|---|
--env |
Non | Spécifie le nom d’environnement du projet généré par microsoft 365 Agents Toolkit. |
--env-file |
Non | Spécifie le fichier .env qui définit les variables à remplacer dans le fichier de modèle de manifeste d’application. |
--manifest-file |
Non | Spécifie le chemin du fichier manifeste de l’application. La valeur par défaut est ./appPackage/manifest.json. |
--package-file |
Non | Spécifie le chemin du fichier du package d’application compressé. |
--output-folder |
Non | Spécifie le dossier de sortie contenant le ou les manifestes. La valeur par défaut est ./appPackage/build. |
--output-package-file |
Non | Spécifie le chemin du fichier de package d’application compressé de sortie. La valeur par défaut est ./appPackage/build/appPackage.${env}.zip. |
--folder -f |
Non | Spécifie le dossier racine du projet. La valeur par défaut est ./. |
--validate-method -m |
Non | Spécifie la méthode de validation Valeur autorisée : validation-rules ou test-cases. |
atk publish
La atk publish commande exécute la phase de publication dans m365agents.yml.
atk publish Paramètres
Le tableau suivant répertorie les paramètres disponibles pour atk publish:
| Paramètre | Obligatoire | Description |
|---|---|---|
--env |
Non | Spécifie le nom d’environnement du projet généré par microsoft 365 Agents Toolkit. |
--env-file |
Non | Spécifie le fichier .env qui définit les variables à remplacer dans le fichier de modèle de manifeste d’application. |
--manifest-file |
Non | Spécifie le chemin du fichier manifeste de l’application. La valeur par défaut est ./appPackage/manifest.json. |
--package-file |
Non | Spécifie le chemin du fichier du package d’application compressé. |
--output-folder |
Non | Spécifie le dossier de sortie contenant le ou les manifestes. La valeur par défaut est ./appPackage/build. |
--output-package-file |
Non | Spécifie le chemin du fichier de package d’application compressé de sortie. La valeur par défaut est ./appPackage/build/appPackage.${env}.zip. |
--folder -f |
Non | Spécifie le dossier racine du projet. La valeur par défaut est ./. |
atk preview
La atk preview commande vous permet d’afficher un aperçu de votre application pendant le développement. Cette commande fournit une vue en temps réel de votre application, ce qui vous permet d’identifier et de résoudre les problèmes avant le déploiement.
atk preview Paramètres
Le tableau suivant répertorie les paramètres disponibles pour atk preview:
| Paramètre | Obligatoire | Description |
|---|---|---|
--m365-host -m |
Non | Affichez un aperçu de l’application dans Teams, Outlook ou l’application Microsoft 365. Les options disponibles sont teams, outlooket office. La valeur par défaut est teams. |
--manifest-file |
Non | Spécifie le chemin du fichier manifeste de l’application. La valeur par défaut est ./appPackage/manifest.json. |
--run-command -c |
Non | La commande démarre le service et fonctionne uniquement dans un environnement local. S’il n’est pas défini, il détecte automatiquement la commande appropriée à partir du type de projet (npm run dev:atk, dotnet runou func start). S’il est vide, il ignore le démarrage du service local. |
--running-pattern -p |
Non | Sortie du signal prêt pour le lancement du service. Fonctionne uniquement pour local l’environnement. Si elle n’est pas définie, la commande La valeur par défaut est (démarré|réussi|terminé|bloqué|échec|écoute|prêt). S’il est vide, le processus démarre en tant que signal prêt. |
--open-only -o |
Non | Fonctionne uniquement pour local l’environnement. Si la valeur est true, ouvrez directement le client web sans lancer le service local. La valeur par défaut est false. |
--browser -b |
Non | Sélectionnez navigateur pour ouvrir le client web Microsoft Teams. Les options disponibles sont chrome, edgeet default. La valeur par défaut est default. |
--browser-arg -ba |
Non | Argument à passer au navigateur. Par exemple : --browser-args="--guest. |
--exec-path -ep |
Non | Chemins d’accès ajoutés à la variable d’environnement système « PATH » lors de l’exécution de la commande. La valeur par défaut est devTools/func. |
--desktop -d |
Non | Si la valeur est true, ouvrez le client de bureau Teams au lieu du client web. La valeur par défaut est false. |
--env |
Non | Spécifie un environnement existant pour le projet. La valeur par défaut est local. |
--folder -f |
Non | Spécifie le dossier racine du projet. La valeur par défaut est ./. |
atk preview Scénarios
La atk preview commande doit être utilisée après atk provision et atk deploy.
La liste suivante fournit les scénarios courants pour atk preview:
Préversion locale : voici les dépendances pour utiliser la préversion locale :
- Node.js
- Kit de développement logiciel .NET
- Azure Functions Core Tools
atk preview --env --local atk preview --env --local --browser chromePréversion à distance
atk preview --env --remote atk preview --env --remote --browser edgeRemarque
Les journaux des services d’arrière-plan, tels que React, sont enregistrés au format
~/.fx/cli-log/local-preview/.
atk update
Mettez à jour le manifeste de l’application vers le Portail des développeurs.
atk update Paramètres
Le tableau suivant répertorie les paramètres disponibles pour atk update:
| Paramètre | Obligatoire | Description |
|---|---|---|
--env |
Non | Spécifie le nom d’environnement du projet généré par microsoft 365 Agents Toolkit. |
--env-file |
Non | Spécifie le fichier .env qui définit les variables à remplacer dans le fichier de modèle de manifeste d’application. |
--manifest-file |
Non | Spécifie le chemin du fichier manifeste de l’application. La valeur par défaut est ./appPackage/manifest.json. |
--package-file |
Non | Spécifie le chemin du fichier du package d’application compressé. |
--output-folder |
Non | Spécifie le dossier de sortie contenant le ou les manifestes. La valeur par défaut est ./appPackage/build. |
--output-package-file |
Non | Spécifie le chemin du fichier de package d’application compressé de sortie. La valeur par défaut est ./appPackage/build/appPackage.${env}.zip. |
--folder -f |
Non | Spécifie le dossier racine du projet. La valeur par défaut est ./. |
atk upgrade
Mettez à niveau le projet pour qu’il fonctionne avec la dernière version de Microsoft 365 Agents Toolkit.
atk upgrade Paramètres
Le tableau suivant répertorie les paramètres disponibles pour atk upgrade:
| Paramètre | Obligatoire | Description |
|---|---|---|
--force -f |
Non | Forcez la mise à niveau du projet pour qu’il fonctionne avec la dernière version de Microsoft 365 Agents Toolkit. La valeur par défaut est false. |
atk collaborator
Vérifiez, accordez et répertoriez les autorisations permettant d’accéder à l’application et de Microsoft Entra application et de la gérer.
| Command | Description |
|---|---|
atk collaborator status |
Affiche la status d’autorisation actuelle du projet. |
atk collaborator grant |
Accordez l’autorisation pour un autre compte. |
atk collaborator status Paramètres
Le tableau suivant répertorie les paramètres disponibles pour atk collaborator status:
| Paramètre | Obligatoire | Description |
|---|---|---|
--env |
Non | Spécifie le nom d’environnement du projet généré par microsoft 365 Agents Toolkit. |
--manifest-file |
Non | Spécifie le chemin du fichier manifeste de l’application. La valeur par défaut est ./appPackage/manifest.json. |
--entra-app-manifest-file -a |
Non | Sélectionnez le chemin du fichier de modèle de manifeste Entra. La valeur par défaut est ${folder}/aad.manifest.json. |
--all -a |
Non | Afficher tous les collaborateurs. |
--folder -f |
Non | Sélectionnez le dossier racine du projet. La valeur par défaut est ./. |
atk collaborator grant Paramètres
Le tableau suivant répertorie les paramètres disponibles pour atk collaborator grant:
| Paramètre | Obligatoire | Description |
|---|---|---|
--email |
Non | Entrez l’adresse e-mail du collaborateur. |
--manifest-file |
Non | Spécifie le chemin du fichier manifeste de l’application. La valeur par défaut est ./appPackage/manifest.json. |
--entra-app-manifest-file -a |
Non | Sélectionnez le chemin du fichier manifeste de l’application Entra. La valeur par défaut est ${folder}/aad.manifest.json. |
--env |
Non | Spécifie le nom d’environnement du projet généré par microsoft 365 Agents Toolkit. |
--folder -f |
Non | Sélectionnez le dossier racine du projet. La valeur par défaut est ./. |
atk collaborator Scénarios
Accordez l’autorisation à un autre compte Microsoft 365 de collaborer sur l’application.
atk collaborator grant -i false --manifest-file ./appPackage/manifest.json --env dev --email other@email.com
atk uninstall
Nettoyez les ressources associées à l’ID de manifeste, à l’ID de titre ou à un environnement dans le projet généré par microsoft 365 Agents Toolkit. Les ressources incluent l’inscription d’applications dans le portail des développeurs, l’inscription de bot dans le portail Bot Framework et les applications personnalisées chargées dans les applications Microsoft 365.
atk uninstall Paramètres
Le tableau suivant répertorie les paramètres disponibles pour atk uninstall:
| Command | Description |
|---|---|
--mode |
Choisissez un moyen de propre ressources. |
--title-id |
Spécifie l’ID de titre de l’application Microsoft 365 installée. |
--manifest-id |
Spécifie l’ID de manifeste de l’application Microsoft 365 installée. |
atk uninstall Scénarios
Supprimez l’application Microsoft 365 acquise à l’aide de l’ID de titre.
atk uninstall -i false --mode title-id --title-id U_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Supprimez l’application Microsoft 365 acquise à l’aide de l’ID de manifeste.
atk uninstall -i false --mode manifest-id --manifest-id xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --options 'm365-app,app-registration,bot-framework-registration'
Supprimez l’application Microsoft 365 acquise à l’aide de l’environnement dans le projet généré par microsoft 365 Agents Toolkit.
atk uninstall -i false --mode env --env xxx --options 'm365-app,app-registration,bot-framework-registration' --folder ./myapp
Désinstallez en mode interactif.
atk uninstall