Skip to main content

Démarrage rapide pour les extensions GitHub Copilot

Construisez et essayez l'extension Blackbeard de GitHub pour découvrir le processus de développement de GitHub Copilot Extensions.

L’extension Blackbeard est une GitHub Copilot Extension générée avec un agent simple qui répond aux demandes comme un pirate en utilisant l’API du grand modèle de langage (LLM) de Copilot et des requêtes système spéciales. Ce guide utilise une implémentation d’agent simple, mais le processus est similaire pour les ensembles de compétences.

Ce guide de démarrage rapide est conçu pour vous aider à créer et à discuter avec l’extension Blackbeard le plus rapidement possible, afin de pouvoir développer et tester votre extension sans déployer l’infrastructure. Pour la production, vous devrez héberger l'application pour les points de terminaison de votre agent ou de votre ensemble de compétences sur un serveur accessible au public. Pour savoir comment créer une nouvelle GitHub Copilot Extension, consultez Configuration des extensions Copilot.

1. Créez et installez une GitHub App

Dans les paramètres de développement de votre compte GitHub, créez une GitHub App. Votre GitHub App doit avoir :

  • Un nom
  • L’URL de la page d’accueil
  • Webhooks désélectionnés

Après avoir créé votre application, cliquez sur Installer l’application dans la barre latérale, puis installez votre application sur votre compte.

Pour obtenir des instructions détaillées, consultez Création d’une application GitHub pour votre extension Copilot.

2. Clonez et hébergez localement l’agent Blackbeard

Plutôt que de déployer l'agent Blackbeard en tant qu'application web, vous pouvez héberger votre agent localement, ce qui accélère considérablement le processus de construction.

  1. En utilisant le Terminal intégré dans VS Code, clonez le référentiel copilot-extensions/blackbeard-extension.
  2. Dans le même Terminal, exécutez npm install pour installer les dépendances nécessaires, puis exécutez npm start pour démarrer l’agent Blackbeard sur le port 3000.
  3. Dans l’onglet « Ports » du panneau VS Code, cliquez sur ** Transmettre un port** ou Ajouter un port, puis ajoutez le port 3000.
  4. Faites un clic droit sur le port et définissez la visibilité sur « Public », puis copiez l’adresse locale.

3. Intégrez et testez l’extension Blackbeard

Après avoir configuré votre GitHub App et l’agent Blackbeard, vous pouvez intégrer l’agent à votre application et tester l’extension Blackbeard. Vous devez apporter les modifications suivantes à vos paramètres GitHub App :

  • Dans les paramètres « Généraux », dans le champ « URL de rappel », collez l’adresse locale de votre agent.
  • Dans les paramètres « Autorisations et événements », accordez des autorisations en lecture seule à Copilot Chat.
  • Dans les paramètres « Copilot », réglez votre type d’application sur « Agent », puis remplissez les champs restants.

Après avoir mis à jour vos paramètres GitHub App, vous pouvez commencer à dialoguer avec votre extension en tapant @YOUR-EXTENSION-NAME dans la fenêtre Copilot Chat, puis en envoyant une requête comme d’habitude.

Pour obtenir des instructions plus détaillées, consultez Configuration de votre application GitHub pour votre agent Copilot.

Étapes suivantes

Maintenant que vous disposez d’une GitHub Copilot Extension fonctionnelle, vous pouvez essayer de générer l’agent Blackbeard pour expérimenter le développement d'un agent.

Pour en savoir plus sur la mise en œuvre d’agents plus complexes, vous pouvez également examiner les exemples d’agents et le kit de développement logiciel (SDK) suivants, qui sont tous disponibles dans l’organisation copilot-extensions :

  • GitHub Models : un agent plus complexe qui vous permet de poser des questions et d’interagir avec divers LLM référencés sur la GitHub Marketplace par le biais de Copilot Chat. L’agent GitHub Models utilise l’appel de fonction.
  • Appel de fonction : un exemple d’agent écrit en Go qui démontre l’appel de fonction et les dialogues de confirmation.
  • Extension RAG : un exemple d’agent écrit en Go qui démontre une implémentation simple de la génération augmentée de récupération.
  • Kit de développement logiciel (SDK) en préversion : un Kit de développement logiciel (SDK) qui rationalise le développement de Copilot Extensions en gérant automatiquement la vérification de la demande, l’analyse de la charge utile et le formatage de la réponse. Ce Kit de développement logiciel (SDK) permet aux créateurs d’extensions de se concentrer davantage sur la création de fonctionnalités principales et moins sur le code réutilisable.