Cet article est conçu pour vous aider à générer une nouvelle Extension GitHub Copilot. Pour apprendre à générer et tester rapidement une version de démonstration Extension Copilot 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 Plateforme d’extensibilité Copilot. 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 Agents Copilot
Agents Copilot contient le code personnalisé pour votre Extension Copilot, et s’intègre à une GitHub App pour former la Extension Copilot elle-même. Pour plus d’informations, consultez « À propos des agents Copilot ».
Pour réussir à générer un Agent Copilot, 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 Agents Copilot et le Kit de développement logiciel (SDK) Extensions Copilot
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 Extensions Copilot 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 Agent Copilot
En utilisant le matériel de référence des étapes précédentes, planifiez et générez votre Agent Copilot. 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 Agent Copilot
Pour rendre votre Agent Copilot 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 Agent Copilot
Pour créer une Extension Copilot, il faut créer et configurer une GitHub App, puis l’intégrer à votre Agent Copilot. 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 Extension Copilot
Choisissez l’un des deux niveaux de visibilité pour votre Extension Copilot :
- 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 Extension Copilot publique, vous pouvez alors choisir de la référencer sur la GitHub Marketplace.
Pour savoir comment modifier la visibilité de votre Extension Copilot 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 Extension Copilot, consultez Utilisation d’extensions pour intégrer des outils externes à Copilot Chat.
1. A propos de Ensembles de compétences Github Copilot
Ensembles de compétences Github Copilot contient le code personnalisé pour votre Extension Copilot, et s’intègre à une GitHub App pour former la Extension Copilot elle-même.
Contrairement à Agents Copilot, Ensembles de compétences Copilot 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 Ensemble de compétences Copilot
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 Ensemble de compétences Copilot
Pour rendre votre Ensemble de compétences Copilot 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 Ensemble de compétences Copilot
Pour créer une Extension Copilot, il faut créer et configurer une GitHub App, puis l’intégrer à votre Ensemble de compétences Copilot. 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 Ensemble de compétences Copilot
Choisissez l’un des deux niveaux de visibilité pour votre Extension Copilot :
- 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 Extension Copilot publique, vous pouvez alors choisir de la référencer sur la GitHub Marketplace.
Pour savoir comment modifier la visibilité de votre Extension Copilot 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 Extension Copilot, consultez Utilisation d’extensions pour intégrer des outils externes à Copilot Chat.