Partager via

Connecter l’agent de codage GitHub Copilot au serveur Azure MCP

Cet article vous montre comment configurer et connecter l’agent de codage GitHub Copilot au serveur Azure MCP afin que l’agent de codage puisse comprendre vos fichiers et ressources Azure spécifiques à Azure pour apporter des modifications à vos fichiers de code.

Dans votre dépôt GitHub, l’affectation de problèmes GitHub à l’agent de codage GitHub Copilot crée une demande de tirage (pull request) avec les modifications apportées à votre code. Si les modifications demandées nécessitent l’accès à vos ressources Azure, l’agent de codage GitHub Copilot doit utiliser le serveur Azure MCP. Avant que l’agent de codage GitHub Copilot puisse utiliser le serveur Azure MCP pour apporter des modifications à votre projet basé sur Azure, vous devez configurer l’agent de codage Copilot GitHub et lui accorder les autorisations appropriées dans Azure. Vous pouvez configurer manuellement tout, mais de nombreuses étapes sont automatisées à l’aide azdd’Azure Developer CLI et de l’extension coding-agent .

Prerequisites

  • Un compte Azure et un accès à un abonnement Azure. Pour plus d’informations sur la façon de les configurer, consultez la page de tarification des comptes Azure.

  • Un compte GitHub et un abonnement GitHub Copilot. Pour plus d’informations sur la façon de les configurer, consultez Création d’un compte sur GitHub et Démarrage rapide pour GitHub Copilot, respectivement.

  • Clone local existant d’un dépôt GitHub. Dans la mesure où cet article explique comment configurer la connexion entre l’agent de codage Copilot GitHub au serveur Azure MCP, le dépôt GitHub doit inclure des scripts de déploiement sur Azure, comme des modèles Bicep ou Terraform.

Configurer le référentiel GitHub pour utiliser le serveur Azure MCP

L’extension azd de codage-agent simplifie les étapes requises pour configurer en toute sécurité la connexion entre l’agent de codage GitHub Copilot et le serveur Azure MCP pour votre abonnement Azure. Tout d’abord, il crée un compte dans votre abonnement Azure et lui attribue un rôle avec les autorisations nécessaires. Ensuite, il fournit un extrait de code JSON requis pour introduire le serveur Azure MCP à l’agent de codage GitHub Copilot.

  1. Si vous n’avez azd pas encore installé, suivez les instructions pour l’installer.

  2. Dans le terminal, accédez au clone local du référentiel avec lequel vous souhaitez travailler.

  3. Appelez l’extension de l’agent de codage azd avec la commande : azd coding-agent config.

  4. Pendant l’installation, vous êtes invité à sélectionner votre :

    • Abonnement Azure
    • Quel dépôt GitHub utilisera l’agent de codage Copilot
    • Que vous souhaitiez créer une identité managée utilisateur nouvelle ou existante
    • Un emplacement Azure
    • Un groupe de ressources Azure
    • Dépôt GitHub dans lequel une nouvelle branche sera créée contenant le fichier de configuration du flux de travail GitHub Actions généré

    Lorsque vous sélectionnez l’emplacement et le groupe de ressources, vous pouvez utiliser le même emplacement cible et le même groupe de ressources que les ressources Azure dans l’application.

  5. Après quelques instants, l’extension azd de l’agent de codage crée (ou utilise l’identité managée existante) l’identité managée par l’utilisateur et l’attribue à un rôle, stocke les valeurs d’identité dans l’environnement de référentiel GitHub, et crée et envoie (push) une branche contenant le fichier de configuration du flux de travail GitHub Actions généré.

  6. Un message s’affiche dans la console :

    (!)
(!) NOTE: Some tasks must still be completed, manually:
(!)

    En général, il existe trois tâches :

    • Fusionnez la branche contenant le fichier de configuration du flux de travail GitHub Actions généré.
    • Configurez les rôles d’identité managée de l’agent de codage Copilot dans le portail Azure. Par défaut, le rôle « Lecteur » est attribué. Toutefois, vous souhaiterez peut-être lui accorder d’autres autorisations en fonction de ce que vous souhaitez que l’agent de codage fasse de manière autonome.
    • Visitez le lien pour configurer la configuration MCP. Pour y accéder manuellement, dans GitHub, allez dans > Settings > Copilot > agent de codage, Configuration MCP et collez l'extrait de code JSON fourni. Voici un exemple :
    {
    "mcpServers": {
        "Azure": {
            "type": "local",
            "command": "npx",
            "args": [
                "-y",
                "@azure/mcp@latest",
                "server",
                "start"
            ],
            "tools": [
                "*"
            ]
        }
    }
}

  7. Enfin, vous pouvez autoriser l’extension de l’agent azd de codage à ouvrir le navigateur afin de créer la pull request pour fusionner la branche contenant le fichier de configuration du workflow GitHub Actions généré.

Créer un ticket dans GitHub pour initialiser l’agent de codage GitHub Copilot

À ce stade, vous avez correctement configuré l’agent de codage GitHub Copilot pour utiliser le serveur Azure MCP pour tous les problèmes GitHub que vous affectez à l’agent de codage Copilot GitHub qui nécessitent une compréhension des déploiements et des ressources Azure.

Par exemple, supposons que vous souhaitez augmenter la mémoire allouée à PostgreSQL lors du déploiement sur Azure Database pour PostgreSQL. Vous créez un problème pour modifier votre modèle Bicep pour utiliser le niveau de stockage suivant disponible et l’affecter à GitHub Copilot.

Note

Le rôle d'identité gérée utilisateur est par défaut défini sur « Lecteur », par conséquent, vous devez demander des modifications pour modifier les scripts de déploiement tels que les modèles Bicep ou Terraform. Le fait de demander directement de modifier les ressources existantes dans votre abonnement Azure n’est pas autorisé en raison des autorisations du rôle « Lecteur ».

  1. Dans GitHub, dans le référentiel contenant votre projet Azure où vous avez activé le serveur Azure MCP, accédez aux problèmes.

  2. Sélectionnez le bouton « Nouveau problème ». Décrivez la modification que vous souhaitez que l’agent de codage GitHub Copilot effectue dans les champs de titre et de description. Sélectionnez le bouton « Créer ».

    L’emprunt de l’exemple précédent vous permet d’utiliser le texte suivant pour décrire votre problème.

    Title: Increase database storage

Currently, when deploying to Azure via Bicep, we're creating a PostgreSQL database with 32gb of storage. I need the next tier higher -- whatever that is.

    Cet exemple de problème rend une demande simple et claire, même si l’utilisateur ne sait pas exactement ce qu’il demande. Il permet au serveur Azure MCP d’effectuer des recherches sur les niveaux de stockage disponibles pour le serveur flexible Azure Database fo PostgreSQL et le paramètre dans le modèle Bicep requis pour apporter cette modification.

    Important

    Veillez à utiliser le mot « Azure » dans votre invite pour vous assurer que GitHub Copilot demande des outils à partir du serveur Azure MCP.

  3. Sélectionnez le bouton « Affecter à Copilot » sous Assignees. La boîte de dialogue « Affecter Copilot au problème » s’affiche, ce qui vous permet de modifier le référentiel cible, la branche de base et d’ajouter une invite facultative. Cliquez sur le bouton « Affecter ».

  4. Une fois le problème affecté à l’agent de codage Copilot GitHub, vous voyez un lien vers le pull request avec le préfixe « [WIP] » indiquant que le travail commence.

  5. Sélectionnez le lien « [WIP] » pour afficher le pull request.

  6. Dans la description de la pull request, sélectionnez le lien pour afficher la session de codage. Cela montre la progression de l’agent Copilot Coding sur la demande, similaire à l’expérience dans Visual Studio.

  7. Une fois terminé, l’agent de codage Copilot GitHub demande une révision de code. Utilisez votre flux de travail normal pour itérer avec GitHub, en traitant l’agent de codage Copilot GitHub en tant que collègue.

  8. Lorsque vous approuvez les modifications et fusionnez le pull request, GitHub Copilot traite le problème d’origine que vous avez créé.

Contenu connexe

  • Last updated on