Uma sessão é um período de interação com Copilot, como uma conversa em um IDE ou trabalho executado por um agente. Dados de sessão são as informações registradas sobre essa interação. Isso pode incluir prompts e respostas, ferramentas usadas e alterações feitas em arquivos.
Seu histórico de sessão é a coleção de sessões que você pode consultar.
Os dados de sessão ajudam você a entender e retornar ao trabalho executado com Copilot. Você pode usar dados de sessão para:
- Consulte o histórico das suas sessões: faça perguntas em linguagem natural sobre o trabalho realizado em sessões anteriores.
- Retomar sessões: continue de onde parou em qualquer sessão anterior.
- Examine ou compartilhe uma sessão.
- Gere insights, como relatórios de stand-up, dicas de fluxo de trabalho e análise de custos.
Os recursos disponíveis dependem da superfície em que a sessão está em execução.
Noções básicas sobre o local e o acesso da sessão
Quando uma sessão é executada, onde seus dados são armazenados, se eles são sincronizados com sua GitHub conta e quem pode acessá-lo são considerações separadas.
Uma sessão executada localmente pode ter dados armazenados em seu computador e em sua GitHub conta. Sincronizar uma sessão não a compartilha com outras pessoas.
Sessões executadas localmente
Copilot CLI e o GitHub Copilot app armazenam o registro completo de cada sessão em ~/.copilot/session-state/. Eles também armazenam um subconjunto dos dados em um banco de dados SQLite local, chamado de repositório de sessão. O repositório de sessão dá suporte a consultas de histórico de sessão e ao /chronicle comando.
O armazenamento de sessão para sessões iniciadas em um IDE é específico do IDE. Para obter informações sobre quais dados de sessão são armazenados e onde, consulte a documentação do seu IDE.
As sessões são executadas em GitHub
Copilot cloud agent as sessões são executadas em um ambiente efêmero hospedado por GitHub. O ambiente é destruído quando a sessão termina, mas o log de sessão permanece disponível GitHub.com. Essas sessões são compartilhadas por padrão e visíveis para pessoas com acesso ao repositório.
Sincronização de sessão
Por padrão, as sessões executadas localmente criadas com Copilot CLI ou o GitHub Copilot app são sincronizadas com sua conta GitHub.
Você pode controlar a sincronização de Copilot CLI e do GitHub Copilot app. Veja remote e remoteExport em Diretório de configuração do GitHub Copilot CLI.
Política que rege a sincronização de sessão
Para usuários de Copilot Enterprise e Copilot Business, a política aplicável "Armazenar sessões locais na nuvem" deve ser definida no mínimo como "Ver da nuvem" para que os dados da sessão sejam sincronizados. Se a política estiver desabilitada ou não configurada, as sessões serão armazenadas apenas localmente.
Privacidade e compartilhamento
As sessões locais não são compartilhadas por padrão. Você pode compartilhar uma sessão local individual com pessoas que têm acesso ao repositório. Os destinatários têm acesso somente para visualização, e as sessões compartilhadas não são incluídas em consultas ao histórico de sessões do próprio destinatário. Consulte Compartilhar uma sessão.
Os dados de sessão sincronizados estão vinculados à sua conta pessoal e só podem ser acessados por padrão. Os administradores podem controlar se a sincronização está disponível, mas habilitar a sincronização não lhes dá acesso aos dados da 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.
Quando você consulta interações anteriores ou usa /chronicle, Copilot pode enviar dados relevantes da sessão, como prompts, contexto e respostas, para o modelo de IA.
Acesso e retenção de dados de sessão
Os controles disponíveis para gerenciar dados de sessão dependem de onde os dados da sessão são armazenados e acessados.
Sessões armazenadas localmente
Os controles a seguir estão disponíveis:
- Compartilhar: crie uma cópia compartilhável da sessão como um link, gist ou arquivo.
- Excluir: remova permanentemente a sessão do armazenamento local.
- Arquivar: Mova a sessão da sua lista ativa sem excluí-la.
| Superfície | Share | Excluir | Arquivos |
|---|---|---|---|
| Copilot CLI | |||
| GitHub Copilot app |
Para Copilot CLI, excluir uma sessão local que foi sincronizada com sua conta solicita que você escolha se deseja também excluir a cópia sincronizada. Para o GitHub Copilot app, excluir uma sessão local também exclui sua cópia sincronizada imediatamente.
Sessões armazenadas em GitHub.com
Os controles a seguir estão disponíveis:
- Compartilhar: torne a sessão visível para pessoas com acesso ao repositório.
- Excluir: remova permanentemente o registro da sessão sincronizada de GitHub.com.
- Arquivar: Mova a sessão da lista de ativos no GitHub.com sem excluí-la.
| Origem da sessão | Share | Excluir | Arquivos |
|---|---|---|---|
| Sessão sincronizada Copilot CLI | |||
| (Não compartilhado por padrão) | |||
| Sessão sincronizada GitHub Copilot app | |||
| (Não compartilhado por padrão) | |||
| Copilot cloud agent sessão | (Compartilhado por padrão) |
Para obter mais informações, consulte:
- Copilot CLI: Usando GitHub Copilot CLI dados de sessão
- GitHub Copilot app: Trabalhando com sessões de agente no GitHub aplicativo Copilot
- Copilot cloud agent: Gerenciar sessões de agente
Para obter informações sobre os controles de dados de sessão disponíveis em Copilot um IDE, consulte a documentação desse IDE.
Gerenciamento de sessão para Copilot CLI
Especificamente para Copilot CLI, você pode gerenciar os dados de sessão armazenados localmente usando comandos iniciados por barra ou interagindo manualmente com o armazenamento de sessão localizado em ~/.copilot/session-state/.
Excluindo dados de sessão
Você pode excluir os dados locais da sessão da sua máquina e do seu histórico de sessões sincronizado em GitHub.com. Excluir uma sessão a remove da lista de sessão local, do índice de histórico de sessão e da lista de sessões sincronizadas.
Use os comandos /session para excluir sessões da CLI ou excluir manualmente os dados da sessão de ~/.copilot/session-state/. Consulte Excluir sessões.
Indexando novamente o repositório de sessão
Se os arquivos de sessão locais forem movidos, restaurados de um backup ou não mais representados no repositório de sessão, /chronicle reindex recompilará o repositório de sessão dos arquivos em ~/.copilot/session-state/. Consulte Reindexando o repositório de sessão.