Usando extensões para integrar ferramentas externas ao Copilot Chat

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.

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
GitHub Codespaces
IDEs JetBrains
Vim/Neovim
Copilot in the CLI
Xcode

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:

1. O proprietário de uma organização ou empresa precisa habilitar a política do Copilot Extensions para sua organização ou empresa. Consulte "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.
2. 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

1. Para começar a usar um Copilot Extension, abra uma interface Copilot Chat com suporte. Consulte ‘’Clientes e IDEs com suporte.’’

2. 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.

3. Na lista de Copilot Extensions disponíveis, clique na que você deseja usar.

4. 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-NAME no 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-NAME no 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.

Leitura adicional

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