CLI Agent 365

Agent 365 CLI est un outil en ligne de commande multiplateformes permettant de déployer et de gérer des applications Agent 365 sur Azure.

Vous n’avez pas besoin d’installer manuellement la CLI. La configuration guidée par l’IA vérifie la présence du CLI, l’installe ou le met à jour automatiquement, et exécute toutes les commandes requises en votre nom. Cette page sert de référence aux développeurs qui doivent installer ou utiliser directement la CLI — par exemple, lors de la création d’une automatisation CI/CD, du dépannage d’une étape spécifique ou du travail sans assistant IA de codage.

Remarque

L’ensemble du flux de travail développeur – y compris la configuration guidée par l’IA, l’assistance sur les rôles et les étapes après le déploiement – est disponible dans Commencer avec le développement Agent 365. Cette page est la référence de la CLI : installation, mise à jour, désinstallation, commandes disponibles et dépannage.

Configuration requise

La CLI nécessite .NET 8.0 ou une version ultérieure. Pour tous les autres prérequis – abonnement Azure, rôles Entra requis et enregistrement personnalisé d’application cliente – voir Configuration guidée par l’IA.

Installer l’interface CLI Agent 365

Procédez comme suit pour installer l’interface CLI Agent 365 globalement sur votre système d’exploitation.

Configuration requise

Vous devez avoir installé .NET. (.NET 8.0 est recommandé.)

Utiliser l’installation de l’outil dotnet

Installez l’interface CLI Agent 365 à l’aide de la commande suivante :

dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli

Pour obtenir les dernières instructions et les versions disponibles, consultez la page NuGet officielle : Microsoft.Agents.A365.DevTools.Cli sur NuGet.org

Vérifier l’installation

Après avoir installé l’interface CLI Agent 365, vérifiez qu’elle est correctement installée en exécutant la commande --help :

a365 -h

Cette commande affiche les informations d’aide et confirme que l’interface CLI est prête à être utilisée.

Update

Mettez à jour la CLI Agent 365 à l’aide de la commande de mise à jour de l’outil dotnet :

dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli

Remarque

Toutes les mises à jour de la CLI Agent 365 nécessitent une connexion Internet pour accéder au dernier package NuGet : Microsoft.Agents.A365.DevTools.Cli.

Désinstaller

Désinstallez la CLI Agent 365 à l’aide de la commande de désinstallation de l’outil dotnet :

dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli

Emplacements de fichier

L’emplacement par défaut du fichier exécutable d’un outil dépend du système d’exploitation :

Système d’exploitation Chemin d’accès
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Le SDK ajoute cet emplacement à votre chemin lors de la première utilisation. Ainsi, les outils globaux peuvent être invoqués à partir de n’importe quel répertoire sans spécifier l’emplacement de l’outil.

L’accès aux outils est spécifique à l’utilisateur et non global à la machine. Un outil global n’est disponible que pour l’utilisateur qui a installé l’outil.

Commandes disponibles

Pour obtenir la liste complète des commandes disponibles, utilisez la commande --help ou consultez la référence de la CLI Agent 365.

Astuce

Vous n‘avez pas besoin d’exécuter les commandes CLI manuellement. La configuration guidée par IA automatise l’ensemble du flux de travail : installation du CLI, configuration, mise en place du blueprint, déploiement et publication – à l’aide d’un assistant IA de codage. Utilisez la référence CLI ici pour développer une automatisation CI/CD, dépanner une étape spécifique ou travailler sans assistant de codage IA.

Pour des instructions complètes sur la configuration d’un assistant Agent 365 en utilisant la ligne de CLI, voir Commencer avec le développement d’Agent 365.

Résolution des problèmes

Cette section contient des informations sur la résolution des erreurs avec l’interface CLI Agent 365.

Astuce

Le Guide de dépannage Agent 365 contient des recommandations générales de dépannage, les meilleures pratiques et des liens vers du contenu de dépannage pour chaque étape du cycle de développement de l’Agent 365.

Problèmes spécifiques à la CLI abordés dans cette section :

L’assistant n’apparaît pas dans Teams

Dépannage des instances de création d’assistant : l’assistant ne s’affiche pas dans Teams

Impossible de créer une instance d’assistant dans Teams

Résolution des problèmes liés aux instances de création d’assistant : impossible de créer une instance d’assistant dans Teams