Note
As GitHub Copilot Extensions estão em versão prévia pública e sujeitas a alterações.
Sobre as GitHub Copilot Extensions
As GitHub Copilot Extensions são um tipo de GitHub App que integra o poder de ferramentas externas ao GitHub Copilot Chat. As Copilot Extensions podem ser desenvolvidas por qualquer pessoa, para uso privado ou público, e podem ser compartilhadas com outras pessoas via GitHub Marketplace.
Note
As GitHub Copilot Extensions não são iguais à extensão do GitHub Copilot que você instala em seu IDE para usar funcionalidade padrão do Copilot, como auto-completar código e GitHub Copilot Chat. Para obter mais informações sobre a extensão do GitHub Copilot, confira Obtendo sugestões de código em seu IDE com o GitHub Copilot.
Você pode começar a usar as Copilot Extensions de uma de duas maneiras:
- Crie sua própria Copilot Extension. Confira Sobre a construção de extensões do Copilot.
- Instale uma Copilot Extension via GitHub Marketplace.
Você pode interagir com sua extensão personalizada ou instalada em uma conversa no Copilot Chat, fazendo perguntas e executando ações que combinam os recursos da ferramenta externa e do GitHub. Por exemplo, se você instalar a extensão do Sentry para GitHub Copilot, poderá usar a extensão para obter informações sobre problemas do Sentry e, em seguida, criar e atribuir problemas de controle relacionados no GitHub.
As Copilot Extensions oferecem vários benefícios, incluindo:
- Interação com ferramentas externas usando linguagem natural
- Alternância de contexto reduzida
- Personalização da experiência com o Copilot Chat para o fluxo do desenvolvedor
As Copilot Extensions estão incluídas em todas as assinaturas do Copilot.
Clientes e IDEs compatíveis
| Clientes e IDEs | Suporte para GitHub Copilot Extensions |
|---|---|
| Visual Studio Code | |
| Visual Studio. | |
| GitHub.com | |
| GitHub Mobile | |
| IDEs JetBrains | |
| GitHub Codespaces | |
| Vim/Neovim | |
| Copilot in the CLI | |
| Xcode |
Sobre a passagem de contexto em GitHub Copilot Extensions
Note
A passagem de contexto está em versão prévia pública e está sujeita a alterações.
O GitHub Copilot Extensions pode acessar determinadas informações contextuais dependendo de onde você o está usando. Essa passagem de contexto ocorre automaticamente quando você interage com uma extensão, mas requer sua autorização explícita por meio de permissões do GitHub App para uso em repositórios de propriedade da organização.
A passagem de contexto ajuda as extensões a entender seu ambiente de trabalho atual para fornecer assistência mais relevante, enquanto mantém a segurança por meio de controles de permissão. A passagem de contexto também respeita exclusões de conteúdo, arquivos .env e arquivos listados em suas configurações de exclusão de conteúdo.
A tabela a seguir mostra os contextos passados para GitHub Copilot Extensions com base no cliente ou no IDE que você está usando.
| Cliente ou IDE | client.file | client.selection | github.repository | github.current-url | Contextos adicionais |
|---|---|---|---|---|---|
| Visual Studio Code | Sim | Sim | Sim | Não | Proprietário do repositório e branch |
| Visual Studio. | Sim | Sim | Sim | Não | Proprietário do repositório e branch |
| GitHub.com | Não | No | Sim | Sim | Informações do repositório e outros recursos do GitHub |
| GitHub Mobile | Não | No | No | Sim | Não aplicável |
| IDEs JetBrains | Não | No | No | Sim | Não aplicável |
Pré-requisitos
Se você tiver uma assinatura do Copilot Individual, será necessário instalar uma Copilot Extension para usar a extensão no Copilot Chat. Confira Estender os recursos do GitHub Copilot na sua conta pessoal.
Se você tiver acesso ao Copilot por meio de uma assinatura do Copilot Business ou do Copilot Enterprise:
- O proprietário de uma organização ou empresa precisa habilitar a política do Copilot Extensions para sua organização ou empresa. Confira Gerenciar políticas do Copilot na sua organização e Gerenciando políticas e recursos do Copilot em sua empresa na documentação do GitHub Enterprise Cloud.
- O proprietário de uma organização precisa instalar o Copilot Extensions para sua organização. Confira Estender os recursos do GitHub Copilot na sua organização.
Usar GitHub Copilot Extensions
-
Para começar a usar um Copilot Extension, abra uma interface Copilot Chat com suporte. Confira Clientes e IDEs com suporte.
-
Para ver uma lista de todas as Copilot Extensions disponíveis na sua conversação do Copilot Chat, na caixa de texto do Copilot Chat, digite
@.Note
Se você estiver usando o Copilot Chat em um IDE e você ou o proprietário da sua organização instalar uma Copilot Extension enquanto o IDE estiver aberto, será necessário reiniciar o IDE para começar a usar a Copilot Extension.
-
Na lista de Copilot Extensions disponíveis, clique na que você deseja usar.
-
Para começar a interagir com a Copilot Extension, na caixa de texto do Copilot Chat, peça à extensão para responder a uma pergunta ou executar uma ação e pressione Enter. Para cada nova solicitação, certifique-se de incluir
@EXTENSION-NAMEno início da sua frase.- Se você mesmo não instalou a Copilot Extension e é a primeira vez que usa a Copilot Extension, você deverá autorizar a extensão. Confira Autorizando aplicativos GitHub.
- Se você pedir a uma Copilot Extension para executar uma ação, será necessário confirmar se a extensão tem sua permissão para agir em seu nome antes de concluir a tarefa. Depois de analisar cuidadosamente a ação proposta, na caixa de diálogo de confirmação, clique em Permitir ou Ignorar.
Dicas para usar GitHub Copilot Extensions
-
Quando você estiver usando uma Copilot Extension, considere como você interagiria com a ferramenta fora do Copilot Chat e, em seguida, use linguagem natural para fazer perguntas e atribuir tarefas que integrem os recursos da ferramenta com o GitHub. Por exemplo, o Sentry é um software de monitoramento de aplicativos com uma Copilot Extension. A seguir estão alguns prompts de exemplo para a extensão do Sentry para GitHub Copilot:
@sentry list my most recent issues@sentry tell me more about issue ISSUE-ID-OR-ISSUE-LINK@sentry create a GitHub issue for the most recent Sentry issue and assign it to @DEVELOPER
Para obter informações sobre as melhores maneiras de usar uma Copilot Extension específica, leia a descrição da extensão em GitHub Marketplace.
-
As interações com uma Copilot Extension nunca serão compartilhadas com outra Copilot Extension. Para interagir com diferentes Copilot Extensions em um IDE, altere o
@EXTENSION-NAMEno início de cada frase. As interações com extensões diferentes aparecerão na mesma janela do Copilot Chat, mas as conversas em si serão separadas automaticamente.Para interagir com diferentes Copilot Extensions em GitHub.com, você precisa iniciar uma nova conversa para cada extensão clicando em na parte superior da janela do Copilot Chat.
Recursos adicionais
Para perguntas e problemas relacionados a GitHub Copilot Extensions, use os seguintes recursos:
- Problemas gerais para usuários e construtores: visite o Portal de Suporte do GitHub.
- Solicitações ou feedback para GitHub: use o tópico de discussão GitHub da comunidade.
- Solicitações ou feedback para fornecedores de extensões de terceiros: registre um problema no repositório de comentários do usuário e adicione um rótulo com o nome do campo de dados dinâmico da extensão.
- Parceiros de tecnologia do GitHub: entre em contato com a equipe de parcerias diretamente por email.
- Copilot-enabled Visual Studio Code extensions: para obter mais informações sobre esse tipo de Copilot Extension, consulte Extensões de chat na documentação do Visual Studio Code.
Note
O Suporte do GitHub não pode responder a perguntas sobre Copilot-enabled Visual Studio Code extensions, pois este caminho de implementação pertence e é mantida pela equipe do VS Code.