Sobre os dados de sessão CLI do GitHub Copilot

          CLI do Copilot registra cada sessão localmente. Você pode retomar sessões anteriores, fazer Copilot perguntas sobre suas interações com a CLI e usar o comando de barra `/chronicle` para obter insights úteis baseados em sessão.

Neste artigo

Introdução

Toda vez que você usa CLI do Copilot, um conjunto completo de dados sobre sua sessão—incluindo seus prompts, as respostas de Copilot, as ferramentas que foram usadas e os detalhes dos arquivos que foram modificados—é registrado em seu computador local. Com o tempo, isso constrói uma rica história do que você trabalhou, como você trabalhou, e o que Copilot fez por você.

Esses dados de sessão alimentam vários recursos:

  •         **Retomando sessões**: você pode continuar de onde parou em qualquer sessão anterior.

  •         **Fazendo perguntas sobre seu histórico**: Você pode fazer Copilot perguntas sobre seu trabalho anterior e consultará seus dados de sessão para respondê-los.

  •         **O comando barra `/chronicle`**: um conjunto de subcomandos com propósito específico que geram relatórios de reunião, dicas personalizadas e sugestões para melhorar suas instruções personalizadas, todos derivados do histórico de sessão.

Este artigo conceitual explica como os dados de sessão são armazenados e como você pode aproveitá-los para aprimorar seu fluxo de trabalho. Para ver um guia prático sobre como retomar uma sessão, perguntar ao Copilot sobre suas sessões de CLI e usar o comando de barra /chronicle, consulte Usando CLI do GitHub Copilot dados de sessão.

Observação

O comando /chronicle e a capacidade de Copilot de responder perguntas sobre seu histórico de sessão são funcionalidades experimentais atualmente, e estão disponíveis somente se você tiver utilizado o comando de barra /experimental on ou a opção de linha de comando --experimental.

Como os dados de sessão são armazenados

Cada CLI do Copilot sessão é mantida como um conjunto de arquivos no ~/.copilot/session-state/ diretório em seu computador. Os dados de cada sessão contêm um registro completo da sessão. Esses arquivos permitem que você retome uma sessão interativa da CLI.

Além dos arquivos de sessão, CLI do Copilot armazena dados de sessão estruturados em um banco de dados SQLite local, chamado de repositório de sessão. Esses dados são um subconjunto dos dados completos armazenados nos arquivos de sessão. O armazenamento de sessão é o que viabiliza o comando de barra /chronicle e também permite que o Copilot responda às perguntas que você faz sobre o seu trabalho anterior.

Localidade de dados e privacidade

Todos os dados de sessão são armazenados localmente em seu diretório inicial e só podem ser acessados para sua conta de usuário. Copilot lê esses dados em seu computador quando você faz perguntas sobre suas interações com a CLI ou quando usa o /chronicle comando barra. Dados de sessão, tais como seus prompts anteriores, dados de contexto e respostas que você recebeu, podem ser enviados para o modelo de IA da mesma forma que em qualquer interação normal CLI do Copilot.

Se você quiser remover dados de uma sessão específica da CLI, poderá excluir o diretório de sessão relevante de ~/.copilot/session-state/. Você pode limpar todos os dados de sessão excluindo tudo em ~/.copilot/session-state/. Depois de fazer isso, você deve reindexar manualmente o repositório de sessão. Consulte a reindexação do armazenamento de sessão mais adiante neste artigo.

Sobre o comando barra /chronicle

O comando /chronicle SUBCOMMAND utiliza os dados armazenados no repositório de sessão para fornecer insights e sugestões sobre o seu uso do CLI do Copilot.

Você pode inserir os seguintes comandos em uma sessão interativa da CLI:

  •         `/chronicle standup`: gera um relatório breve resumindo em que você trabalhou em suas sessões recentes da CLI, incluindo nomes de ramificações, links de solicitações de pull e verificações de status.

  •         `/chronicle tips`: fornece dicas personalizadas para usar CLI do Copilot com mais eficiência.

  •         `/chronicle improve`: analisa seu histórico de sessão para identificar padrões nos quais Copilot pode ter entendido mal sua intenção ou onde havia muita interação, e gera instruções personalizadas para ajudar Copilot a compreender você melhor no futuro.

  •         `/chronicle reindex`: Recria o armazenamento de sessão a partir dos arquivos de histórico de sessão.

Benefícios de /chronicle e os dados da sessão

  •         **Fluxo de trabalho de auto-aperfeiçoamento**: o `improve` subcomando cria um ciclo de feedback que ajuda você a refinar suas instruções personalizadas. Com o tempo, isso torna o agente mais eficaz para seu projeto específico.

  •         **Relatórios de reunião sem esforço**: em vez de reconstruir manualmente o que você fez ontem, o `/chronicle standup` gera um resumo de reunião a partir dos dados reais da sua sessão.

  •           **Coaching personalizado**: o subcomando `tips` atua como um coach de produtividade pessoal que sabe o que o CLI do Copilot pode fazer e a forma como você realmente o utiliza. Ele faz a ponte entre os recursos disponíveis e o fluxo de trabalho atual.

  •           **Fale com seu histórico de codificação**: o armazenamento de sessão permite que o Copilot responda a qualquer pergunta que suas sessões anteriores possam ajudar a esclarecer, desde relembrar uma correção de bug que você fez na semana passada até analisar seus padrões de prompts ao longo do tempo.

  •         **Local e privado**: todos os dados de sessão, tanto os arquivos JSONL brutos quanto o repositório de sessão SQLite, permanecem no computador. Nada é carregado ou compartilhado além das interações normais do modelo de IA que ocorrem em qualquer CLI do Copilot sessão. Você tem controle total sobre seus dados e pode excluí-los a qualquer momento.

Quando você deve usar esses recursos?

  •         **No início do seu dia**: execute `/chronicle standup last 3 days` para gerar um lembrete do que você trabalhou recentemente e da sessão da CLI em que você estava trabalhando.

  •         **Periodicamente, para nivelar**: execute `/chronicle tips` a cada semana ou duas para descobrir recursos e melhorias de fluxo de trabalho que você pode estar perdendo.

  •         **Quando Copilot continuar cometendo o mesmo erro**: execute `/chronicle improve` para identificar o padrão e gerar instruções personalizadas para corrigi-lo.

  •         **Para lembrar do trabalho passado**: faça uma pergunta de forma livre como "Trabalhei em algo relacionado à API de pagamentos?" e Copilot pesquisará seu histórico.

  •         **Para continuar o trabalho anterior**: use `copilot --continue` ou `copilot --resume` para continuar de onde parou.

Reindexação do armazenamento de sessão

O repositório de sessão é preenchido incrementalmente durante uma sessão da CLI. Os dados de uma sessão são gravados em disco em um subdiretório específico da sessão de ~/.copilot/session-state/. Isso também ocorre periodicamente durante uma sessão e também quando a sessão termina.

Você pode reindexar o repositório de sessão dos arquivos de sessão no disco, embora normalmente você nunca precise fazer isso.

As situações em que talvez seja necessário reindexar incluem:

  •         **Indexando sessões antigas**: se você tiver arquivos de sessão antigos no disco que foram criados antes da existência do repositório de sessão, a reindexação preencherá o repositório de sessão com dados dessas sessões.

  •         **Exclusão** de sessão: se você quiser excluir uma sessão do seu histórico, poderá excluir o diretório da sessão e reindexar o repositório de sessão.

  •         **Migrando/recuperando sessões**: se você moveu seus arquivos de sessão para outro computador ou restaurou-os de um backup, sem também mover/restaurar o arquivo do repositório de sessão (`~/.copilot/session-store.db`), você poderá usar o comando reindex para recriar o repositório de sessão.

  •         **Corrupção** de arquivos: se o arquivo do repositório de sessão (`~/.copilot/session-store.db`) ficar corrompido ou for excluído acidentalmente, você poderá recuperar o repositório de sessão dos arquivos de sessão.

  •         **Encerramento inesperado**: se uma sessão for encerrada inesperadamente (por exemplo, devido a uma falha ou perda de energia) antes que os dados mantidos na memória sejam liberados para o repositório de sessão, você poderá preencher o repositório de sessão com os dados ausentes se ele tiver sido gravado em disco, nos arquivos de sessão, antes do encerramento.

Para reindexar o repositório de sessão, use o seguinte comando barra em uma sessão interativa do CLI:

Copilot prompt
/chronicle reindex

Leitura adicional

  •         [AUTOTITLE](/copilot/how-tos/copilot-cli/chronicle)

  •         [AUTOTITLE](/copilot/reference/cli-command-reference)