Partager via

Configuration guidée par IA pour Agent 365

Importante

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.

Le cycle de développement de l’Agent 365 comprend plusieurs étapes : installation de la ligne de commande, configuration des prérequis, création d’un blueprint d’agent, déploiement du code et publication dans le centre d’administration Microsoft 365. Chaque étape a ses propres prérequis, vérifications de validation et points de décision.

La configuration guidée par IA automatise tout ce flux de travail en utilisant un agent de codage IA (comme GitHub Copilot dans VS Code) pour exécuter les étapes du cycle de vie en votre nom. Au lieu de naviguer entre plusieurs pages de documentation et d’exécuter manuellement des commandes, vous fournissez à l’agent IA un seul fichier d’instructions qui vous guide de manière interactive à travers le processus.

Avantages

La configuration guidée par IA offre plusieurs avantages par rapport au flux de travail manuel :

  • Point d’entrée unique — Un seul fichier d’instructions remplace la nécessité de naviguer entre plusieurs pages de documentation. L’agent IA suit les étapes dans l’ordre et gère automatiquement les transitions.
  • Validation automatisée des prérequis — L’agent IA valide que la CLI Azure est installée et authentifiée, que votre enregistrement client personnalisé dispose des permissions correctes avec le consentement de l’administrateur, et que des outils de compilation spécifiques à chaque langue sont disponibles – tout cela avant d’exécuter toute a365 commande CLI.
  • Paramètres par défaut intelligents et détection automatique — L’agent IA interroge votre abonnement Azure pour les groupes de ressources existants, les plans de service App et les informations utilisateur, puis utilise ces valeurs comme suggestions lors de la collecte des entrées de configuration.
  • Conventions de nommage dérivées — Vous fournissez un nom de base unique à votre agent, et l’agent IA dérive tous les noms de ressources associés (identité, blueprint, nom principal utilisateur, application web) en utilisant des schémas cohérents.
  • Gestion des erreurs en ligne — Lorsqu’une commande échoue, l’agent IA analyse l’erreur, suggère une correction et réessaie - plutôt que de vous demander de consulter la documentation de dépannage.
  • Configuration non interactive — L’agent IA crée le a365.config.json fichier directement et l’importe, évitant ainsi les problèmes liés aux assistants CLI interactifs dans les environnements automatisés.

Prerequisites

Avant de commencer, vérifiez que vous disposez des conditions préalables suivantes :

Outils requis

Comptes et autorisations requis

Code d’agent requis

  • Un projet d’agent fonctionnel (Python, Node.jsou .NET) que vous souhaitez déployer. Si vous n’en avez pas, commencez par un des exemples de démarrage rapide.

Obtenez le fichier d’instructions de configuration

La configuration guidée par IA utilise un fichier d’instructions nommé a365-setup-instructions.md. Le dépôt Agent365-devTools inclut ce fichier.

Si vous avez cloné le dépôt, le fichier se trouve à :

Agent365-devTools/docs/agent365-guided-setup/a365-setup-instructions.md

Si vous n’avez pas cloné le dépôt, téléchargez le fichier directement depuis GitHub.

Exécutez la configuration guidée par l’IA

Suivez ces étapes pour commencer la configuration guidée par IA dans votre projet d’agent.

Étape 1 : Ouvrez votre projet d’agent dans VS Code

Ouvrez votre répertoire de projet agent dans Visual Studio Code. Ce répertoire contient votre code agent (par exemple, le répertoire contenant votre package.json, *.csproj, ou pyproject.toml fichier).

Étape 2 : Ouvrir le chat Copilot GitHub en mode agent

Ouvrez le panneau de discussion Copilot de GitHub et passez en mode Agent . Le mode agent donne à GitHub Copilot la possibilité d’exécuter des commandes de terminal, de lire des fichiers et d’interagir avec votre projet – toutes des fonctionnalités requises par la configuration guidée par l’IA.

Importante

Vous devez utiliser le mode Agent (pas le mode Demande ou Édition). La configuration guidée par l’IA nécessite la capacité d’exécuter des commandes terminales et d’interagir avec votre environnement.

Étape 3 : Attachez le fichier d’instructions et commencez

Dans l’entrée du Copilot Chat, attachez le a365-setup-instructions.md fichier et envoyez-le avec une courte invite. Par exemple:

Follow the steps in #file:a365-setup-instructions.md

L’agent IA lit le fichier d’instructions et commence la mise en place guidée. Il crée une liste de tâches avec cinq étapes et les parcourt séquentiellement :

  1. Vérifiez et installez la ligne de commande Agent 365 - Vérifie la CLI, l’installe ou la met à jour, et vérifie qu’elle fonctionne.
  2. Validez les prérequis - Confirme l’authentification Azure LI, valide l’enregistrement et les permissions de votre application client personnalisée, et vérifie que les outils de compilation sont installés pour votre type de projet.
  3. Configurez la ligne de commande Agent 365 - Demande si vous souhaitez un déploiement hébergé sur Azure ou en auto-hébergé, collecte les valeurs de configuration, dérive les noms des ressources et crée le a365.config.json fichier.
  4. Provisionner des ressources - S’exécute a365 setup all pour créer l’infrastructure Azure et le plan d’agent Blueprint.
  5. Publier et déployer - Examine le manifeste, publie l’agent dans le centre d’administration Microsoft 365, déploie le code sur Azure et fournit les instructions post-déploiement.

Étape 4 : Répondre aux consignes

L’agent IA fait une pause à des moments précis pour recueillir vos commentaires :

  • ID d’application client personnalisé — Votre ID d’application (client) pour l’enregistrement personnalisé de l’application client.
  • Type de déploiement — S’il faut créer une application Web Azure (hébergée sur Azure) ou utiliser un point de terminaison existant (auto-hébergé).
  • Valeurs de configuration — Groupe de ressources, emplacement, nom de l’agent, email du manager et plan App Service (pour l’hébergement Azure) ou nom de l’agent et email du manager (pour l’auto-hébergé).
  • Confirmation de valeur dérivée — Examiner les noms générés automatiquement pour l’identité de l’agent, le blueprint et le principal utilisateur.
  • Avis du manifeste — Confirmez que vous manifest.json êtes à jour avec le nom de votre agent, la description et les informations du développeur.

Conseil / Astuce

L’agent IA affiche des valeurs réelles de votre abonnement Azure par exemple lorsqu’il demande des entrées de configuration. Vous pouvez accepter les suggestions ou proposer vos propres valeurs.

Étape 5 : Accomplir les tâches post-déploiement

Après la fin des commandes CLI, l’agent IA fournit des instructions pour les étapes manuelles nécessitant une interaction avec le navigateur :

  1. Configurez l’agent dans le portail développeur Teams — Définissez le type d’agent et l’identifiant du bot.
  2. Créez une instance d’agent — Demandez une instance à Teams et faites approuver par un administrateur.
  3. Testez l’agent — Envoyez des messages à votre agent dans Teams pour vérifier qu’il fonctionne.

Pour des instructions détaillées sur ces étapes post-déploiement, voir Créer des instances d’agent.

Ce que couvre la configuration guidée par IA

La configuration guidée par l’IA automatise les étapes suivantes du cycle de vie du développement :

Phase du cycle de vie Ce que fait l’agent IA Équivalent manuel
Installation de CLI Installation ou mise à jour de la ligne de ligne de commande Agent 365 Agent 365 CLI
Prerequisites Valide Azure CLI, application client personnalisée, permissions et outils de compilation Enregistrement personnalisé de l’application client
Paramétrage Crée a365.config.json avec des valeurs validées Configuration de l’agent de configuration 365
Configuration du blueprint Des courses a365 setup all pour créer des infrastructures et des plans Plan d’agent de configuration
Déploiement Exécute a365 deploy le code pour construire et déployer du code Deploy agent to Azure
Publishing Course a365 publish vers l’agent d’enregistrement dans le centre d’administration Publier l’agent vers Microsoft admin Center

Note

La configuration guidée par l’IA ne remplace pas le besoin de construire d’abord le code de votre agent . Vous devriez avoir un projet d’agent fonctionnel avant de commencer la configuration guidée. Pour les nouveaux projets, commencez par un démarrage rapide.

Résolution des problèmes

L’agent IA n’exécute pas les commandes terminales

Si l’agent IA décrit les commandes mais ne les exécute pas, assurez-vous d’utiliser le mode Agent dans le chat Copilot de GitHub. Les modes Demande et Édition n’ont pas accès au terminal.

L’agent IA saute les étapes de validation

Le fichier d’instructions impose un ordre strict des pas. Si l’agent IA semble sauter une étape, rappelez-lui de suivre les instructions dès le début. Par exemple:

Please start from Step 1 in the setup instructions and work through each step in order.

Les commandes CLI échouent avec des erreurs de permission

Si a365 les commandes CLI échouent avec des erreurs d’autorisation, la cause la plus fréquente est une inscription manquante ou incomplète de l’application client personnalisée. L’agent IA valide cet enregistrement à l’étape 2, mais si vous avez sauté cette validation, revenez en arrière et lancez-la. Pour le guide complet de configuration, voir Enregistrement personnalisé de l’application client.

Les valeurs de configuration sont incorrectes

Si vous devez changer les valeurs de configuration après la création du a365.config.json fichier, vous pouvez soit :

  • Éditez directement le a365.config.json fichier et relancez-le a365 config init -c ./a365.config.json
  • Demandez à l’agent IA de mettre à jour des valeurs spécifiques

Prochaines étapes

Découvrez le cycle de développement de l’Agent 365

Créer des instances d’agent

  • Last updated on