Deploy agent to Azure

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.

Vous avez créé votre assistant et l’avez testé localement : il est maintenant temps de le déployer dans le cloud. Cette étape est optionnelle et peut être ignorée si vous avez déjà déployé votre agent dans un cloud (il n’est même pas nécessaire d’être Azure).

Ce guide vous explique comment déployer le code de votre assistant sur Azure et le publier dans le Centre d’administration Microsoft, où il devient une ressource détectable par votre organisation.

Il existe aussi des ressources pour montrer comment mettre à jour le point de terminaison de messagerie si, au lieu d’Azure, vous avez déjà déployé votre agent auprès d’autres fournisseurs cloud comme AWS ou GCP :

• Utilisez le code agent déployé dans AWS
• Utiliser le code agent déployé dans GCP

Prerequisites

Avant de commencer, vérifiez que vous disposez des éléments suivants :

Comptes et autorisations requis

• Abonnement Azure avec accès contributeur.
• Un code d’agent fonctionnel avec un point de messagerie valide et accessible. Veuillez vous assurer d’avoir testé cela localement et vérifier que le code de l’agent peut être construit et exécuté.
• Complétez l’étape de configuration du plan d’agent pour avoir un plan d’agent valide.
• Assurez-vous que les fichiers a365.config.jsonde configuration et a365.generated.config.json le fichier de configuration dans le code (par exemple le fichier .env) sont à jour.

Outils requis

• Azure CLI installée et authentifiée (Installer Azure CLI)
• CLI A365 installée (Agent 365 CLI)

Déployer sur Azure

La a365 deploy commande déploie votre agent dans l’application Web Azure créée lors de la configuration. Cela télécharge votre code d’agent sur Azure, le rendant disponible pour l’exécution dans le cloud et la gestion de toutes requêtes agentiques vers ce point de terminaison.

Déployer des assistants

Exécuter la commande de déploiement :

a365 deploy

Note

a365 deploy -h affiche toutes les options pour exécuter cette commande, y compris les sous-commandes.

.NET

La commande de déploiement pour les assistants .NET :

• Détecte les fichiers de projet .NET (*.csproj, *.fsproj ou *.vbproj)
• Restaure les packages NuGet à l’aide de dotnet restore
• Publie l’application à l’aide de dotnet publish avec la configuration Release
• Crée un manifeste Oryx avec la commande du DLL de point d’entrée (par exemple, dotnet YourApp.dll)
• Configure le runtime Azure en fonction de la version .NET détectée (valeur par défaut : DOTNET|8.0)
• Déploie via un fichier ZIP avec une progression en temps réel

Python

La commande de déploiement pour les assistants Python :

• Détecte la structure du projet Python (fichiers pyproject.toml, requirements.txt et *.py)
• Génère des packages à l’aide de uv build si le fichier pyproject.toml est présent
• Convertit automatiquement le fichier .env en paramètres d’application Azure
• Détection intelligente du démarrage : identifie les points d’entrée d’Agent 365.
• Configure l'environnement d'exécution Azure pour PYTHON|3.11
• Déploie via un fichier ZIP avec une progression en temps réel

Node.js

La commande de déploiement pour les assistants Node.js :

• Détecte la structure du projet Node.js (fichier package.json)
• Installe les dépendances à l’aide de npm ci (revient à npm install si nécessaire)
• Exécute le script de build (npm run build) s’il est défini dans package.json
• Copie les fichiers de l’application : la sortie générée (dist/build) ou les fichiers sources
• Copies node_modules pour le déploiement Azure
• Crée un manifeste Oryx avec la commande de démarrage définie dans package.json (ou détecte le point d’entrée)
• Configure le runtime Azure en fonction de la version .Node détectée (valeur par défaut : NODE|18)
• Déploie via un fichier ZIP avec une progression en temps réel

Avertissement

Gestion des secrets : lors du déploiement, les variables d’environnement (y compris les clés API et les secrets) sont stockées en tant que paramètres d’application Azure. Bien que les variables d’environnement soient couramment utilisées pour la configuration, elles sont stockées en texte clair. Pour les environnements de production, Microsoft recommande d’utiliser Azure Key Vault pour les secrets sensibles. Pour plus d’informations, consultez Stockage sécurisé de secrets d’application en environnement de développement dans ASP.NET Core et Fournisseur de configuration Azure Key Vault. Ne validez jamais des fichiers .env contenant des informations sensibles dans le contrôle de code source.

Vérifier le déploiement

Une fois le déploiement terminé :

1. Accédez à votre application Web dans le portail Azure
2. Accédez à Paramètres>Configuration pour vérifier les paramètres de l’application
3. Vérifier les journaux de déploiement dans le Centre de déploiement

Étapes suivantes

Ensuite, publiez votre application agent dans Microsoft Admin Center afin que les instances et utilisateurs d’agents puissent être créés à partir de celui-ci : Publiez l’agent dans Microsoft Admin Center

Votre agent est désormais en ligne dans le cloud et prêt à répondre aux demandes d’agent. Pendant que votre agent gère des demandes réelles, considérez les étapes suivantes de votre code :

• Surveiller les performances : utilisez des fonctionnalités d’observabilité pour suivre le comportement de l’assistant et optimiser ses réponses
• Ajouter davantage d’outils : explorez le catalogue d’outils pour étendre les capacités de votre assistant
• Itérer et améliorer : mettez à jour le code de votre assistant, redéployez-le et republiez-le (n’oubliez pas d’incrémenter le numéro de version)
• Mise à l’échelle au sein de votre organisation : partagez les réussites de votre assistant pour encourager son adoption