Partager via


Interface de ligne de commande du Kit de ressources Microsoft 365 Agents

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

Capture d’écran montrant l’installation du package npm.

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.

Capture d’écran montrant la liste des commandes disponibles.

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.

Capture d’écran montrant la liste des options globales.

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.

Capture d’écran montrant les nouveaux paramètres atk.

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 false
    
  • Créez un bot de notification déclenché par le minuteur.

    atk new -c notification -t timer-functions -l typescript -n myapp -i false
    
  • Importer 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.

Capture d’écran montrant la liste des modèles.

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 chrome
    
  • Préversion à distance

    atk preview --env --remote
    atk preview --env --remote --browser edge
    

    Remarque

    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