# 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.

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 do painel dos agentes (disponível em qualquer página no GitHub) ou na página de [agentes](https://github.com/copilot/agents?ref_product=copilot\&ref_type=engagement\&ref_style=text). 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 a [página agentes](https://github.com/copilot/agents?ref_product=copilot\&ref_type=engagement\&ref_style=text) e selecione a sessão.

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

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

3. Pressione <kbd>Enter</kbd>.
   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.

## 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 **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="More actions" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg>** e clique **em Arquivar<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-inbox" aria-label="inbox" role="img"><path d="M2.8 2.06A1.75 1.75 0 0 1 4.41 1h7.18c.7 0 1.333.417 1.61 1.06l2.74 6.395c.04.093.06.194.06.295v4.5A1.75 1.75 0 0 1 14.25 15H1.75A1.75 1.75 0 0 1 0 13.25v-4.5c0-.101.02-.202.06-.295Zm1.61.44a.25.25 0 0 0-.23.152L1.887 8H4.75a.75.75 0 0 1 .6.3L6.625 10h2.75l1.275-1.7a.75.75 0 0 1 .6-.3h2.863L11.82 2.652a.25.25 0 0 0-.23-.152Zm10.09 7h-2.875l-1.275 1.7a.75.75 0 0 1-.6.3h-3.5a.75.75 0 0 1-.6-.3L4.375 9.5H1.5v3.75c0 .138.112.25.25.25h12.5a.25.25 0 0 0 .25-.25Z"></path></svg> 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 de sessão GitHub Copilot CLI](/pt/copilot/concepts/agents/copilot-cli/chronicle#managing-your-session-data).

## 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 de sessão GitHub Copilot CLI](/pt/copilot/concepts/agents/copilot-cli/chronicle#session-syncing).

## 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](#share-a-session) 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 de sessão GitHub Copilot CLI](/pt/copilot/concepts/agents/copilot-cli/chronicle#session-syncing).

### Consultas de exemplo

```text
What agent tasks did I run last week?
```

```text
Find the session where I refactored authentication.
```

```text
Have I worked on anything related to the payments API?
```

```text
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](/pt/copilot/how-tos/copilot-cli/use-copilot-cli/chronicle). Para obter informações conceituais sobre como os dados de sessão são armazenados e sincronizados, consulte [Sobre os dados de sessão GitHub Copilot CLI](/pt/copilot/concepts/agents/copilot-cli/chronicle).

## Continuar o trabalho de uma sessão em GitHub Copilot Chat

Você pode passar contexto entre Copilot Chat e suas sessões de Copilot cloud agent no GitHub.

Quando você inicia uma sessão a partir de Copilot Chat, ela incorpora o contexto da sua conversa e, enquanto a sessão estiver em execução, Copilot Chat reflete o status dela para que você possa fazer perguntas de acompanhamento.

Quando uma sessão for concluída ou quando você estiver exibindo uma solicitação Copilot de pull criada, você poderá perguntar o que foi alterado, o que foi validado e por quê e Copilot responderá desenhando nos logs de sessão. Você também pode iniciar outra sessão diretamente de Copilot Chat.

Para obter mais informações, consulte [Sobre GitHub Copilot Chat](/pt/copilot/concepts/chat) e [Usando GitHub Copilot para explorar solicitações de pull](/pt/copilot/tutorials/explore-pull-requests).

## Leitura adicional

* [Práticas recomendadas para usar GitHub Copilot para trabalhar em tarefas](/pt/copilot/tutorials/cloud-agent/get-the-best-results)