Interface CLI de l’agent 365

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

Vous n’avez pas besoin d’installer l’interface CLI manuellement. L’installation guidée par l’IA vérifie l’interface CLI, l’installe ou la met à jour automatiquement et exécute toutes les commandes requises en votre nom. Cette page est une référence pour les développeurs qui ont besoin d’installer ou d’utiliser directement l’interface CLI, par exemple lors de la génération d’automatisation CI/CD, de la résolution des problèmes d’une étape spécifique ou de l’utilisation sans agent de codage IA.

Note

Le flux de travail complet du développeur, y compris la configuration guidée par l'IA, les instructions de rôle et les étapes de post-déploiement, est détaillé dans Démarrage avec le développement Agent 365. Cette page est la référence CLI : installation, mise à jour, désinstallation, commandes disponibles et résolution des problèmes.

Prerequisites

L’interface CLI nécessite .NET 8.0 ou version ultérieure. Pour toutes les autres conditions préalables - abonnement Azure, rôles Entra requis et inscription d'application cliente personnalisée - consultez Configuration guidée par IA.

Installer l’Agent 365 CLI

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

Prerequisites

Vous devez avoir .NET installé. (.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é la CLI de l’Agent 365, vérifiez qu’elle est correctement installée en exécutant la --help commande :

a365 -h

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

Mise à jour

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

Note

Pour mettre à jour la CLI de l’Agent 365, il vous faut 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 des fichiers

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. Vous pouvez donc invoquer des outils globaux depuis 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 l’installe.

Commandes disponibles

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

Conseil / Astuce

Vous n’avez pas besoin d’exécuter manuellement des commandes CLI. L’installation guidée par l’IA automatise le flux de travail complet ( installation, configuration, configuration, déploiement et publication de blueprints) à l’aide d’un agent de codage IA. Utilisez la référence CLI ici si vous créez une automatisation CI/CD, résolvez une étape spécifique ou travaillez sans agent de codage IA.

Pour obtenir des instructions complètes sur la configuration d’un agent 365 à l’aide de l’interface CLI, consultez Prise en main du développement Agent 365.

Dépannage

Cette section fournit des informations sur la manière de dépanner les erreurs avec l’interface CLI de l’Agent 365.

Conseil / Astuce

Le Guide de dépannage de l’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 à l'interface en ligne de commande abordés dans cette section :

L’agent n’apparaît pas dans Teams

Dépannage des instances de création d’agents : L’agent n’apparaît pas dans Teams

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

Dépannage de création d’instances d’agent : impossible de créer une instance d’agent dans Teams