Informations de référence sur la commande CLI deploy agent 365

Déployer des fichiers binaires d’application Agent 365 sur les Azure App Service configurés et mettre à jour les autorisations de l’outil Agent 365 La commande deploy fournit des options pour créer des déploiements Agent 365. Utilisez cette commande pour déployer des fichiers binaires d’application sur votre infrastructure Azure et accorder des autorisations d’outils Agent 365.

rôle Minimum requis : Azure Contributeur + Administrateur global

Pour plus d’informations sur l’utilisation de cette commande, consultez Deploy agent sur Azure.

Syntaxe

a365 deploy [command] [options]

Options

Remarques

L’exécution a365 deploy sans sous-commande exécute un déploiement en deux phases :

• Phase 1 — Fichiers binaires d’application : génère et déploie votre application sur Azure App Service.
• Phase 2 : autorisations MCP : lit les étendues requises à partir et toolingManifest.json met à jour le blueprint de l’agent avec les autorisations nécessaires.

Les deux phases s’exécutent même avec --dry-run. La sortie à sec est divisée en deux sections étiquetées pour vous permettre de passer en revue ce que chaque phase ferait.

Vérifications préliminaires

Avant de déployer, l’interface CLI valide :

• Azure l’authentification et l’abonnement : votre session et abonnement Azure CLI doivent être valides. Si ce n’est pas le cas, le déploiement s’arrête avec une erreur. Corriger avec az login --tenant <TENANT_ID> et az account set --subscription <SUBSCRIPTION_ID>.
• Azure App Service existence : l’application web cible doit exister avant le déploiement. Si l’application est introuvable, exécutez ou corrigez a365 setupwebAppName et resourceGroup dans a365.config.json.

Paramétrage

L’interface CLI lit à partir de deux fichiers de configuration :

• a365.config.json — configuration de votre projet (gérée par l’utilisateur).
• a365.generated.config.json — état dynamique généré par les commandes d’installation.

Les étendues de l’outil MCP sont lues dans le répertoire de toolingManifest.json votre projet de déploiement.

L’interface CLI stocke également une copie globale de la configuration et de l’état à l’adresse suivante :

• Windows : %LocalAppData%\Microsoft.Agents.A365.DevTools.Cli
• Linux/macOS : ~/.config/a365

Comportement de l’indicateur

--restart: ignore l’étape de génération et commence directement à compresser le dossier existant publish/ . S’il publish/ n’existe pas, le déploiement échoue. Exécutez d’abord un déploiement complet (sans --restart) pour produire le publish/ dossier.

--inspect: s’interrompt avant l’étape de chargement pour vous permettre d’inspecter le publish/ dossier et le fichier ZIP généré. Disponible uniquement pour la phase d’application.

--dry-run: imprime tout ce qui se passerait sans apporter de modifications. Lors de l’exécution a365 deploy (en deux phases), la sortie est divisée en :

• Partie 1 : Déployer des fichiers binaires d’application
• Partie 2 : Déployer/mettre à jour les autorisations de l’outil Agent 365

deploy app

Déploie votre code d’agent sur l’application web Azure créée lors de l’installation.

a365 deploy app [options]

Déployez des fichiers binaires d’application Microsoft Agent 365 sur le Azure App Service configuré. Cette commande déploie les fichiers binaires d’application sur votre service d’application configuré Azure dans Azure.

Options app

deploy mcp

Met à jour les autorisations du serveur MCP sur votre blueprint d’agent.

a365 deploy mcp [options]

Options mcp

Notes d’utilisation

Mettez à jour les étendues et autorisations des serveurs MCP sur le blueprint d’agent existant. Cette commande ajoute des autorisations pour les outils Agent 365 au blueprint de l’agent.

Si vous ajoutez ou modifiez des serveurs MCP dans votre code d’agent, utilisez cette commande pour mettre à jour les autorisations sur votre blueprint d’agent.

Cette commande :

• Lit la configuration de votre serveur MCP à partir de votre code.
• Met à jour le blueprint de l’agent avec les autorisations requises.
• Accorde les autorisations d’API nécessaires pour les serveurs MCP.

La mise à jour d’autorisation s’applique dans l’ordre suivant :

1. Octroi d’autorisations OAuth2 (principal de service blueprint → plateforme MCP)
2. Autorisations héritantes (blueprint de l’agent → ressource MCP)
3. Consentement administrateur (identité de l’agent → plateforme MCP)

Quand utiliser deploy mcp:

• Après avoir ajouté de nouveaux serveurs MCP à votre agent.
• Après avoir modifié les configurations du serveur MCP.
• Lorsque les outils MCP ne sont pas accessibles à votre agent.

Vous n’avez pas besoin d’exécuter deploy mcp:

• Lors du déploiement initial. Cette opération est gérée automatiquement pendant l’installation.
• Lorsque vous modifiez uniquement la logique de l’agent sans modification de MCP.
• Après les mises à jour de code de routine qui n’affectent pas les outils.

Résolution des problèmes

Utilisez les sections suivantes pour résoudre les problèmes potentiels liés à la deploy commande.

• Not connecté à Azure ou un abonnement incorrect
• Application web introuvable
• Échec de la mise à jour des autorisations
• --restart Échoue

Pas connecté à Azure ou un abonnement incorrect

Exécutez az login --tenant <TENANT_ID> et az account set --subscription <SUBSCRIPTION_ID>.

Application web introuvable

Vérifiez que l’exécution a été effectuée ou vérifiez a365 setup qu’elles webAppNameresourceGroup sont correctes dans a365.config.json.

Échec de la mise à jour des autorisations

• Vérifiez AgentBlueprintId, AgenticAppIdet l’environnement sont définis dans a365.config.json.
• Vérifiez que votre compte dispose des droits nécessaires pour gérer les principaux de service et les subventions.
• Vérifiez qu’il toolingManifest.json existe dans votre répertoire de projet de déploiement et contient des étendues valides.

--restart Échoue

Exécutez un déploiement complet sans --restart générer le publish/ dossier, puis utilisez-le --restart pour les itérations suivantes.

Journaux

Les fichiers journaux CLI sont stockés à l’adresse suivante :

• Windows : %LocalAppData%\Microsoft.Agents.A365.DevTools.Cli\logs\
• Linux/macOS : ~/.config/a365/logs/

Pour afficher les 80 dernières lignes du dernier fichier journal de déploiement, utilisez Get-Content sur Windows ou tail sur Linux/macOS :

# Windows
Get-Content $env:LOCALAPPDATA\Microsoft.Agents.A365.DevTools.Cli\logs\a365.deploy.log -Tail 80

# Linux/macOS
tail -80 ~/.config/a365/logs/a365.deploy.log

Pour les journaux d’application runtime, utilisez Log Stream dans le portail Azure pour stdout/stderr à partir de votre App Service.