Cet article est conçu pour vous aider à générer une nouvelle GitHub Copilot Extension. Pour apprendre à générer et tester rapidement une version de démonstration Copilot Extension créée par GitHub, consultez Démarrage rapide pour les extensions GitHub Copilot.
Les compétences et les agents sont les deux moyens d'étendre les capacités et le contexte de Copilot via la plateforme Copilot Extensibility Platform. Ils vous permettent d'intégrer des services externes et des API dans Copilot Chat, mais chacun d'entre eux répond à des cas d'utilisation différents et offre des niveaux de contrôle et de complexité différents :
- ensembles de compétences sont légers et simplifiés, conçus pour les développeurs qui ont besoin de Copilot pour effectuer des tâches spécifiques (par exemple, récupération de données ou opérations simples) avec une configuration minimale. Ils gèrent automatiquement le routage, l’élaboration rapide, l’évaluation des fonctions et la génération de réponse, ce qui les rend idéales pour les intégrations rapides et simples. Pour plus d'informations sur les ensembles de compétences, voir Ensembles de compétences Copilot.
- Agents concernent des intégrations complexes qui ont besoin d’un contrôle total sur la façon dont les demandes sont traitées et les réponses sont générées. Ils vous permettent d’implémenter une logique personnalisée, d’intégrer d’autres llms et/ou de l’API Copilot, de gérer le contexte de conversation et de gérer tous les aspects de l’interaction utilisateur. Bien que les agents nécessitent davantage d'ingénierie et de maintenance, ils offrent une flexibilité maximale pour les flux de travail sophistiqués. Pour plus d’informations sur les comptes, consultez À propos des agents Copilot.
1. Découvrez Copilot agents
Copilot agents contient le code personnalisé pour votre Copilot Extension, et s’intègre à une GitHub App pour former la Copilot Extension elle-même. Pour plus d’informations, consultez « À propos des agents Copilot ».
Pour réussir à générer un Copilot agent, vous devez comprendre comment l’agent communique avec :
- La plateforme Copilot à l’aide d’événements envoyés par le serveur. Consultez Configuration de votre agent Copilot pour communiquer avec la plateforme Copilot.
- L’API GitHub. Consultez Configurer votre agent Copilot pour qu’il communique avec GitHub.
2. Passez en revue l’exemple Copilot agents et le Kit de développement logiciel (SDK) Copilot Extensions
Pour mettre en pratique les concepts précédents et vous familiariser avec la mise en œuvre des agents, examinez les exemples d’agents et le kit de développement logiciel (SDK) suivants, qui sont tous disponibles dans l’organisation copilot-extensions :
- Blackbeard (meilleur point de départ) : un agent simple qui répond aux demandes comme un pirate en utilisant l’API de grand modèle de langage (LLM) et les invites système spéciales de Copilot.
- 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.
3. Générez un Copilot agent
En utilisant le matériel de référence des étapes précédentes, planifiez et générez votre Copilot agent. Vous pouvez choisir de mettre en œuvre l’une des options suivantes :
- Pour éviter de créer et de gérer votre propre déploiement LLM, votre agent peut appeler le déploiement LLM Copilot. Consultez Utilisation du LLM de Copilot pour votre agent.
- Pour interpréter rapidement les entrées de l’utilisateur et choisir parmi une variété de fonctions prédéfinies à exécuter, vous pouvez mettre en œuvre l’appel de fonction dans votre agent. Pour plus d’informations, consultez Comment utiliser l’appel de fonction avec Azure OpenAI Service dans la documentation Azure OpenAI et l’appel de fonction dans la documentation OpenAI.
4. Déployez votre Copilot agent
Pour rendre votre Copilot agent accessible à la plateforme Copilot et GitHub, vous devez le déployer sur un serveur accessible par demande HTTP. Consultez Configuration de votre serveur pour héberger votre agent Copilot.
5. Créez une GitHub App et intégrez-la à votre Copilot agent
Pour créer une Copilot Extension, il faut créer et configurer une GitHub App, puis l’intégrer à votre Copilot agent. Consultez Création d’une application GitHub pour votre extension Copilot et Configuration de votre application GitHub pour votre agent Copilot.
6. Modifier la visibilité de votre Copilot Extension
Choisissez l’un des deux niveaux de visibilité pour votre Copilot Extension :
- Publique : tout compte d’utilisateur ou d’organisation disposant du lien vers la page d’installation de l’extension peut l’installer.
- Privée : seul le compte de l’utilisateur ou de l’organisation qui a créé l’extension peut l’installer.
Si vous rendez votre Copilot Extension publique, vous pouvez alors choisir de la référencer sur la GitHub Marketplace.
Pour savoir comment modifier la visibilité de votre Copilot Extension et la référencer sur la GitHub Marketplace, consultez Gestion de la disponibilité de votre extension Copilot.
Étapes suivantes
Pour savoir comment utiliser votre Copilot Extension, consultez Utilisation d’extensions pour intégrer des outils externes à Copilot Chat.
1. A propos de Github Copilot skillsets
Github Copilot skillsets contient le code personnalisé pour votre Copilot Extension, et s’intègre à une GitHub App pour former la Copilot Extension elle-même.
Contrairement à Copilot agents, Copilot skillsets gère la logique qui sous-tend l’élaboration des prompts, l’évaluation des fonctions et la génération des réponses, ce qui en fait un choix idéal pour les développeurs à la recherche d’intégrations rapides et efficaces avec un minimum d’efforts. Pour plus d’informations, consultez « Ensembles de compétences Copilot ».
2. Générez un Copilot skillset
Pour explorer un exemple d’implémentation d’ensemble de compétences, consultez le référentiel 'exemple de compétences dans l’organisation copilot-extensions.
Pour générer un ensemble de compétences, consultez Ensembles de compétences Copilot.
3. Déployez votre Copilot skillset
Pour rendre votre Copilot skillset accessible à la plateforme Copilot et GitHub, vous devez le déployer sur un serveur accessible par demande HTTP. Consultez Configuration de votre serveur pour héberger votre agent Copilot.
4. Créez une GitHub App et intégrez-la à votre Copilot skillset
Pour créer une Copilot Extension, il faut créer et configurer une GitHub App, puis l’intégrer à votre Copilot skillset. Consultez Création d’une application GitHub pour votre extension Copilot et Configuration de votre application GitHub pour votre agent Copilot.
5. Modifier la visibilité de votre Copilot skillset
Choisissez l’un des deux niveaux de visibilité pour votre Copilot Extension :
- Publique : tout compte d’utilisateur ou d’organisation disposant du lien vers la page d’installation de l’extension peut l’installer.
- Privée : seul le compte de l’utilisateur ou de l’organisation qui a créé l’extension peut l’installer.
Si vous rendez votre Copilot Extension publique, vous pouvez alors choisir de la référencer sur la GitHub Marketplace.
Pour savoir comment modifier la visibilité de votre Copilot Extension et la référencer sur la GitHub Marketplace, consultez Gestion de la disponibilité de votre extension Copilot.
Étapes suivantes
Pour savoir comment utiliser votre Copilot Extension, consultez Utilisation d’extensions pour intégrer des outils externes à Copilot Chat.