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 la CLI manuellement.Agent 365 Compétences vérifie la CLI, installe-la ou mets-la à jour automatiquement, et exécute toutes les commandes nécessaires pour toi. Cet article est une référence pour les développeurs qui doivent installer ou utiliser directement la CLI – par exemple, lors de la création d’automatisation CI/CD, du dépannage d’une étape spécifique, ou du travail 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 tous les autres prérequis - abonnement Azure, rôles Entra obligatoires et enregistrement personnalisé de l’application client - voir Démarrage rapide : Connecter un agent existant à l’Agent 365.

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.

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

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.

Uninstall

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
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.

Tip

Vous n’avez pas besoin d’exécuter manuellement des commandes CLI. Les compétences Agent 365 automatisent l’ensemble du flux de travail - installation, configuration de CLI, mise en place, déploiement et publication de blueprint - à 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.

Troubleshooting

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

Tip

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

  • Last updated on