Gerenciar sessões de agente

Monitore o progresso de um agente em tempo real, guie-o com prompts de acompanhamento e interrompa ou arquive sessões.

Neste artigo

Use o painel GitHub de agentes para monitorar e gerenciar sessões de agente em seus repositórios.

Monitorar a atividade do agente

Acompanhe as sessões no painel de agentes (disponível em qualquer página no GitHub) ou na sua Copilot home page. As sessões que você iniciou ou que outro usuário solicitou Copilot para trabalhar aparecem na sua lista de sessões.

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

Examinar logs de sessão

Os logs de sessão mostram Copilot o raciocínio interno que utilizou e as ferramentas usadas para entender seu repositório, realizar mudanças e validar seu trabalho. Copilot tem seu próprio ambiente de desenvolvimento efêmero, para executar testes automatizados e linters para validar as alterações antes de realizar o push.

Rastrear confirmações em logs de sessão

Os commits de Copilot cloud agent são de autoria de Copilot, com a pessoa que iniciou a tarefa indicada como coautora. Cada mensagem de confirmação inclui um link para os logs de sessão, para que você possa rastrear por que uma alteração foi feita durante a revisão de código ou uma auditoria. Os commits são assinados e aparecem como "Verificados" no GitHub.

Conduzir uma sessão de agente

Se Copilot estiver indo na direção errada ou perceber que o prompt original precisa ser ajustado, você pode redirecioná-lo sem interromper a sessão.

  1. Abra sua Copilot home page e selecione a sessão.

  2. Na caixa de prompt abaixo do log de sessão, digite sua resposta. Por exemplo:

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

  3. Pressione Enter. Copilot implementa sua entrada depois de concluir sua chamada de ferramenta atual.

Cada mensagem de controle consome AI credits. O controle não está disponível para agentes de codificação de terceiros.

Continuar uma sessão em outro cliente

As sessões executadas em uma área restrita de nuvem não estão vinculadas ao dispositivo ou ao cliente em que você as iniciou. A sessão, seus arquivos e seu trabalho em andamento residem na infraestrutura hospedada em GitHub. Portanto, você pode mover-se entre os clientes conforme o seu dia muda, sem copiar arquivos, reinstalar dependências ou explicar a tarefa novamente. Para obter mais informações, consulte Sobre sandboxes na nuvem para GitHub Copilot.

Veja como uma única sessão pode se mover com você da sua mesa para seu telefone e voltar.

  1. Inicie no GitHub Copilot app. Em sua mesa, você inicia uma sessão em uma sandbox na nuvem e descreve a tarefa. Copilot passa a ser executado na nuvem, para que você possa fechar o laptop e a sessão continue em execução.

  2. Dirija de GitHub Mobile. Quando estiver fora, você abre a sessão em seu telefone para verificar o progresso de Copilot. Se estiver indo na direção errada, envie um prompt de acompanhamento para redirecioná-lo.

  3. Revisão sobre GitHub.com. Posteriormente, em qualquer navegador, você abre a sessão para ler o log da sessão e verificar as alterações que Copilot fez após o seu acompanhamento.

  4. Concluir em Copilot CLI. De volta ao terminal, você retomará a mesma sessão, com o histórico completo e o trabalho intactos, e continuará trabalhando até estar pronto para abrir um pull request.

Em cada etapa, você trabalha com a mesma sessão. Copilot mantém a conversa e o trabalho até agora, para que cada cliente continue de onde o último parou.

Localizar suas sessões em cada cliente

  • GitHub.com: vá para github.com/copilot. Suas sessões mais recentes estão listadas em "Continuar de onde parou". Para ver todas as sessões, clique em Exibir tudo.
  • GitHub Mobile: toque Copilot no canto inferior direito. Suas sessões são listadas em "Sessões do agente".
  • Copilot CLI: abra a guia Sessões ou insira /resume em uma sessão interativa. As sessões de nuvem aparecem junto com suas sessões locais. Para obter mais informações, consulte Trabalhando com várias GitHub Copilot CLI sessões.
  • GitHub Copilot app: suas sessões aparecem na barra lateral. Clique em uma sessão para abri-la.

Parar uma sessão

Se a tarefa não precisar mais ser feita ou se você quiser recomeçar com um novo prompt, clique em Parar sessão no visualizador de log de sessão. Parar uma sessão encerra a execução de GitHub Actions e preserva todos os commits já enviados por push.

Sessões Arquivadas

Arquive sessões interrompidas para removê-las da lista de sessões.

  1. Abra a sessão interrompida.
  2. Clique e clique em Arquivar sessão.
  3. Na caixa de diálogo, clique em Sim, arquivar.

Copilot cloud agent as sessões podem ser arquivadas, mas não excluídas. Somente sessões locais (de GitHub Copilot CLI, , VS CodeJetBrains ou o GitHub Copilot app) podem ser excluídas. Para obter mais informações sobre como excluir sessões, consulte Sobre os dados da sessão do GitHub Copilot.

Partilhar uma sessão

Copilot cloud agent as sessões são compartilhadas por padrão. Elas aparecem no modo de exibição "Todas as sessões" na guia "Agentes" do repositório, visível para qualquer pessoa com acesso ao repositório.

As sessões locais (de GitHub Copilot CLI, , VS CodeJetBrains ou o GitHub Copilot app) não são compartilhadas por padrão. Você pode optar por compartilhar uma sessão local a partir da guia "Agents" do seu repositório, concedendo acesso somente para visualização aos colaboradores do repositório. Para compartilhar ou descompartilhar uma sessão local, use os controles de compartilhamento no menu da sessão.

Os destinatários podem exibir os prompts, respostas e alterações de arquivo da sessão, mas não podem orientar ou modificar a sessão. As sessões locais compartilhadas aparecem no modo de exibição "Todas as sessões", mas não são indexadas para consultas de sessão de outros usuários (elas não aparecerão nos resultados de /chronicle outro usuário).

Para obter mais informações sobre a sincronização de sessão, consulte Sobre os dados da sessão do GitHub Copilot.

Consultar sessões passadas

Você pode pesquisar o histórico da sua sessão fazendo perguntas em linguagem natural no Copilot Chat, no VS Code, JetBrains, no GitHub Copilot app ou no GitHub.com. Copilot pesquisa em suas sessões sincronizadas de Copilot CLI, Copilot cloud agent e Copilot code review para fornecer respostas.

Você só pode consultar as sessões que você iniciou. Seus dados de sessão são privados por padrão, mas você pode optar por compartilhar sessões individuais com acesso somente para visualização. Consulte Compartilhar uma sessão anteriormente neste artigo.

Pré-requisitos

Suas sessões devem ser sincronizadas com sua GitHub conta. Por padrão, os dados de sessão são sincronizados automaticamente. Se você optou por não sincronizar (definindo "remoteExport": false as configurações da CLI JSON) ou se sua organização não tiver habilitado a política "Armazenar sessões locais na nuvem", a consulta de sessão não estará disponível. Para obter mais informações, consulte Sobre os dados da sessão do GitHub Copilot.

Consultas de exemplo

What agent tasks did I run last week?

Find the session where I refactored authentication.

Have I worked on anything related to the payments API?

Show me sessions where the agent struggled or I had to correct it multiple times.

Copilot pode pesquisar entre seus prompts, respostas, alterações de arquivo e outro contexto de suas sessões sincronizadas.

Para consultas de sessão e /chronicle comandos específicos da CLI, consulte Usando GitHub Copilot CLI dados de sessão. Para obter informações conceituais sobre como os dados de sessão são armazenados e sincronizados, consulte Sobre os dados da sessão do GitHub Copilot.

Leitura adicional