Skip to main content

Sobre a construção de extensões do Copilot

Saiba mais sobre o processo de desenvolvimento para Copilot Extensions.

Note

As GitHub Copilot Extensions estão em versão prévia pública e sujeitas a alterações.

Sobre as Copilot Extensions

Copilot Extensions são integrações que expandem a funcionalidade do Copilot Chat, permitindo que os desenvolvedores tragam ferramentas, serviços e comportamentos personalizados externos para a experiência do Chat. Você pode usar Copilot Extensions para estender os recursos do Copilot Chat de várias maneiras, entre elas:

  • Consulta de documentação: uma Copilot Extension pode permitir que o Copilot Chat consulte um serviço de documentação de terceiros para encontrar informações sobre um tópico específico.
  • Codificação assistida por IA: uma Copilot Extension pode usar um modelo de IA de terceiros para fornecer sugestões de código.
  • Recuperação de dados: uma Copilot Extension pode permitir que o Copilot Chat consulte um serviço de dados de terceiros para recuperar informações sobre um tópico específico.
  • Execução da ação: uma Copilot Extension pode permitir que o Copilot Chat execute uma ação específica, como postar em um quadro de mensagens ou atualizar um item de rastreamento em um sistema externo.

Sobre a criação de GitHub Copilot Extensions

GitHub Copilot Extensions são um tipo de Copilot Extension construídas com GitHub Apps. GitHub Copilot Extensions são mais adequadas para desenvolvedores que desejam compatibilidade entre plataformas, bem como gerenciamento de aplicativos e o suporte do GitHub.

Clientes e IDEs compatíveis

Clientes e IDEsSuporte para GitHub Copilot Extensions
Visual Studio Code
Visual Studio.
GitHub.com
GitHub Mobile
IDEs JetBrains
Vim/Neovim
Copilot in the CLI
Xcode

Sobre a visibilidade de GitHub Copilot Extensions

As GitHub Copilot Extensions podem ser privadas, públicas e compartilháveis ou públicas e listadas no GitHub Marketplace. A opção de visibilidade escolhida dependerá do seu caso de uso e do público-alvo que você está segmentando.

  • As extensões privadas são frequentemente preferidas por grandes empresas ou empresas que:
    • Desejam ter mais personalização e controles sobre o acesso aos dados
    • Precisam de integração com um grande volume de documentos e bancos de dados internos
    • Têm políticas de segurança rígidas, o que dificulta autorizar permissões para terceiros
  • As extensões públicas são adequadas para:
    • Projetos de software livre
    • Desenvolvimento colaborativo e uso entre organizações dentro de uma empresa
    • Compartilhar sua ferramenta e obter feedback antes de publicar no GitHub Marketplace
  • As extensões do GitHub Marketplace são ideais para terceiros que desejam:
    • Oferecer serviços a um público mais amplo
    • Integrar suas ferramentas ao fluxo de trabalho do desenvolvedor na GitHub e no IDE
    • Aproveite o ecossistema da GitHub para aumentar a conscientização sobre seu produto

Recursos para a criação de GitHub Copilot Extensions

A GitHub fornece um kit de ferramentas abrangente para construtores de extensões, com exemplos de código, uma ferramenta de depuração para CLI, SDKs de início rápido e um repositório de feedback do usuário. Para obter mais informações, consulte a organização copilot-extensions na GitHub.

Antes de criar sua própria GitHub Copilot Extension do zero, você pode explorar um Copilot agent existente e integrá-lo a um GitHub App para ver como funciona. O GitHub fornece alguns exemplos de Copilot agents que você pode clonar e usar como base para sua própria GitHub Copilot Extension:

  • Blackbeard: um Copilot agent simples que responde a solicitações como um pirata, usando a API de LLM do Copilot e prompts especiais do sistema. É um bom ponto de partida para aprender a construir sua GitHub Copilot Extension. Para obter mais informações, consulte a Copilot Extension Blackbeard.

  • GitHub Models: um Copilot agent mais complexo que permite perguntar e interagir com vários LLMs listados no GitHub Marketplace usando o Copilot Chat. Para obter mais informações. consulte a Copilot Extension GitHub Models.

    Note

    GitHub Models estão em versão prévia pública e sujeitos a alterações. Para solicitar acesso, entre para a lista de espera.

  • Chamada de função: um agente de exemplo escrito em Go que demonstra chamadas de funções caixas de diálogo de confirmação. Para obter mais informações, consulte a extensão de chamadas de funções.

  • Extensão RAG: um agente de exemplo escrito em Go que demonstra uma implementação simples de geração aumentada de recuperação. Para obter mais informações, consulte Extensão RAG.

  • SDK de preview: um SDK que simplifica o processo de construção de GitHub Copilot Extensions manipulando a verificação de solicitação, a formatação de resposta e as interações de API. Ele permite que os construtores se concentrem na funcionalidade principal da extensão, em vez de em clichês, simplificando a integração de ferramentas, APIs e fontes de dados no Copilot Chat. Para obter mais informações, consulte SDK de preview.

Sobre a criação de Copilot-enabled Visual Studio Code extensions

Note

A documentação do GitHub se concentra na criação de GitHub Copilot Extensions, e não de Copilot-enabled Visual Studio Code extensions.

Você pode criar uma Copilot Extension exclusiva e nativa para o Visual Studio Code, chamada de Copilot-enabled Visual Studio Code extensions. Essa opção é mais adequada para desenvolvedores que desejam criar extensões que usam funcionalidades e APIs específicas do VS Code, ou ainda para aqueles que desejam estender extensões existentes do VS Code.

Também conhecidas como extensões de Chat do VS Code, as Copilot-enabled Visual Studio Code extensions funcionam de maneira semelhante às GitHub Copilot Extensions, estendendo os recursos do Copilot Chat, mas com algumas diferenças dignas de nota:

  • As extensões de Chat do VS Code só podem ser usadas no VS Code.
  • As extensões de Chat do VS Code têm mais acesso aos recursos e às APIs do VS Code, permitindo mais interações específicas do editor, como acesso a dados do espaço de trabalho local, manipulação da interface do Visual Studio Code e acesso de leitura/gravação a arquivos locais.
  • As extensões de Chat doVS Code são publicadas no VS Code Marketplace, e não no GitHub Marketplace.
  • As extensões de Chat do VS Code são locais na máquina do usuário e não podem ser controladas pelas políticas de uma organização ou empresa.

Para obter mais informações sobre Copilot-enabled Visual Studio Code extensions, consulte extensões de Chat, na documentação do Visual Studio Code.

Leitura adicional