Usar o GitHub Copilot Chat no GitHub.com

Visão geral

O GitHub Copilot Chat in GitHub.com é uma interface de chat que permite que você faça e receba respostas a perguntas relacionadas à codificação no GitHub.com.

O Copilot Chat pode ajudar com uma variedade de tarefas relacionadas à codificação, como oferecer sugestões de código, fornecer descrições de linguagem natural da funcionalidade e finalidade de um código, gerar testes de unidade para o código e propor correções de bugs no código. Para obter mais informações, confira "Sobre o GitHub Copilot Chat no GitHub.com".

No GitHub.com, você pode usar o Copilot Chat para fazer:

• Perguntas gerais relacionadas a software, sem um contexto específico. Para obter mais informações, confira "Fazer uma pergunta geral sobre desenvolvimento de software".
• Perguntas exploratórias feitas no contexto de um repositório específico. Para obter mais informações, consulte "Fazendo perguntas exploratórias sobre um repositório".
• Perguntas feitas no contexto de um repositório, arquivo ou símbolo específico. Para obter mais informações, consulte "Fazendo uma pergunta sobre um arquivo ou símbolo específico".
• Perguntas feitas no contexto de uma base de informações (ou seja, documentação de Markdown em um ou mais repositórios). Para obter mais informações, consulte "Fazendo uma pergunta sobre uma base de informações".
• Perguntas sobre um arquivo específico ou linhas de código especificadas em um arquivo. Para obter mais informações, confira "Fazer perguntas sobre partes de código específicas".
• Perguntas sobre uma comparação de pull requests. Para obter mais informações, consulte "Como descobrir as alterações em uma pull request."

Limitações

• As respostas do chat poderão ficar abaixo do ideal se você perguntar a respeito de um repositório específico selecionado como contexto e o repositório não tiver sido indexado para pesquisa de código semântica. Qualquer pessoa que obtenha acesso ao Copilot da organização proprietária de um repositório pode indexar esse repositório. Para obter mais informações, consulte "Fazendo uma pergunta sobre um repositório, arquivo ou símbolo específico".
• A qualidade dos resultados do Copilot Chat poderá, em algumas situações, ser reduzida se arquivos muito grandes, ou um grande número de arquivos, forem usados como contexto para uma pergunta.

Pré-requisitos

• Para usar o GitHub Copilot Chat, você precisa ter uma assinatura ativa do GitHub Copilot. Para obter mais informações, confira "Sobre a cobrança para o GitHub Copilot".
• Para usar o GitHub Copilot Chat in GitHub.com, você deve ter recebido acesso ao GitHub Copilot Chat como parte do GitHub Copilot Enterprise. Para obter mais informações, confira "Habilitando recursos do GitHub Copilot Enterprise".

Impulsionado por habilidades

Indo mais longe, Copilot é alimentado por uma coleção de habilidades que são selecionadas de forma dinâmica com base na pergunta que você faz. Você pode saber qual habilidade foi selecionada por Copilot com base nas atualizações de status na janela de chat.

Você também pode pedir explicitamente GitHub Copilot Chat in GitHub.com para usar uma habilidade específica, por exemplo, Use the Bing skill to find the latest GPT4 model from OpenAI.

Competências disponíveis atualmente

Habilidade	Descrição	Habilitado por padrão?	Pergunta de exemplo
codesearch	Pesquisa de código de linguagem natural no branch padrão do repositório Git. Essa habilidade é útil quando você deseja saber onde ou como determinada funcionalidade foi implementada no código. Observação: isso exige que a indexação esteja ativada para o repositório (consulte a observação sobre a indexação abaixo).	Sim	Onde está a lógica que controla o gerenciamento da sessão do usuário e como ele funciona?
show-symbol-definition	Recupera as linhas de código que definem um símbolo de código específico (função, classe ou struct) no branch padrão do repositório Git. Essa habilidade é útil quando você tem o nome exato de um símbolo e quer entendê-lo.	Sim	Gravar testes de unidade para o método AuthUser
pathsearch	Recupera um arquivo específico no branch padrão do repositório Git. Essa habilidade é útil quando você fornece o caminho exato de um arquivo no repositório.	Sim	Que lógica user_auth.js encapsula?
bing-search	Pesquisa na Web usando o mecanismo de pesquisa do Bing. Essa habilidade é útil para ensinar o Copilot sobre eventos recentes, novos desenvolvimentos, tendências, tecnologias ou assuntos extremamente específicos, detalhados ou de nicho.	Não (requer aprovação do administrador; consulte "Habilitando recursos do GitHub Copilot Enterprise")	Quais são alguns artigos recentes sobre a proteção de tokens SAT contra vulnerabilidades no Node?

Fazer uma pergunta geral sobre desenvolvimento de software

Você pode fazer uma pergunta geral sobre desenvolvimento de software que não esteja focada em um contexto específico, como um repositório ou uma base de informações.

Dependendo da pergunta que você fizer e das configurações da organização e da empresa, o Copilot poderá responder usando informações baseadas nos resultados de uma pesquisa do Bing. Usando a pesquisa do Bing, o Copilot pode responder a uma ampla gama de perguntas relacionadas à tecnologia com detalhes atualizados com base nas informações atualmente disponíveis na Internet. Para obter informações sobre como habilitar ou desabilitar a integração de pesquisa do Bing, consulte "Como impor políticas do GitHub Copilot em sua empresa".

1. Em qualquer página do GitHub.com, clique no ícone GitHub Copilot na parte superior direita da página.

   O painel GitHub Copilot Chat é exibido. Para redimensionar o painel, clique e arraste a borda superior ou esquerda.

2. Se o painel contiver uma conversa anterior que você teve com Copilot, clique no ícone "Nova conversa" (um sinal de mais) no canto superior direito do painel.

   

3. Se o painel estiver intitulado "Conversando sobre PROPRIETÁRIO/REPOSITÓRIO", clique em Todos os repositórios.

   

4. Se a página "Perguntar Copilot" for exibida no painel, clique em Chat de uso geral.

   

5. Na parte inferior do painel, na caixa "Perguntar ao Copilot", digite uma pergunta e pressione Enter.

   Alguns exemplos de perguntas gerais que você pode fazer são:

   • Quais são as vantagens da linguagem de programação Go?
   • O que é desenvolvimento de software Agile?
   • Qual é a estrutura JavaScript mais popular?
   • Dê-me alguns exemplos de expressões regulares.
   • Escreva um script bash para emitir a data de hoje.

6. Se o Copilot usar uma pesquisa do Bing para responder à sua pergunta, "Resultados do Bing" será exibido acima da resposta. Clique aqui para ver os resultados da pesquisa que o Copilot usou para responder à sua pergunta.

7. Dentro de uma conversa, você pode fazer perguntas de acompanhamento. O Copilot responderá dentro do contexto da conversa. Por exemplo, você pode digitar "diga-me mais" para que o Copilot expanda seu último comentário.

   É possível usar sua pergunta inicial como base para perguntas de acompanhamento. Um prompt básico detalhado pode ajudar o Copilot a fornecer respostas mais relevantes para suas perguntas de acompanhamento. Para obter mais informações, confira "Solicitar que o GitHub Copilot Chat se torne seu assistente pessoal de IA para acessibilidade” no blog do GitHub.

8. Para voltar a uma conversa anterior que você teve com o Copilot, clique no ícone "Visualizar conversas" (um relógio com uma seta circular em volta) no canto superior direito do painel.

   

Fazendo perguntas exploratórias sobre um repositório

Copilot permite que você use perguntas em linguagem natural para explorar repositórios em GitHub. Isso pode ajudá-lo a entender melhor onde aspectos específicos de uma base de código são implementados.

1. Em qualquer página do GitHub.com, clique no ícone GitHub Copilot na parte superior direita da página.

   O painel GitHub Copilot Chat é exibido. Para redimensionar o painel, clique e arraste a borda superior ou esquerda.

2. Se o painel contiver uma conversa anterior que você teve com Copilot, clique no ícone "Nova conversa" (um sinal de mais) no canto superior direito do painel.

   

3. Se a página "Perguntar ao Copilot" não for exibida no painel, clique em Todos os repositórios.

   

4. Na página "Perguntar ao Copilot", selecione um repositório para fornecer um contexto para sua pergunta.

   Por exemplo, você pode escolher um repositório cujo código você deseja entender melhor.

   Você pode procurar um repositório se não vir um que deseja usar.

   Observação:

   A capacidade do Copilot de responder a perguntas em linguagem natural como essas em um contexto de repositório é aprimorada quando o repositório tiver sido indexado para pesquisa de código semântica. O status de indexação do repositório é exibido quando você inicia uma conversa que tem um contexto de repositório.

   Se você obtiver acesso ao Copilot da organização proprietária do repositório e o repositório não tiver sido indexado, um botão Indexar NOME DO REPOSITÓRIO será exibido. Clique nesse botão para iniciar o processo de indexação.

   

5. Na caixa "Perguntar ao Copilot", digite uma pergunta e pressione Enter.

   Por exemplo, você pode perguntar:

   • Onde o limite de taxa é implementado em nossa API?
   • Como funciona a classe WidgetFactory?
   • Onde está o código para converter um membro da organização em um colaborador externo?
   • Onde os tokens SAT são gerados?

   O Copilot responde no painel de bat-papo.

6. Para voltar a uma conversa anterior que você teve com o Copilot, clique no ícone "Visualizar conversas" (um relógio com uma seta circular em volta) no canto superior direito do painel.

   

Fazendo uma pergunta sobre um arquivo ou símbolo específico

Você pode perguntar a Copilot sobre um arquivo ou símbolo específico em um repositório.

1. Em qualquer página do GitHub.com, clique no ícone GitHub Copilot na parte superior direita da página.

   O painel GitHub Copilot Chat é exibido. Para redimensionar o painel, clique e arraste a borda superior ou esquerda.

2. Se o painel contiver uma conversa anterior que você teve com Copilot, clique no ícone "Nova conversa" (um sinal de mais) no canto superior direito do painel.

   

3. Se a página "Perguntar ao Copilot" não for exibida no painel, clique em Todos os repositórios.

   

4. Na página "Perguntar ao Copilot", selecione um repositório para fornecer um contexto para sua pergunta.

   Por exemplo, você pode escolher um repositório cujo código você deseja entender melhor.

   Você pode procurar um repositório se não vir um que deseja usar.

5. Clique no botão "Anexar arquivos ou símbolos" (um ícone de clipe de papel) na parte inferior do painel de bate-papo e, em seguida, procure e selecione um ou mais arquivos e símbolos.

   

6. Na caixa "Perguntar ao Copilot", digite uma pergunta e pressione Enter.

   O Copilot responde no painel de bat-papo.

7. Para voltar a uma conversa anterior que você teve com o Copilot, clique no ícone "Visualizar conversas" (um relógio com uma seta circular em volta) no canto superior direito do painel.

   

Fazendo uma pergunta sobre uma base de informações

Os proprietários da organização podem criar bases de dados de conhecimento, agrupando a documentação de Markdown em um ou mais repositórios. Você pode usar uma base de informações para fazer perguntas com esse contexto em mente.

Quando você insere uma consulta, o Copilot procura trechos de documentação relevantes, sintetiza um resumo dos trechos relevantes para responder à sua pergunta e fornece links para a documentação de origem para contexto adicional.

1. Em qualquer página do GitHub.com, clique no ícone GitHub Copilot na parte superior direita da página.

   O painel GitHub Copilot Chat é exibido. Para redimensionar o painel, clique e arraste a borda superior ou esquerda.

2. Se o painel contiver uma conversa anterior que você teve com Copilot, clique no ícone "Nova conversa" (um sinal de mais) no canto superior direito do painel.

   

3. Se a página "Perguntar ao Copilot" não for exibida no painel, clique em Todos os repositórios.

   

4. Inicie uma conversa com o Copilot selecionando um repositório ou clicando em Chat de uso geral.

5. Clique no botão "Anexar conhecimento" (um ícone de livro) na parte inferior do painel de bate-papo, para visualizar uma lista das bases de informações às quais você tem acesso.

   

6. Clique na base de informações que você deseja usar como contexto.

   Por exemplo, você pode escolher uma base de informações contendo a documentação interna do desenvolvedor da sua organização.

   Você pode procurar uma base de informações se não vir uma que deseja usar.

   

7. Na parte inferior da página, na caixa "Perguntar ao Copilot", digite uma pergunta e pressione Enter.

   Por exemplo, se você escolheu uma base de informações com a documentação interna do desenvolvedor da sua organização, poderá perguntar:

   • Como implantar um novo aplicativo?
   • Qual é o processo para criar uma nova API REST?
   • Quais são as nossas melhores práticas para o registro em log?

8. A resposta normalmente conterá referências numeradas a arquivos que o Copilot usou para gerar a resposta, por meio da base de informações que você selecionou. Para listar as fontes que foram usadas, clique em Referências de NÚMERO.

   

9. Para exibir informações sobre uma referência de origem, clique em sua entrada na lista.

   Como alternativa, para abrir o arquivo completo, clique nas reticências (...) e selecione Abrir.

10. Dentro de uma conversa, você pode fazer perguntas de acompanhamento. As perguntas de acompanhamento continuarão a usar a base de informações selecionada como contexto até que você declare explicitamente a base de informações ou selecione uma base de dados diferente.

11. Para voltar a uma conversa anterior que você teve com o Copilot, clique no ícone "Visualizar conversas" (um relógio com uma seta circular em volta) no canto superior direito do painel.

    

Fazer perguntas sobre partes de código específicas

Você pode conversar com o Copilot sobre um arquivo em seu repositório ou sobre linhas de código específicas dentro de um arquivo.

1. No GitHub.com, navegue até um repositório e abra um arquivo.

2. Realize um dos seguintes procedimentos:

   • Para fazer uma pergunta sobre o arquivo inteiro, clique no ícone do Copilot () no canto superior direito da exibição do arquivo.

     

   • Para fazer uma pergunta sobre linhas específicas dentro do arquivo:

     1. Selecione as linhas clicando no número da primeira linha que você deseja selecionar, mantendo pressionada a tecla Shift e clicando no número da última linha que deseja selecionar.
     2. Para fazer sua própria pergunta sobre as linhas selecionadas, clique no ícone do Copilot () à direita da sua seleção. Isso exibe o painel do GitHub Copilot Chat com as linhas selecionadas indicadas como contexto da pergunta.
     3. Para fazer uma pergunta predefinida, clique no botão apontando para baixo, ao lado do ícone do Copilot. Depois, escolha uma das opções.
     

3. Se você tiver clicado no ícone do Copilot, digite uma pergunta na caixa "Pergunte ao Copilot" na parte inferior do painel de chat e pressione Enter.

   Por exemplo, se você estiver perguntando sobre o arquivo inteiro, poderá digitar:

   • Explique este arquivo.
   • Como posso melhorar este código?
   • Como posso testar este script?

   Se você estiver questionando sobre linhas específicas, poderá digitar:

   • Explique a função nas linhas selecionadas.
   • Como eu poderia melhorar essa classe?
   • Adicione tratamento de erros a este código.
   • Escreva um teste de unidade para este método.

   O Copilot responde à sua solicitação no painel.

   

4. Você pode continuar a conversa fazendo uma pergunta de acompanhamento. Por exemplo, você pode digitar "diga-me mais" para que o Copilot expanda seu último comentário.

5. Para limpar, excluir ou renomear a conversa atual ou iniciar uma nova conversa, digite / na caixa "Perguntar ao Copilot", selecione entre as opções exibidas e pressione Enter.

6. Para exibir uma conversa no modo imersivo, exibindo apenas o tópico da conversa, clique no ícone de caixa tracejada no canto superior direito do tópico da conversa.

   

Descobrindo sobre as alterações em uma pull request

Você pode pedir ao Copilot para explicar o que foi alterado em qualquer um dos arquivos em uma pull request.

1. No GitHub.com, navegue até uma pull request em um repositório.

2. Clique na guia Arquivos alterados .

3. Realize um dos seguintes procedimentos:

   • Para fazer uma pergunta sobre um arquivo que está sendo alterado por uma pull request, clique em no canto superior direito do arquivo e clique em Perguntar ao Copilot sobre essa diferença.

   • Para fazer uma pergunta sobre linhas específicas em um arquivo na pull request:

     1. Selecione as linhas clicando no número da primeira linha que você deseja selecionar, mantendo pressionada a tecla Shift e clicando no número da última linha que deseja selecionar.
     2. Para fazer sua própria pergunta sobre as linhas selecionadas, clique no ícone do Copilot () à direita da sua seleção. Isso exibe o painel do GitHub Copilot Chat com as linhas selecionadas indicadas como contexto da pergunta.
     3. Para fazer uma pergunta predefinida, clique no botão que aponta para baixo ao lado do ícone do Copilot e clique em Explicar.

4. Se você clicou no ícone do Copilot ou escolheu Perguntar ao Copilot sobre esse diferencial, digite uma pergunta na caixa "Perguntar ao Copilot" na parte inferior do painel de chat e pressione Enter. Por exemplo, você pode inserir:

   • Por que este módulo foi incluído?
   • O que é `actorData` nesta linha?
   • Explicar este bloco `do..end`.
   • Qual é a finalidade desse arquivo ?

Acessando o Copilot Chat a partir da barra de pesquisa

Você pode fazer uma pergunta ao Copilot sobre um repositório inteiro digitando sua pergunta na caixa de pesquisa principal do repositório.

1. Navegue até um repositório no GitHub.com.

2. Pressione / ou clique na caixa de pesquisa principal na parte superior da página.

3. Na caixa de pesquisa, depois de repo:OWNER/REPO, digite a pergunta que você deseja fazer ao Copilot.

   Por exemplo, você pode inserir:

   • O que esse repositório faz?
   • Onde a autenticação é implementada nesta base de código?
   • Como funciona a detecção de arquivos de licença neste repositório?

4. Clique em Perguntar ao Copilot.

   

   O painel do GitHub Copilot Chat é exibido e o Copilot responde à sua solicitação.

Compartilhar feedback sobre o GitHub Copilot Chat in GitHub.com

Para deixar comentários feedback sobre uma resposta específica do Copilot Chat, clique no ícone de polegar para cima ou polegar para baixo na parte inferior de cada resposta de chat.

Para enviar comentários sobre Copilot Chat em geral, clique nas reticências (...) no canto superior direito do painel de chat e clique em Enviar comentários.