Configuration guidée par IA pour Agent 365

Le cycle de vie de développement de l’agent 365 implique plusieurs étapes : installation de l’interface CLI, configuration des prérequis, création d’un blueprint d’agent, déploiement de 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 AI automatise cet ensemble de flux de travail à l’aide d’un agent de codage IA (tel que GitHub Copilot dans VS Code) pour exécuter les étapes de 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 automatique des prérequis : l’agent IA vérifie que Azure CLI est installé et authentifié, que votre enregistrement d'application cliente personnalisée dispose des permissions appropriées avec le consentement administrateur, et que les outils de compilation spécifiques au langage sont disponibles — tout cela avant d’exécuter des commandes CLI a365.
• Smart defaults and auto-detection — L’agent IA interroge votre abonnement Azure pour retrouver les groupes de ressources existants, les plans App Service et les informations utilisateur, puis utilise ces valeurs comme suggestions lors de la collecte des informations de configuration.
• Conventions d’affectation de noms dérivées : vous fournissez un nom de base unique pour votre agent et l’agent IA dérive tous les noms de ressources associés (identité, blueprint, nom d’utilisateur principal, application web) à l’aide de modèles 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

• Visual Studio Code avec les extensions GitHub Copilot et GitHub Copilot Chat installées. La configuration guidée par IA nécessite un agent de codage IA avec accès au terminal.
• .NET 8.0 ou version ultérieure — Obligatoire pour l’interface CLI Agent 365. Installez .NET.
• Azure CLI : requis pour l’authentification et la gestion des ressources. Installer Azure CLI.

Comptes et autorisations requis

• abonnement Azure avec accès Contributeur
• Microsoft Entra tenant avec l’un des rôles suivants :
  • Administrateur général
  • Administrateur d’ID d’agent
  • Développeur d'ID d'agent
• Enregistrement personnalisé de l’application client - La configuration guidée par l’IA valide cet enregistrement, mais l’application doit déjà exister dans votre locataire avec les autorisations requises et le consentement de l’administrateur. Pour en créer un, consultez Inscription d’application cliente personnalisée.

Code d’agent requis

• Projet d’agent opérationnel (Python, Node.jsou .NET) que vous souhaitez déployer. Si vous n’en avez pas, commencez par un exemple 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 référentiel, téléchargez le fichier directement à partir de 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 le répertoire de votre projet d’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 GitHub Copilot Conversation en mode agent

Ouvrez le panneau conversation GitHub Copilot et basculez en mode Agent. Le mode Agent offre GitHub Copilot la possibilité d’exécuter des commandes de terminal, de lire des fichiers et d’interagir avec votre projet , toutes les fonctionnalités requises par la configuration guidée par l’IA.

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

Dans l'entrée de conversation de Copilot, joignez le fichier a365-setup-instructions.md et envoyez-le avec une brève invitation. Par exemple:

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

L’agent IA lit le fichier d’instructions et démarre la configuration guidée. Il crée une liste de tâches avec cinq étapes et les exécute un par un :

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. prérequis Validate : confirme l’authentification Azure CLI, valide l’inscription et les autorisations de votre application cliente personnalisée et vérifie que les outils de génération sont installés pour votre type de projet.
3. Configurer l'interface CLI de l'Agent 365 - Vous demande si vous souhaitez un hébergement sur Azure ou un déploiement auto-hébergé, collecte les valeurs de configuration, déduit les noms des ressources et crée le fichier a365.config.json.
4. Provisionner les ressources - Exécute a365 setup all pour créer une infrastructure Azure et le Blueprint de l’agent.
5. Publish et deploy : examine le manifeste, publie l’agent dans le centre d’administration Microsoft 365, déploie le code sur Azure et fournit des 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 : créer une application web Azure (hébergée Azure) ou utiliser un point de terminaison existant (auto-hébergé).
• valeurs Configuration : groupe de ressources, emplacement, nom de l’agent, e-mail du responsable et plan App Service (pour Azure-hébergé) ou nom de l’agent et e-mail du responsable (pour auto-hébergé).
• Confirmation de la valeur dérivée : passez en revue les noms générés automatiquement pour l’identité de l’agent, le plan directeur et le principal utilisateur.
• Examen du manifeste — Confirmez que votre manifest.json est à jour avec le nom de votre agent, sa description, et les informations sur le développeur.

É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 :

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, vérifiez que vous utilisez Agent mode dans GitHub Copilot Conversation. 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