Guia de início rápido para usar o GitHub Copilot no GitHub.com

GitHub Copilot já vem integrado a GitHub, para que você possa usá-lo sem instalar nada.

Este início rápido leva cerca de quinze minutos e mostra como fazer perguntas sobre um repositório, solicitar e revisar uma alteração de código e continuar seu trabalho em GitHub Mobile com Copilot.

Prerequisites

• Para a Tarefa 1, você precisa de acesso de leitura a um repositório, como o repositório público github/docs .
• Para tarefas 2 e 3, você precisa de acesso de gravação a um repositório. É recomendável usar um repositório no qual você possui ou tem permissão para fazer alterações.
• Para concluir cada tarefa neste início rápido, Copilot deve estar disponível para sua conta e habilitado para o repositório que você usará. Para obter diretrizes de configuração, consulte Habilitar Copilot.
• Para executar a Tarefa 3, você precisa ter GitHub Mobile instalado e configurado para sua conta. Consulte GitHub Mobile.

Tarefa 1: fazer Copilot perguntas sobre um repositório

1. Inicie uma sessão com Copilot, na Copilot home page.

2. Abaixo da caixa de prompt, abra o seletor de escopo da sessão de Chat .

3. Em Trabalhar em um repositório, pesquise e selecione o repositório que você deseja explorar.

   • Se você precisar de um repositório para experimentar, use o repositório público github/docs .

4. Se uma solicitação específica de arquivo, issue ou pull for relevante, digite @ na caixa de prompt e selecione-a nas sugestões. Isso fornece Copilot um lugar específico para procurar contexto.

5. Faça uma pergunta sobre o repositório. Por exemplo:

   Copilot prompt

   I'm new to github/docs. How is this repository organized,
   and where should I start to understand how the site is built?
   

   Copilot prompt

   In /package.json, which scripts look relevant for validating
   a change, and what command does each run?
   

   Copilot prompt

   What behavior does
   /src/color-schemes/tests/color-mode-script.ts cover?
   Suggest one additional test case that would fit the
   existing tests, and explain why.
   

   Para criar um prompt com base nos exemplos acima, selecione Copiar e cole-o na caixa de prompt. Em seguida, pressione Enter para enviar o prompt.

   A resposta de Copilot aparece na conversa. Faça uma pergunta focada sobre um arquivo, recurso ou erro para obter uma resposta mais útil.

6. Faça uma pergunta de acompanhamento digitando-a na mesma caixa de prompt e pressionando Enter. A conversa fornece Copilot contexto para sua próxima pergunta.

Tarefa 2: Solicitar e examinar uma alteração de código

1. Inicie uma sessão com Copilot, na sua Copilot home page.

2. Em um repositório em que você tem acesso de gravação, use o seletor de escopo da sessão de Chat e selecione o repositório na seção Trabalhar em um repositório.

3. Solicite a alteração de um código. Declare o resultado desejado e qualquer arquivo ou comportamento relevante. Por exemplo, copie e envie este prompt:

   Copilot prompt

   Add a small ASCII art image to the top of the README file.
   

   Cole o prompt na caixa de prompt e pressione Enter para enviá-lo. Copilot trabalha na tarefa em segundo plano.

   Importante

   Examine todas as Copilot solicitações de permissões ou ação antes de permitir alterações.

4. Como Copilot processa a solicitação, você pode continuar a interagir com a sessão. Você também pode expandir cada uma das etapas que Copilot executa no log de sessão para ver o trabalho executado e as ferramentas usadas.

5. Quando Copilot terminar, ele exibirá as alterações acima da caixa de prompt e apresentará uma opção para criar um pull request.

6. Clique em Alterações para exibir as alterações propostas.

7. Para fazer outras alterações, digite uma solicitação complementar na mesma caixa de prompt e pressione Enter. A sessão mantém o contexto de seus prompts anteriores.

8. Clique em Criar solicitação de pull e, em seguida, clique no link Exibir PR para exibir suas alterações.

Prossiga para a Tarefa 3 para continuar sua sessão em GitHub Mobile.

Tarefa 3: Continuar sua sessão em GitHub Mobile

1. Abra GitHub Mobile em seu dispositivo.

2. Na home page, toque no ícone no canto inferior direito da tela.

3. Na lista de sessões recentes, toque no nome da sessão que você criou acima. O nome geralmente é baseado no primeiro prompt que você enviou. Neste exemplo, pode ser algo parecido README ascii art.

4. Clique em Exibir PR e, em seguida, arquivos alterados, para revisar as alterações propostas novamente.

5. Opcionalmente, para solicitar outra alteração, clique na linha afetada. Adicione um comentário que menciona @copilot e descreve o que mudar. Em seguida, selecione Comentário e clique em Concluir sua revisão para que Copilot possa ver e agir em sua solicitação.

Copilot reconhecerá seu comentário com uma reação e iniciará uma sessão para fazer as alterações solicitadas, se possível. Os eventos da linha do tempo na página da pull request serão mostrados quando Copilot terminar, e Copilot solicitará sua revisão novamente, bem como responderá ao seu comentário anterior com os resultados.

1. Quando você estiver satisfeito com sua solicitação de pull, deverá Marcar como pronto para revisão.

2. Examine as alterações feitas por Copilot para garantir que elas atendam às suas expectativas. Se necessário, clique em Aprovar e depois em Concluir sua revisão, para levar a PR a um estado pronto para mesclagem.

3. Clique em Mesclar para mesclar o pull request.

   Em seguida, vamos verificar seu arquivo README atualizado.

4. Volte para sua Página Inicial em GitHub Mobile para pesquisar seu repositório e abri-lo.

5. Role a página até o final para exibir o README do repositório e admire sua arte!

Próximas Etapas 

• Usando Copilot na nuvem em GitHub
• Exibindo e estimando seus gastos
• Monitorar o uso de GitHub AI Credits