Intégrez le SDK GitHub Copilot dans vos applications – Guide rapide
Introduction
GitHub Copilot est plus qu'un simple plugin d'IDE ; c'est un agent IA capable d'écrire, refactoriser et même exécuter du code. Le SDK officiel de Copilot expose cet agent derrière une API simple et sans langue spécifique, vous permettant de l'intégrer à n'importe quelle application — web, bureau, CLI ou microservice.
Pourquoi utiliser le SDK Copilot ?
- Démarrer Copilot à l'intérieur de votre propre produit sans navigateur.
- Déclencher la génération de code depuis votre propre interface utilisateur.
- Construire des chaînes d'outils complexes combinant Copilot avec d'autres services.
- Obtenir un point unique de facturation et d’utilisation via le CLI Copilot.
Langues prises en charge et installations
Le SDK est disponible en Python, Node.js/TypeScript, Go et .NET (C#). L'installation se fait en une seule ligne par langage :
# Node.js / TypeScript
npm install @github/copilot-sdk
# Python
pip install github-copilot-sdk
# Go
go get github.com/github/copilot-sdk/go
# .NET
dotnet add package GitHub.Copilot.SDK
Astuce : Le SDK regroupe le CLI Copilot en tant que processus en arrière‑plan. Assurez‑vous d'avoir un abonnement actif à GitHub Copilot — la version gratuite du CLI est disponible mais limitée.
Exemple de base – Agent « Hello World »
from github.copilot import Copilot
copilot = Copilot()
# Créez un agent simple qui écrit un salut
agent = copilot.agent(
name="greeting-agent",
description="Generate a friendly greeting in the target language.",
)
response = agent.run("create a greeting function that outputs 'Hello, world!' in Python.")
print(response.content)
Lancer python hello_agent.py affiche une fonction entièrement formée def greet():.
Travailler avec des sessions infinies
À partir de la version v0.1.18, le SDK prend en charge les sessions infinies, vous permettant de conserver le même contexte entre plusieurs invites. Activez-la en passant infinite=True lors de la création de l'agent :
agent = copilot.agent(
name="session-agent",
infinite=True,
)
agent.run() verra le fil de conversation, ce qui le rend idéal pour des assistants de type chat.
Outils et compétences personnalisés
Vous pouvez enrichir Copilot avec vos propres outils en ligne de commande. Définissez une Compétence :
import { Copilot, Skill } from "@github/copilot-sdk";
const skill = new Skill({
name: "json‑pretty",
command: "python -m json.tool",
description: "Pretty‑prints JSON data.",
});
const copilot = new Copilot({
tools: [skill],
});
json‑pretty pendant le raisonnement.
Sécurité et BYOK
Le SDK prend en charge le Bring‑Your‑Own‑Key (BYOK) pour les données chiffrées en transit. Configurez votre clé via :
COPILOT_BK_SECRET=<your‑hex‑key>
FAQ
- Ai-je besoin d'un abonnement payant ? — Oui, pour un usage en production. La tier gratuite du CLI est disponible mais limitée en fréquence.
- Est‑ce prêt pour la production ? — Le SDK est en Prévisualisation technique. Prévoyez de légères modifications avant la version GA.
- Puis-je changer le modèle sous‑jacente ? — Le SDK expose une méthode pour lister les modèles disponibles ; vous pouvez passer le nom du modèle dans
agent.run.
Ressources de démarrage
- Page GitHub du SDK Copilot — Documentation complète et exemples.
- Docs du CLI Copilot — Installation et configuration.
- Référence API du SDK — Documentation spécifique à chaque langage.
Conclusion
Le SDK GitHub Copilot ouvre un univers où les flux d’écriture IA deviennent des citoyens de première classe au sein de vos propres produits. En quelques lignes, vous pouvez lancer un agent, l’adapter avec des compétences personnalisées et commencer à générer, refactoriser, voire exécuter du code, tout en profitant du modèle de facturation sécurisée de GitHub.
Bonne programmation !