Installez et utilisez la ligne de commande Agent 365

La CLI Agent 365 est un outil en ligne de commande multiplateforme pour déployer et gérer des applications Agent 365 sur Azure. Cette référence explique comment installer, mettre à jour, désinstaller et utiliser la CLI pour l’automatisation et le dépannage.

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. Cet article est la référence de la CLI : installation, mise à jour, désinstallation, commandes disponibles et dépannage.

Prerequisites

L’interface CLI nécessite .NET 8.0 ou version ultérieure. Pour toutes les autres prérequis, y compris un abonnement Azure et les rôles Entra obligatoires, voir Démarrage rapide : Connecter un agent existant à l’Agent 365.

Authentification par Microsoft Entra

Par défaut, la configuration de l'Agent 365 utilise l'application d'entreprise Agent 365 CLI gérée par Microsoft lorsqu'elle est disponible dans votre locataire.

Propriété Value
Nom d'affichage Agent 365 CLI
ID de l’application (client) f54280f4-395e-4ea8-9e48-bf2d4952aa14

Pour vérifier l’application, rendez-vous dans le centre d’administration centre d’administration Microsoft Entra, sélectionnez Applications> EnterpriseToutes les applications, et recherchez l’identifiant de l’application. L’identifiant d’objet du principal de service est propre à votre locataire. N’utilisez pas l’ID d’objet lorsque la CLI ou la documentation demande un ID d’application (client).

L’interface CLI vérifie la présence du principal du service de l’application d’entreprise dans votre locataire et valide les étendues déléguées requises dans le jeton d’accès. Il ne crée ni ne modifie l'enregistrement des applications Microsoft. L'application gérée par Microsoft ne met pas en valeur l'utilisateur connecté, ne contourne pas les paramètres d'accès conditionnel ou de sécurité, ni ne supprime les exigences de consentement séparées pour les ressources de l'agent.

Si l'application d'entreprise gérée par Microsoft n'est pas disponible, la configuration sans fichier de configuration recherche une application appartenant au locataire appelée Agent 365 CLI. Les configurations existantes qui spécifient un clientAppId personnalisé restent prises en charge. Pour les instructions, voir Enregistrement personnalisé de l’application client pour l’Agent 365 CLI.

L’application gérée par Microsoft utilise ces méthodes d’authentification interactives :

Environnement Méthode d’authentification
Windows natifs Gestionnaire de comptes web (WAM)
Sous-système Windows pour Linux (WSL), macOS et Linux Code d’appareil

Les applications personnalisées détenues par un locataire utilisent le navigateur système lorsque le WAM n’est pas disponible.

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.

Mettre à jour la ligne de commande de l’Agent 365

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 l’Agent 365 CLI

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 CLI de l’agent 365

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

Système d’exploitation Path
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 CLI de l’Agent 365

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'application CLI Agent 365 gérée par Microsoft n'est pas disponible

Mettez à jour le CLI et relancez a365 setup requirements. Pour vérifier si le déploiement progressif a été appliqué à votre locataire, recherchez Applications d’entreprise dans Microsoft Entra pour l’ID d’application f54280f4-395e-4ea8-9e48-bf2d4952aa14.

Si le principal de service n’est pas présent, la configuration revient à une application détenue par le locataire nommée Agent 365 CLI. Si vous n’avez pas déjà cette application, suivez l’enregistrement de l’application client personnalisée pour la CLI Agent 365.

L’authentification par code de l’appareil est bloquée

L’application gérée par Microsoft utilise l’authentification par code de périphérique sur WSL, macOS et Linux. Les défauts de sécurité ou une politique d’accès conditionnel peuvent bloquer ce flux et renvoyer AADSTS530035.

Ne désactivez pas la politique de sécurité de votre organisation pour contourner cette erreur. Exécutez la CLI sur Windows natif pour utiliser le WAM, ou travaillez avec votre administrateur d’identité pour utiliser une application personnalisée détenue par le locataire et un flux d’authentification que votre politique permet.

L’authentification échoue avec AADSTS70007

Les anciennes versions de l’interface CLI peuvent utiliser un mode de réponse du navigateur non pris en charge avec l’application gérée par Microsoft et renvoyer AADSTS70007. Mise à jour vers la dernière version de la CLI et réessaie :

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

Les autorisations déléguées requises sont absentes

La CLI valide les permissions déléguées effectives de l'application gérée par Microsoft issues de la revendication du scp jeton d'accès. Mettez à jour le CLI et relancez a365 setup requirements.

N'ajoutez pas d'URI de redirection, de revendications optionnelles, de permissions API ou d'accords de permissions locales locataires à l'application gérée par Microsoft. Si la validation signale toujours des périmètres manquants, capturez les identifiants de trace et corrélation de l’erreur et contactez le support Microsoft. Si vous utilisez une application détenue par un locataire, suivez les étapes de validation dans l’enregistrement personnalisé de l’application client pour l’Agent 365 CLI.

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