Skip to main content

Acompanhar sessões do GitHub Copilot

Você pode usar o painel ou a página de agentes, o Visual Studio Code, a GitHub CLI e os logs de sessão e Raycast para acompanhar o progresso do Copilot e entender sua abordagem.

Quem pode usar esse recurso?

O Agente de codificação do Copilot está disponível com os planos GitHub Copilot Pro, GitHub Copilot Pro+, GitHub Copilot Business e GitHub Copilot Enterprise. O agente está disponível em todos os repositórios armazenados no GitHub, exceto os repositórios pertencentes ao contas de usuário gerenciadas e em locais em que foi explicitamente desabilitado.
Sign up for Copilot

Introdução

Depois de dar uma tarefa ao Copilot, ele trabalhará de modo autônomo em segundo plano para concluí-la. Confira Sobre o agente de codificação do GitHub Copilot.

O painel de agentes, a página de agentes, a GitHub CLI e a extensão do GitHub Copilot para Raycast apresentam uma visão geral de suas sessões de agente em repositórios. Você pode usá-los para iniciar novas tarefas e acompanhar o progresso do Copilot.

Você também pode acompanhar as sessões do Copilot em um repositório específico do Visual Studio Code.

Durante ou após uma sessão de agente, você pode inspecionar os logs de sessão para entender a abordagem do Copilot ao seu problema.

Acompanhar sessões de agentes na página ou no painel de agentes

Você pode ver uma lista das sessões de agente em execução e anteriores no painel de agentes, disponível em todas as páginas no GitHub, ou na página dedicada de agentes.

Para abrir o painel de agentes, clique em na barra de navegação em qualquer página.

Para abrir a página de agentes, abra o painel de agentes e clique em Exibir tudo.

Para cada sessão listada abaixo, você pode ver seu status rapidamente ou clicar nela para navegar até a pull request vinculada.

Para ver os logs de sessão, clique na pull request na lista e localize o evento "Trabalho iniciado do Copilot..." na linha do tempo e clique em Exibir sessão.

Captura de tela de uma seção de uma pull request com o botão "View session" realçado.

Você também pode iniciar sessões de agente na página e no painel. Confira Como pedir para o GitHub Copilot criar uma pull request.

Acompanhar sessões de agente da GitHub CLI

Observação

O conjunto de comandos agent-task só está disponível na v2.80.0 ou posterior da GitHub CLI. O conjunto de comandos está em versão prévia pública e está sujeito a alterações.

Você pode ver uma lista de suas sessões de agente em execução e passadas da GitHub CLI com o comando gh agent-task list. A saída mostrará uma lista de suas sessões recentes.

Para ver mais informações sobre uma sessão específica, use o comando gh agent-task view. Por exemplo, para exibir informações sobre a sessão associada à pull request nº 123 no repositório monalisa/bookstore, execute gh agent-task view --repo monalisa/bookstore 123.

Para exibir os logs de sessão, adicione a opção --log. Você também pode usar a opção --follow para transmitir logs dinâmicos enquanto o agente trabalha.

Para ver todas as opções disponíveis, execute gh agent-task list --help ou gh agent-task view --help.

Acompanhar sessões de agente do Raycast

O Raycast é um inicializador extensível para macOS. Com a extensão do GitHub Copilot para Raycast, você pode iniciar e acompanhar tarefas do Agente de codificação do Copilot onde quer que esteja em seu computador.

  1. Instale o Raycast do site do Raycast.
  2. Instale a extensão GitHub Copilot para Raycast clicando no botão Install Extension na página da extensão.
  3. Abra o Raycast, pesquise "Copilot", localize o comando View Tasks e pressione Enter.
  4. Clique em Sign in with GitHub e conclua o fluxo de autenticação. O Raycast será aberto novamente.
  5. Você verá uma lista de suas tarefas. Para navegar até a pull request vinculada, pressione Enter. Para exibir os logs de sessão, pressione Command+L.

Observação

Se você não conseguir ver algumas tarefas no Raycast, talvez a organização proprietária do repositório tenha habilitado restrições de acesso do OAuth app. Para saber como solicitar aprovação para "GitHub Copilot para Raycast" OAuth app, confira Solicitar aprovação da organização para aplicativos OAuth.

Você também pode iniciar novas sessões de agente por meio do Raycast. Confira Como pedir para o GitHub Copilot criar uma pull request.

Acompanhar sessões no Visual Studio Code

Você pode ver uma lista de sessões de agente em execução e anteriores de um repositório específico no Visual Studio Code com a extensão Pull Requests do GitHub.

Depois de instalar a extensão, você poderá ver assessões do Copilot clicando no botão GitHub na barra lateral.

Para cada sessão listada, você poderá ver seu status rapidamente ou clicar nela para navegar até a pull request no Visual Studio Code.

Para exibir os logs de sessão, clique na pull request na lista e clique em Exibir Sessão.

Você também pode iniciar novas sessões de agente no Visual Studio Code. Confira Como pedir para o GitHub Copilot criar uma pull request.

Acompanhar sessões no GitHub Mobile

Você pode ver uma lista de suas pull requests em execução e anteriores geradas por agentes no GitHub Mobile.

  1. Na seção "Agentes" da home page do GitHub Mobile, toque em Tarefas do Agente.

    Uma lista das pull requests abertas no momento, que você solicitou que o Copilot gerasse, é exibida.

  2. Use os botões na parte superior da lista para filtrar a lista de pull requests.

    Por exemplo, para mostrar apenas tarefas mescladas, toque em Abrir e, na lista suspensa, toque em Mescladas.

    Screenshot of the status dropdown list with a check mark against 'Open'.

Como usar os logs de sessão para entender a abordagem do Copilot

Saiba mais sobre os logs de sessão do Copilot no GitHub ou no Visual Studio Code para entender como ele abordou sua tarefa.

Nos logs de sessão, você pode ver o monólogo interno do Copilot e as ferramentas usadas para entender o repositório, fazer alterações e validar seu trabalho.

Observação

O Copilot tem um ambiente de desenvolvimento próprio, incluindo a capacidade de executar testes automatizados e linters, para validar suas alterações antes de enviar por push.

Como interromper uma sessão do Copilot

Você pode impedir que o Copilot continue trabalhando em uma tarefa clicando em Stop session no visualizador de log de sessão.

Captura de tela do visualizador de log com o botão "Stop session" realçado.

Os motivos para interromper uma sessão incluem:

  • O Copilot parece estar indo para o lado errado, e você quer pará-lo para deixar as informações mais claras.
  • Você cometeu um erro na descrição do trabalho necessário e decidiu recomeçar.
  • Você percebeu que a alteração solicitada não precisa ser feita, portanto, quer impedir que o Copilot trabalhe nela.

Leitura adicional