Déployer l’assistant sur Azure

Vous avez créé votre assistant et l’avez testé localement. Il est maintenant temps de le déployer dans le cloud. Cette étape est facultative. Vous pouvez sauter cette étape si vous avez déjà déployé votre assistant sur un cloud (il n’est même pas nécessaire que ce soit 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 enregistrée par votre organisation.

Pour mettre à jour le point de terminaison de messagerie, consultez les ressources suivantes. Ces ressources expliquent comment vous pouvez mettre à jour le point de terminaison de messagerie si vous avez déployé votre assistant sur d’autres plateformes cloud comme Amazon Web Services ou Google Cloud Platform :

Configuration requise

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

Comptes et autorisations requis

Outils requis

Déployer dans Azure

Déployez le code de votre application assistant sur Azure en utilisant des outils standards Azure tels que l’Azure CLI, le portail Azure ou GitHub Actions.

Application de déploiement d’assistant

Utilisez la commande Azure CLI az webapp deploy pour déployer votre application :

# Build your project first (example for .NET)
dotnet publish -c Release -o ./publish

# Deploy to Azure Web App
az webapp deploy --name <your-web-app> --resource-group <your-resource-group> --src-path ./publish

Pour GitHub Actions, utilisez l’action Azure Web Apps Deploy.

Avertissement

Gestion des secrets : stockez les variables d’environnement, notamment les clés d’API et les secrets, sous forme de paramètres d’application Azure plutôt que dans le code ou des fichiers de configuration. Pour les environnements de production, utilisez 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é, utilisez cette liste et les instructions dans les sections suivantes pour vérifier le déploiement.

✅ Commande de déploiement terminée sans erreurs
✅ L’application web est en cours d’exécution
✅ Les journaux d’application montrent un démarrage réussi
✅ Les variables d’environnement sont configurées
✅ Le point de terminaison de messagerie répond

Vérifiez que la commande de déploiement s’est exécutée sans erreurs

Une fois le déploiement terminé, vérifiez la réussite dans les journaux de déploiement

  1. Accédez à votre application web sur 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.

Pour voir l’historique détaillé des déploiements :

  1. Accédez au portail Azure > votre application Web
  2. Déploiement>Centre de déploiement
  3. Consultez les journaux de votre dernier déploiement

Si la compilation échoue :

  • Nettoyez et recompilez localement d’abord pour confirmer que la compilation fonctionne.
  • Vérifiez s’il manque des dépendances ou des erreurs de syntaxe.
  • Voir Échec de la commande de déploiement.

Si l’application plante après le déploiement :

  • Vérifiez les journaux pour rechercher d’éventuels messages d’erreur spécifiques.
  • Vérifiez que toutes les variables d’environnement requises sont définies.
  • Consulter l’application se bloque au démarrage.

Vérifiez que l’application web est en cours d’exécution

Utilisez la az webapp showcommande pour vérifier que l’application web est en cours d’exécution.

az webapp show --name <your-web-app> --resource-group <your-resource-group> --query state

La sortie attendue de cette commande est Running.

Vérifiez que les journaux d’application indiquent un démarrage réussi

Pour afficher les journaux de l’application web dans le portail Azure :

  1. Recherchez l’application web par son nom dans le portail Azure.
  2. Accédez à Vue d’ensemble>Journaux>Flux de journaux.

Sinon, vous pouvez utiliser la commande PowerShell az webapp log tail pour lire les journaux de l’application web :

az webapp log tail --name <your-web-app> --resource-group <your-resource-group>

S’il y a des messages de plantage ou d’erreur dans les journaux, consultez l’Application se bloque au démarrage.

Vérifier que les variables d’environnement sont configurées

Dans le portail Azure :

  1. Accédez à votre application web.
  2. Accédez à Paramètres>Variables d’environnement.
  3. Vérifiez que vos paramètres existent.

Si les variables d’environnement ne sont pas définies :

Vérifiez que le point de terminaison de messagerie répond

Testez que le point de terminaison que vous trouvez dans la page Aperçu de votre application web existe en utilisant PowerShell ou d’autres moyens. Sinon, voir 404 sur le point de terminaison de messagerie.

Étapes suivantes

Ensuite, publiez votre application d’assistant dans le centre d’administration Microsoft afin de pouvoir créer des instances d’assistant et des utilisateurs à partir de celle-ci.

Publiez votre assistant

Votre assistant est maintenant en ligne dans le cloud et prêt à répondre aux requêtes agentiques. À mesure que votre assistant traite des demandes réelles, envisagez les étapes suivantes pour 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.

Résolution des problèmes

Cette section décrit les problèmes courants lors du déploiement d’assistants dans Azure.

Astuce

Le Guide de dépannage 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.

Échec de la commande de déploiement

Symptôme : le déploiement sur Azure échoue.

Causes courantes et solutions :

  • Erreurs de compilation

    Reconstruisez le projet localement pour afficher les erreurs de build détaillées :

    # .NET
dotnet clean
dotnet build --verbosity detailed

# Python
uv build

# Node.js
npm install
npm run build

  • Authentification Azure expirée

    Connectez-vous à nouveau à Azure :

    az login
az account show  # Verify correct subscription

  • Application web non créée

    Listez les applications Web pour confirmer que la cible existe :

    # List Web Apps in resource group
az webapp list --resource-group <your-resource-group> --output table

  • Vérifiez les journaux de déploiement

    Utilisez la commande az webapp log tail pour consulter les journaux de déploiement détaillés :

    az webapp log tail --name <your-app-name> --resource-group <your-resource-group>

  • Vérification :

    # Web App should be running
az webapp show --name <your-app-name> --resource-group <your-resource-group> --query state
# Expected: "Running"

L’application web est arrêtée

Symptôme : Le déploiement réussit, mais l’application web n’est pas en cours d’exécution.

Solution : Utilisez az webapp start et az webapp show pour démarrer l’application web et vérifier qu’elle fonctionne.

# Start the Web App
az webapp start --name <your-app> --resource-group <your-resource-group>

# Verify it's running
az webapp show --name <your-app> --resource-group <your-resource-group> --query state

L’application se bloque au démarrage

Symptôme : l’application Web démarre, mais se bloque immédiatement ; les journaux montrent des erreurs.

Causes courantes :

  • Dépendances manquantes : vérifiez que la sortie de génération inclut tous les packages requis.
  • Variables d’environnement manquantes : vérifiez que tous les paramètres requis sont configurés.
  • Incompatibilité de version à l’exécution : assurez-vous que l’environnement d’exécution Azure correspond à votre environnement de développement.
  • Erreurs de code : vérifiez les journaux de l’application afin de rechercher des exceptions spécifiques.

Solution : Utilisez les commandes az webapp log tail, az webapp config appsettings list et az webapp config appsettings set pour consulter les journaux, vérifier les variables d’environnement et définir les variables manquantes.

# View application logs
az webapp log tail --name <your-app> --resource-group <your-resource-group>

# Check environment variables
az webapp config appsettings list --name <your-app> --resource-group <your-resource-group>

# Manually set a missing variable
az webapp config appsettings set --name <your-app> --resource-group <your-resource-group> --settings KEY=VALUE

Erreur 404 sur le point de terminaison de messagerie

Symptôme : l’application Web fonctionne, mais /api/messagesle point d’extrémité renvoie l’erreur 404.

Solution :

  1. Vérifiez la configuration des routes dans le code de votre assistant.
  2. Vérifiez que le gestionnaire de point de terminaison est correctement enregistré.
  3. Veillez à ce que le point d’entrée correct soit spécifié lors du déploiement.

Testez le point de terminaison en envoyant une requête GET à l’URL. Utilisez la commande az webapp config show pour vérifier la configuration de l’application web.

curl https://<your-app-name>.azurewebsites.net/api/messages
az webapp config show --name <your-app> --resource-group <your-resource-group>

Variables d’environnement non définies ou incorrectes

Symptôme : le déploiement réussit, mais l’assistant ne fonctionne pas ; erreurs de configuration manquantes dans les journaux.

Solution : vérifiez et mettez à jour les variables d’environnement. Utilisez les commandes az webapp config appsettings list et az webapp config appsettings set pour vérifier les variables d’environnement et renseigner les variables manquantes. Ensuite, redéployez.

# List all app settings
az webapp config appsettings list --name <your-app> --resource-group <your-resource-group>

# Set a specific variable
az webapp config appsettings set --name <your-app> --resource-group <your-resource-group> --settings API_KEY=your-value

La compilation réussit localement mais échoue sur Azure

Symptôme : Le code se compile bien sur votre machine mais échoue lors du déploiement sur Azure.

Solutions :

  • Vérifiez les dépendances spécifiques à la plateforme

    • Certains paquets ont des versions spécifiques à la plateforme.
    • Assurez-vous que les dépendances sont compatibles avec Linux (les applications Web Azure s’exécutent sur Linux par défaut).

  • Vérifier que les versions du runtime correspondent

    Exécutez ces commandes :

    # Check your local version
dotnet --version  # .NET
node --version    # Node.js
python --version  # Python

    Comparer avec le runtime Azure dans le portail : Paramètres>Configuration>Paramètres généraux>Paramètres de pile.

Pour plus d’aide, voir : Dépannage du point de terminaison de messagerie.

  • Last updated on