Skip to main content

Acompanhamento das sessões do GitHub Copilot

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

Quem pode usar esse recurso?

O agente de codificação 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, guia de agentes, GitHub CLI e GitHub Copilot extensão para Raycast fornecem uma visão geral das sessões do agente entre 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 a partir 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.

Monitoramento de sessões de agente na aba Agentes

Você pode ver uma lista de suas sessões de agente ativas e passadas no painel de agentes, disponível em todas as páginas do GitHub ou na guia de agentes dedicada. As sessões do agente aparecerão em sua lista de sessões se você tiver iniciado a sessão ou solicitado ao Copilot para trabalhar na sessão de outro usuário.

Para abrir a guia agents, clique em para abrir o painel agentes na barra de navegação em qualquer página e, em seguida, clique em View all.

Cada sessão exibe seu status. Clique em uma sessão para abrir o log de sessão e a visão geral, em que você pode monitorar o progresso do agente, o uso do token, a contagem de sessão e o comprimento da sessão.

Você pode começar novas sessões de agente pela aba. Consulte Solicitando GitHub Copilot para criar uma solicitação de pull.

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. Opcionalmente, use a opção --follow para transmitir logs ao vivo 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 Windows e macOS. Com a extensão do GitHub Copilot para Raycast, você pode iniciar e acompanhar tarefas do agente de codificação 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 Entrar com GitHub e então 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, a organização proprietária do repositório pode ter habilitado restrições de acesso do OAuth app. Para saber como solicitar aprovação para o "GitHub Copilot for Raycast" OAuth app, consulte Solicitar aprovação da organização para aplicativos OAuth.

Você também pode iniciar novas sessões de agente por meio do Raycast. Confira Solicitando GitHub Copilot para criar uma solicitação de pull.

Acompanhar sessões no Visual Studio Code

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

Depois de instalar a extensão, você poderá ver as sessõ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 Solicitando GitHub Copilot para criar uma solicitação de pull.

Para abrir diretamente as sessões do agente no VS Code, clique na opção Open in VS Code na guia Agentes.

Observação

A abertura de uma sessão no VS Code só está disponível no momento em VS Code Insiders.

Acompanhamento das sessões dos IDEs da JetBrains

Observação

O agente de codificação Copilot em IDEs do JetBrains 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 anteriores e em execução para um projeto nas IDEs do JetBrains com a extensão Chat GitHub Copilot. Confira Instalando a extensão GitHub Copilot em seu ambiente.

Você pode ver todas as sessões do Copilot clicando no botão GitHub Trabalhos do Agente de Codificação na barra lateral ou clicando no botão Abrir Lista de Trabalhos depois de delegar uma tarefa para Copilot de Chat GitHub Copilot.

Para cada sessão listada, você pode ver seu status rapidamente. Clique em Abrir no Navegador para abrir a solicitação de pull no navegador ou clique com o botão direito do mouse em um trabalho em execução e clique em Cancelar Trabalho para cancelar.

Copilot também vai te notificar quando uma tarefa de agente for iniciada e concluída.

Acompanhar sessões do Eclipse

Observação

O agente de codificação Copilot no Eclipse 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 para um projeto no Eclipse com a extensão Chat GitHub Copilot. Confira Instalando a extensão GitHub Copilot em seu ambiente.

Você pode ver todas as sessões de Copilot clicando em no canto superior direito da janela de chat ou clicando no botão Abrir Lista de Trabalhos depois de delegar uma tarefa para Copilot de Chat GitHub Copilot.

Para cada sessão listada, você pode ver seu status rapidamente. Clique em Abrir no Navegador para abrir a solicitação de pull no navegador ou clique com o botão direito do mouse em um trabalho em execução e clique em Cancelar Trabalho para cancelar.

Copilot também vai te notificar quando uma tarefa de agente for iniciada e concluída.

Acompanhar sessões de 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

Você pode se aprofundar nos logs de sessão do Copilot no GitHub ou Visual Studio Code para compreender 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.

Direcionando uma sessão de Copilot da guia Agentes

Você pode controlar Copilot enquanto ele trabalha para concluir uma tarefa. Os motivos pelos quais você pode querer orientar uma sessão incluem:

  • Copilot parece estar indo na direção errada, e você deseja dar mais clareza a ele.
  • Você cometeu um erro na descrição do trabalho necessário e decidiu recomeçar.

Siga estas etapas para controlar Copilot:

  1. Abra a aba agents.
  2. Na lista de sessões do Agente , selecione a tarefa para a qual você deseja fornecer mais entradas.
  3. Na caixa de prompt, solicite Copilot enquanto ele está trabalhando em uma tarefa.

Por exemplo, Use our existing ErrorHandler utility class instead of writing custom try-catch blocks for each endpoint.

O Copilot começará a implementar sua entrada depois de concluir sua chamada de ferramenta atual.

Observação

O controle usa uma solicitação premium por mensagem.

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:

  • 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

  •         [AUTOTITLE](/copilot/tutorials/coding-agent/best-practices)
    
  •         [AUTOTITLE](/copilot/using-github-copilot/coding-agent/troubleshooting-copilot-coding-agent)