Integra el SDK de GitHub Copilot en tus aplicaciones – Guía rápida

Introducción

GitHub Copilot es más que un simple complemento para IDE; es un agente de IA que puede escribir, refactorizar e incluso ejecutar código. El SDK oficial de Copilot expone ese agente detrás de una API simple y sin dependencias de idioma, de modo que puedas integrarlo en cualquier aplicación: web, escritorio, CLI o microservicio.

¿Por qué usar el SDK de Copilot?

• Ejecutar Copilot dentro de tu propio producto sin navegador.
• Desencadenar generación de código desde tu propia interfaz de usuario.
• Construir cadenas de herramientas complejas que combinen Copilot con otros servicios.
• Obtener un único punto de facturación y uso a través del CLI de Copilot.

Idiomas compatibles e instalaciones

El SDK está disponible en Python, Node.js/TypeScript, Go, y .NET (C#). La instalación es una línea única por lenguaje:

# 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

Tip: El SDK incluye el CLI de Copilot como proceso de fondo. Asegúrate de tener una suscripción activa a GitHub Copilot; el CLI de nivel gratuito está disponible pero es limitado.

Ejemplo básico – Agente “Hola Mundo”

from github.copilot import Copilot

copilot = Copilot()

# Crea un agente sencillo que escribe un saludo
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)

Ejecutar python hello_agent.py imprimirá una función completa def greet():.

Trabajando con sesiones infinitas

A partir de la versión v0.1.18, el SDK soporta sesiones infinitas que permiten mantener el mismo contexto activo en múltiples prompts. Actívalo pasando infinite=True al crear el agente:

agent = copilot.agent(
    name="session-agent",
    infinite=True,
)

Herramientas y habilidades personalizadas

Puedes ampliar Copilot con tus propias herramientas de línea de comandos. Define una Skill:

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],
});

Seguridad y BYOK

El SDK soporta Bring‑Your‑Own‑Key (BYOK) para datos cifrados en tránsito. Configura tu clave mediante:

COPILOT_BK_SECRET=<your‑hex‑key>

Preguntas frecuentes

• ¿Necesito una suscripción de pago? – Sí, para uso en producción. El nivel gratuito de CLI está disponible pero con límites de tasa.
• ¿Está listo para producción? – El SDK está en Technical Preview. Espera cambios menores antes de la GA.
• ¿Puedo cambiar el modelo subyacente? – El SDK expone un método para listar modelos disponibles; puedes pasar el nombre del modelo en agent.run.

Recursos para empezar

• Página GitHub del SDK Copilot – Documentación y ejemplos completos.
• Docs del CLI Copilot – Instalación y configuración.
• Referencia API del SDK – Documentación específica por lenguaje.

Conclusión

El SDK de GitHub Copilot abre un mundo donde los flujos de escritura AI se convierten en ciudadanos de primera clase dentro de tus propios productos. Con unas pocas líneas puedes lanzar un agente, personalizarlo con habilidades a medida, y comenzar a generar, refactorizar y hasta ejecutar código, todo mientras aprovechas el modelo de facturación seguro de GitHub.

¡Feliz codificación!