GitHub Copilot SDK

Incorpore fluxos de trabalho de agente do Copilot em qualquer aplicativo usando Python, TypeScript, Go ou .NET.

Visão Geral

O GitHub Copilot SDK expõe o mesmo motor por trás do Copilot CLI: um tempo de execução de agente testado em produção que você pode invocar programaticamente. Não há necessidade de construir sua própria orquestração - você define o comportamento do agente, o Copilot cuida do planejamento, invocação de ferramentas, edições de arquivos e muito mais.

Pré-requisitos

1. Acesso ao GitHub Copilot e um ambiente autenticado
2. Tempo de execução da linguagem: Node.js ^20.19.0 ou >=22.12.0, Python 3.11+, Go 1.24+ ou uma implementação compatível com .NET Standard 2.0
3. Go: GitHub Copilot CLI instalado e autenticado (Guia de instalação)

Os pacotes TypeScript, Python e .NET usam um tempo de execução Copilot empacotado por padrão, portanto, não precisam de uma instalação CLI separada.

Instalação

Node.js/TypeScript

mkdir copilot-demo && cd copilot-demo
npm init -y --init-type module
npm install @github/copilot-sdk tsx

Python

pip install github-copilot-sdk

# Optional: pre-download the bundled runtime instead of downloading it on first use
python -m copilot download-runtime

As rodas Python publicadas incluem uma versão de tempo de execução fixada. O comando pré-download armazena esse tempo de execução localmente em cache; se ignorado, o SDK tenta baixá-lo automaticamente na primeira utilização.

Go

mkdir copilot-demo && cd copilot-demo
go mod init copilot-demo
go get github.com/github/copilot-sdk/go

.NET

dotnet new console -n CopilotDemo && cd CopilotDemo
dotnet add package GitHub.Copilot.SDK

Início Rápido

TypeScript

import { CopilotClient, approveAll } from "@github/copilot-sdk";

const client = new CopilotClient();
const session = await client.createSession({
    onPermissionRequest: approveAll,
    model: "gpt-4.1",
});

const response = await session.sendAndWait({ prompt: "What is 2 + 2?" });
console.log(response?.data.content);

await client.stop();
process.exit(0);

Execute: npx tsx index.ts

Python

import asyncio
from copilot import CopilotClient, PermissionHandler

async def main():
    async with CopilotClient() as client:
        async with await client.create_session(
            on_permission_request=PermissionHandler.approve_all,
            model="gpt-4.1",
        ) as session:
            response = await session.send_and_wait("What is 2 + 2?")
            print(response.data.content)

asyncio.run(main())

Go

package main

import (
    "fmt"
    "log"
    "os"
    copilot "github.com/github/copilot-sdk/go"
)

func main() {
    client := copilot.NewClient(nil)
    if err := client.Start(); err != nil {
        log.Fatal(err)
    }
    defer client.Stop()

    session, err := client.CreateSession(&copilot.SessionConfig{
        OnPermissionRequest: copilot.PermissionHandler.ApproveAll,
        Model:               "gpt-4.1",
    })
    if err != nil {
        log.Fatal(err)
    }

    response, err := session.SendAndWait(copilot.MessageOptions{Prompt: "What is 2 + 2?"}, 0)
    if err != nil {
        log.Fatal(err)
    }

    fmt.Println(*response.Data.Content)
    os.Exit(0)
}

.NET (C#)

using GitHub.Copilot.SDK;

await using var client = new CopilotClient();
await using var session = await client.CreateSessionAsync(new SessionConfig
{
    OnPermissionRequest = PermissionHandler.ApproveAll,
    Model = "gpt-4.1",
});

var response = await session.SendAndWaitAsync(new MessageOptions { Prompt = "What is 2 + 2?" });
Console.WriteLine(response?.Data.Content);

Execute: dotnet run

Respostas em Streaming

Ative a saída em tempo real para uma melhor experiência do usuário:

TypeScript

import { CopilotClient, approveAll, SessionEvent } from "@github/copilot-sdk";

const client = new CopilotClient();
const session = await client.createSession({
    onPermissionRequest: approveAll,
    model: "gpt-4.1",
    streaming: true,
});

session.on((event: SessionEvent) => {
    if (event.type === "assistant.message_delta") {
        process.stdout.write(event.data.deltaContent);
    }
    if (event.type === "session.idle") {
        console.log(); // New line when done
    }
});

await session.sendAndWait({ prompt: "Tell me a short joke" });

await client.stop();
process.exit(0);

Python

import asyncio
import sys
from copilot import CopilotClient, PermissionHandler

…