CLI Agent 365

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 vous disposez des éléments suivants :

• 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

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

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

Si vous recevez une microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json erreur, utilisez ce --prerelease paramètre car ce paquet peut toujours être marqué comme pré-release.

dotnet tool install --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

Vérifier l’installation

Après avoir installé l’interface CLI Agent 365, vérifiez qu’elle est correctement installée en exécutant :

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

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 :

Cet emplacement est ajouté au chemin d’accès de l’utilisateur lors de la première exécution du SDK. Ainsi, les outils globaux peuvent être invoqués à partir de 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 a installé l’outil.

Commandes disponibles

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

Mises à jour importantes

Commande supprimée : La create-instance commande a été retirée de la CLI. Il contournait les étapes d’enregistrement requises, ce qui limitait la fonctionnalité de l’agent. Cette commande pourra être réintroduite dans une version ultérieure une fois qu’elle sera conforme au flux de travail recommandé.

Utilisez ce flux de travail à la place :

1. a365 publish - Agent de publication vers le centre d’administration Microsoft 365
2. Configurer le plan d’agent dans le portail développeur - Voir Configurer le plan d’agent dans le portail développeur
3. a365 deploy - Déploiement sur Azure (optionnel, uniquement si l’hébergement Azure)
4. Créer une instance d’agent via Microsoft Teams

Voir les agents à bord pour des instructions complètes.

Résolution des problèmes

Cette section contient des informations sur la résolution des erreurs avec l’interface CLI Agent 365.

• L’installation, la mise à jour ou la désinstallation de la CLI échoue avec Not found in NuGet feeds
• create-instance commande non trouvée
• Agent n’apparaissant pas dans Teams
• Impossible de créer une instance d’agent dans Teams

L’installation, la mise à jour ou la désinstallation de la CLI échoue avec Not found in NuGet feeds

Si vous recevez une microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json erreur, utilisez ce --prerelease paramètre car ce paquet peut toujours être marqué comme pré-release.

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:

Error: Command 'create-instance' not found

Cause: La create-instance commande a été retirée de la CLI. Il contournait les étapes d’enregistrement requises, ce qui limitait la fonctionnalité de l’agent. Cette commande pourra être réintroduite dans une version ultérieure une fois qu’elle sera conforme au flux de travail recommandé.

Solution:

Utilisez le flux de travail mis à jour :

1. Publiez votre agent :

   a365 publish
   

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

   Consultez Configurer le blueprint de l’agent dans le portail développeur pour des instructions détaillées.

3. Déployer sur Azure (optionnel) :

   # Only if hosting on Azure Web App
   a365 deploy
   

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

   • Open Microsoft Teams
   • Naviguer vers les applications
   • Cherchez votre agent
   • Cliquez sur « Ajouter » pour créer une instance d’agent

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

Agent qui n’apparaît pas dans les équipes

Symptôme: Après avoir exécuté les commandes, l’agent n’apparaît pas dans Microsoft Teams.

Cause: Vous avez peut-être sauté l’étape publish ou tenté d’utiliser la commande supprimée create-instance .

Solution:

1. Vérifiez que vous avez bien fonctionné a365 publish
2. Patientez 5 à 10 minutes pour la propagation
3. Consultez le Centre d’administration Microsoft 365 : https://admin.cloud.microsoft/#/agents/all
4. Créez une instance d’agent via la section Apps Teams

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

Symptôme: L’agent apparaît dans Teams mais vous ne pouvez pas créer une instance d’agent (impossible d’ajouter l’agent).

Cause: La licence « Microsoft Agent 365 Frontier » n’est pas attribuée à votre compte utilisateur.