Interface CLI de l’agent 365

Important

Vous devez faire partie du programme de préversion Frontier pour obtenir un accès anticipé à Microsoft Agent 365. Frontier vous connecte directement avec les dernières innovations ia de Microsoft. Les versions préliminaires Frontier sont soumises aux conditions existantes de vos contrats clients qui régissent les versions préliminaires. Comme ces fonctionnalités sont encore en cours de développement, leur disponibilité et leurs capacités peuvent évoluer au fil du temps.

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.

Prérequis

Avant de commencer, vérifiez que les conditions préalables suivantes sont remplies :

Note

Pendant l’étape a365 config init (après l’installation), la CLI valide automatiquement l’enregistrement de votre application client personnalisée en vérifiant que l’application existe, dispose des autorisations requises et a reçu le consentement administrateur.

Conseil / Astuce

Différentes commandes CLI nécessitent des rôles ou des autorisations différents. Chaque page de référence de commande spécifie le rôle minimum requis. Par exemple, consultez la setup référence de commande pour ses besoins spécifiques.

Installer l’Agent 365 CLI

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

Prérequis

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

Utiliser l’installation de l’outil dotnet

Installez la CLI Agent 365 en utilisant la commande suivante avec le --prerelease paramètre :

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

Important

La CLI Agent 365 est encore en version préliminaire. Jusqu’à ce que la CLI Agent 365 devienne généralement disponible, utilisez toujours ce --prerelease paramètre pour obtenir la dernière version avec les corrections et fonctionnalités les plus récentes. Lorsque la CLI de l’Agent 365 devient généralement disponible, le --prerelease paramètre ne sera plus nécessaire.

Pour obtenir les dernières instructions et les versions disponibles, visitez 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 de l’Agent 365 en utilisant la commande de mise à jour de l’outil dotnet avec le --prerelease paramètre :

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

Note

Pour mettre à jour l’interface CLI Agent 365, vous avez besoin d’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. 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.

Mises à jour importantes

Commande réactivée : La create-instance commande a été réactivée. Il crée une identité d’agent, un utilisateur d’agent et affecte les licences requises dans une seule opération. Consultez a365 create-instance pour les détails complets.

Note

Versions antérieures supprimées create-instance. Si vous avez déjà suivi les étapes de solution de contournement pour créer manuellement des instances d’agent, vous pouvez désormais utiliser a365 create-instance directement.

Pour des instructions complètes sur la configuration d’un agent Agent 365 en utilisant la ligne de commande, voir Cycle de vie de développement de l’Agent 365.

Résolution des problèmes

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 :

Not found in NuGet feeds erreur lors de l’installation, mise à jour ou désinstallation

Symptôme:microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json erreur lors de l’installation, de la mise à jour ou de la désinstallation de l’interface de l’Agent 365.

Solution : Utilise le --prerelease paramètre.

Toutes les versions actuelles de la CLI sont des versions pré-release.

# For installation
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease

# For updates
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli --prerelease

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

L’agent 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’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