CLI Agent 365

Important

Vous devez faire partie du programme Frontier en version préliminaire pour obtenir un accès anticipé à Microsoft Agent 365. Frontier vous connecte directement aux dernières innovations d’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 multiplateformes permettant de déployer et de gérer des applications Agent 365 sur Azure.

Configuration requise

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

• Enregistrement personnalisé de l’application client - La CLI nécessite une application client personnalisée dans votre locataire Microsoft Entra ID pour l’authentification. Consultez l’enregistrement personnalisé de l’application client pour des instructions de configuration détaillées. Vous avez besoin de l’ID de l’application (client) lors de la configuration.
• Abonnement Azure - Accès à un abonnement Azure où vous pouvez créer des ressources.
• Autorisations requises - Votre compte doit avoir l’un des rôles suivants :
  • Administrateur général
  • Administrateur d’ID d’agent
  • Développeur Agent ID

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, voir la référence desetup commande pour ses exigences spécifiques.

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

Windows

Installer .NET sur Windows

Linux

Installer .NET sur Linux

macOS

Installer .NET sur macOS

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

Le CLI de l’Agent 365 est encore en aperçu. 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, 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 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 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 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 supprimée : Le CLI a supprimé la create-instance commande. Il contournait les étapes d’enregistrement requises, ce qui limitait la fonctionnalité de l’agent. Cette commande pourrait être réintroduite dans une version ultérieure une fois qu’elle sera conforme au flux de travail recommandé.

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.

Questions spécifiques à l’interface de l’interface éclair abordées dans cette section :

• Not found in NuGet feeds erreur lors de l’installation, mise à jour ou désinstallation
• create-instance commande non trouvée
• L’agent n’apparaît pas dans Teams
• Impossible de créer une instance d’agent dans Teams

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, consultez la page NuGet officielle : Microsoft.Agents.A365.DevTools.Cli sur NuGet.org

create-instance commande introuvable

Symptôme: Vous voyez l’erreur Command 'create-instance' not found .

Cause : Le CLI a supprimé la create-instance commande. Il contournait les étapes d’enregistrement requises, ce qui limitait la fonctionnalité de l’agent. L’équipe de développement pourrait réintroduire cette commande dans une version ultérieure une fois qu’elle sera conforme au flux de travail recommandé.

Solution : Utilisez plutôt les étapes suivantes :

1. Publiez votre agent : Utilisez la commande publish a365.

   a365 publish
   

2. Configurez le plan de l’agent dans le portail développeur :

   Apprenez à configurer un blueprint d’agent dans le portail développeur Teams.

3. Déployer sur Azure (optionnel) : Utilisez la commande de déploiement a365.

   # Only if hosting on Azure Web App
   a365 deploy
   

4. Créer une instance d’agent via Microsoft Teams :

   1. Ouvrez Microsoft Teams.
   2. Accédez à Applications.
   3. Cherchez votre agent.
   4. Sélectionnez Ajouter pour créer une instance d’agent.

Pour des instructions détaillées, voir Agents embarqués.

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