Introdução às Extensões do GitHub Copilot

As Extensões do GitHub Copilot transformam a forma como os desenvolvedores trabalham ao trazer ferramentas e serviços externos diretamente para o Copilot Chat. Em vez de alternar entre múltiplas aplicações, agora você pode consultar bancos de dados, monitorar deployments e depurar erros—tudo através de conversas em linguagem natural dentro do seu IDE ou no GitHub.com.

O Que São as Extensões do GitHub Copilot?

Essas extensões se integram perfeitamente ao seu fluxo de trabalho existente. Ao depurar um problema, você pode invocar o Sentry para monitoramento de erros, DataStax para consultas de banco de dados, ou Azure para deployment—tudo sem sair do seu editor de código. Grandes parceiros como Docker, MongoDB, Stripe e Microsoft já construíram extensões disponíveis no GitHub Marketplace.

Importante: Cronograma de Descontinuação

Datas críticas para lembrar:

• 23 de setembro de 2025: Novas Extensões Copilot baseadas em GitHub App não poderão ser criadas
• 10 de novembro de 2025: Todas as extensões baseadas em GitHub App existentes deixarão de funcionar

As Extensões Copilot do VS Code permanecem não afetadas e continuarão a ser suportadas. Se você está iniciando um novo projeto hoje, considere construir uma extensão do VS Code ou explorar servidores Model Context Protocol (MCP) como a solução de longo prazo.

Instalando Extensões do GitHub Marketplace

Começar com extensões existentes leva apenas alguns minutos:

1. Navegue pelas extensões disponíveis no GitHub Marketplace
2. Clique em “Install” na extensão escolhida
3. Conceda as permissões necessárias
4. Acesse a extensão digitando @ no Copilot Chat, seguido do nome da extensão

Por exemplo, digitar @sentry permite analisar logs de erro, enquanto @docker ajuda você a construir e fazer deploy de containers—tudo através de comandos em linguagem natural.

Construindo uma Extensão Hello World

Vamos criar uma Extensão Hello World mínima para entender os conceitos centrais. Este exemplo usa Node.js e o Copilot Extensions Preview SDK.

Passo 1: Configure Seu Endpoint

import { verifyAndParseRequest, createTextEvent, createDoneEvent } from "@copilot-extensions/preview-sdk";
import express from 'express';

const app = express();
app.use(express.text());

app.post("/", async (req, res) => {
  // Verify the request is from GitHub
  const signature = req.headers["github-public-key-signature"];
  const keyID = req.headers["github-public-key-identifier"];
  const token = req.headers["x-github-token"];
  
  const { isValidRequest, payload } = await verifyAndParseRequest(
    req.body,
    signature,
    keyID,
    { token }
  );
  
  if (!isValidRequest) {
    return res.status(401).send("Unauthorized");
  }
  
  // Send response using server-sent events
  res.setHeader("Content-Type", "text/event-stream");
  
  // Simple Hello World response
  res.write(createTextEvent("Hello from my Copilot Extension! 👋"));
  res.write(createDoneEvent());
  res.end();
});

app.listen(3000);

Passo 2: Configure Seu GitHub App

1. Navegue até Settings → Developer settings → GitHub Apps
2. Crie um novo GitHub App com estas configurações:
   • Webhook URL: O endpoint do seu servidor (use ngrok para testes locais)
   • Permissions: Defina “Copilot Chat” como somente leitura
   • Copilot settings: Defina App Type como “Agent”

Passo 3: Teste Sua Extensão

Uma vez instalada, teste sua extensão no Copilot Chat:

• No GitHub.com
• No VS Code
• No Visual Studio

Digite @your-extension-name seguido de qualquer mensagem. Você verá sua resposta “Hello World” aparecer no chat.

Conceitos-Chave para Lembrar

Verificação de Requisição: Sempre verifique as requisições recebidas usando a função verifyAndParseRequest do SDK. Isso garante que as requisições realmente vêm do GitHub.

Server-Sent Events: As Extensões Copilot usam SSE para streaming de respostas. Isso permite atualizações progressivas em tempo real na interface do chat.

Gerenciamento de Token: O cabeçalho x-github-token fornece contexto do usuário. Use-o com Octokit para acessar APIs do GitHub em nome do usuário.

Próximos Passos

Comece explorando extensões existentes no GitHub Marketplace para entender padrões comuns e casos de uso. Para extensões de produção, considere:

• Implementar tratamento adequado de erros
• Adicionar chamadas de função para operações complexas
• Integrar com as APIs internas da sua organização
• Usar a API LLM do Copilot para respostas inteligentes

Dado o cronograma de descontinuação, as Extensões Copilot do VS Code oferecem o caminho mais à prova de futuro para novos desenvolvimentos. O ecossistema continua evoluindo rapidamente, com servidores MCP emergindo como a próxima geração de arquitetura de extensões.

Conclusão

Seja instalando extensões de parceiros ou construindo integrações personalizadas, as Extensões do GitHub Copilot mudam fundamentalmente como os desenvolvedores interagem com suas ferramentas—mantendo você em fluxo e produtivo sem troca de contexto. Com a descontinuação iminente das extensões baseadas em GitHub App, agora é o momento de explorar extensões do VS Code ou servidores MCP para soluções de longo prazo.

Perguntas Frequentes

Understand every bug

Uncover frustrations, understand bugs and fix slowdowns like never before with OpenReplay — the open-source session replay tool for developers. Self-host it in minutes, and have complete control over your customer data. Check our GitHub repo and join the thousands of developers in our community.