Déployer et publier des assistants

Vous avez créé votre assistant et l’avez testé localement : il est maintenant temps de le déployer dans le cloud. Le déploiement et la publication de votre agent le rendent accessible dans toute votre organisation, permettant aux équipes de découvrir, créer des instances d’agent et interagir avec lui via Microsoft 365.

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.

Vue d’ensemble

Le processus de déploiement et de publication implique deux étapes clés :

1. Déployer - Déployer votre agent sur Azure Web App (optionnel, passez si votre agent est déjà en cours d’exécution et accessible)
2. Publier : publier votre assistant dans le magasin d’assistants du Centre d’administration Microsoft 365

Après publication, terminez l’intégration en créant une instance d’agent via Microsoft Teams.

Configuration requise

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

Comptes et autorisations requis

• Client Microsoft Entra avec l’un des rôles suivants :
  • Administrateur général
  • Administrateur d’identifiant d’assistant
  • Développeur d’identifiant d’assistant
• Abonnement Azure avec accès contributeur

Outils requis

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

Étapes de configuration requises

Avant le déploiement et la publication, vérifiez que vous effectuez ces étapes dans l’ordre :

1. Création de plan d’agent - Complétez les étapes de configuration dans Enregistrer les agents pour créer votre plan d’agent
2. Assistant testé localement : vérifiez que votre assistant fonctionne correctement avec Agents Playground (voir Tester des assistants localement)
3. Fichiers de configuration prêts : vérifiez que a365.config.json et a365.generated.config.json sont à jour

Étape 1 : Déployer dans Azure

La commande a365 deploy déploie votre assistant dans l’Azure Web App créée lors de la configuration Cette commande charge le code de votre assistant dans Azure, ce qui le rend disponible pour s’exécuter dans le cloud et traiter les requêtes provenant de Microsoft 365.

Déployer des assistants

Exécuter la commande de déploiement :

a365 deploy

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

Étape 2 : Publier dans le Centre d’administration Microsoft

La commande a365 publish publie votre assistant dans le magasin d’assistants du Centre d’administration Microsoft 365, le rendant détectable et installable. Cette dernière étape rend votre agent disponible pour que les organisations puissent créer des instances d’agent et les utiliser dans leur environnement Microsoft 365.

Publier un assistant

Exécutez la commande de publication :

a365 publish

La commande de publication :

• Extrait les modèles de manifeste à partir de ressources incorporées (si le dossier manifest n’existe pas)
• Met à jour le fichier manifest.json avec l’ID du blueprint de l’assistant
• Suspend l’exécution pour vous permettre de personnaliser les champs du manifeste (version, noms, descriptions, informations sur le développeur, icônes)
• Génère le bundle de l’application (manifest.zip)
• Procède au chargement dans le magasin d’assistants du Centre d’administration Microsoft 365
• Crée une identité fédérée pour l’intégration à Teams
• Attribue les autorisations Graph nécessaires

Personnaliser le manifeste

L’interface CLI s’interrompt lors de la publication pour vous permettre de personnaliser votre manifeste d’assistant :

=== CUSTOMIZE YOUR AGENT MANIFEST ===

Your manifest has been updated at: [path]\manifest\manifest.json

When you're done customizing, type 'continue' (or 'c') and press Enter to proceed:

Étapes manuelles :

1. Ouvrez manifest.json dans votre éditeur de texte

2. Personnalisez les champs requis :

   • Mettre à jour le numéro de version. Incrémenter par rapport à la valeur précédente en cas de nouveau chargement.
   • Définir un nom pertinent pour l’assistant. Les noms doivent comporter 30 caractères maximum.
   • Rédiger des descriptions claires
   • Mettre à jour les informations sur le développeur
   • Remplacer éventuellement les fichiers d’icône

3. Enregistrer le fichier manifeste

4. Revenez à la CLI et saisissez continue ou c, puis appuyez sur Entrée.

La CLI complète le processus de publication et votre agent est désormais disponible dans Microsoft 365 Admin Center. Cependant, avant de pouvoir tester votre agent ou permettre aux utilisateurs de créer des instances, vous devez configurer le blueprint de l’agent dans le Portail Développeur.

Étape 3 : Configurer le plan de l’agent dans le Portail Développeur

Après publication, vous devez configurer le blueprint de l’agent dans le portail développeur Teams pour connecter votre agent à l’infrastructure de messagerie Microsoft 365. Sans cette configuration, votre agent ne recevra pas de messages provenant de Teams, d’e-mail ou d’autres services Microsoft 365.

Obtenez votre ID de plan

Exécutez la commande suivante pour afficher votre configuration :

a365 config display -g

Copiez la valeur agentBlueprintId de la sortie.

Naviguer vers le portail développeur

Ouvrez votre navigateur et allez à la page de configuration :

https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration

Remplacez-le <your-blueprint-id> par la agentBlueprintId valeur que vous avez copiée.

Configurer l’agent

Dans le portail développeur :

1. Définir le type d’agent sur un bot
2. Définissez l’ID du bot à votre agentBlueprintId valeur
3. Cliquez sur Enregistrer

Cette configuration est nécessaire avant de pouvoir créer des instances d’agent dans Teams.

Pour plus d’informations sur les plans d’identité d’agent et la configuration du portail développeur, voir Configurer le plan d’identité d’agent.

Étape 4 : Testez votre agent déployé

Après avoir déployé et publié votre assistant, vous pouvez le tester dans Microsoft 365 pour vous assurer qu’il fonctionne correctement en production. Une fois déployé, votre assistant s’intègre aux services Microsoft 365, notamment Teams (conversations, canaux, réunions), le courrier électronique et le calendrier (envoi/réception, planification), SharePoint et OneDrive (accès aux documents, partage de fichiers), ainsi qu’aux outils de collaboration (présence organisationnelle, tâches Planificateur, commentaires de documents).

Afficher l’assistant déployé dans le Centre d’administration

Une fois qu’il a été publié, votre assistant apparaît dans le Centre d’administration Microsoft, où il peut être engagé. La propagation peut prendre un certain temps.

Accédez à Centre d’administration Microsoft 365 - Assistants pour :

• Afficher votre assistant publié
• Gérer les paramètres de l’assistant
• Surveiller l’utilisation de l’assistant
• Configurer les autorisations

Tester l’assistant dans Teams

Après avoir déployé, publié, configuré votre blueprint d’agent et créé un utilisateur agent, vous pouvez tester l’utilisateur agent directement dans Microsoft Teams :

1. Créez une instance d’agent dans Teams

   • Ouvrez Microsoft Teams avec votre compte
   • Accédez à l’App Store Teams et recherchez votre agent publié
   • Créez une nouvelle instance d’agent à partir de votre plan d’agent

2. Début des tests

   • Commencez une nouvelle discussion avec votre instance d’agent nouvellement créée
   • Envoyer des messages test pour vérifier le fonctionnement de l’assistant

3. Exemple de message test

   Envoyez ce message pour tester la fonctionnalité de courrier électronique (mettez à jour l’adresse e-mail du destinataire si nécessaire) :

   Send an email to recipient@contoso.com with subject "Hello from Teams" and message "This is a test message from my agent!"
   

   L’assistant doit traiter la demande et envoyer le courrier électronique sans nécessiter de confirmation supplémentaire.

Étapes suivantes

Félicitations ! Votre assistant est maintenant opérationnel dans le cloud et prêt à travailler aux côtés de vos équipes dans Microsoft 365. Ce qui a commencé comme du code local est désormais un assistant accessible et prêt pour l’entreprise, où les utilisateurs peuvent créer des instances d’agents à travers votre organisation.

À mesure que votre assistant traite des demandes réelles, envisagez les étapes suivantes :

• 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

Le parcours de votre assistant, du développement au déploiement, est terminé, mais son impact ne fait que commencer.

Contenu associé

• Configuration du blueprint de l’assistant et de l’instance
• Référence de la CLI Agent 365
• Tester votre assistant
• En savoir plus sur l’observabilité
• Exemples pour les développeurs