Pular para o conteúdo principal

Histórico e sessões

O que é uma sessão​

Uma sessão é uma conversa completa com o agente dentro de um projeto. Cada sessão tem:

  • Histórico de mensagens — toda a troca entre você e o agente
  • Ferramentas executadas — registro de cada ação tomada
  • Variáveis — valores salvos pelo agente durante a conversa
  • Processos — servidores e jobs iniciados na sessão

Acessando sessões anteriores​

Nas sessões de um projeto, você pode ver o histórico de conversas anteriores. Cada sessão mantém seu contexto completo.

Iniciando uma nova sessão​

Para começar uma conversa "limpa" (sem o contexto de sessões anteriores):

  1. Vá para a tela de Projetos
  2. Clique em Nova conversa no projeto desejado
  3. Uma nova sessão é criada — o agente começa sem memória da sessão anterior
Dica

O contexto do projeto (descrição, diretório de trabalho) é sempre injetado em novas sessões. O que não persiste entre sessões é o histórico de mensagens e variáveis de sessão.

Continuando uma sessão existente​

Para retomar uma conversa anterior:

  1. Vá ao projeto
  2. Clique no Hub do projeto (ícone de pasta)
  3. Na aba de histórico, selecione a sessão desejada
  4. Continue de onde parou

Boas práticas​

  • Uma sessão por tarefa: mantenha sessões focadas. Uma sessão para "implementar autenticação", outra para "configurar CI/CD".
  • Use o contexto do projeto: informações permanentes (stack, convenções, objetivo) ficam no contexto do projeto — não precisa repetir em cada sessão.
  • Variáveis de sessão: para valores temporários (URLs, IDs, tokens de teste), o agente pode salvá-los com set_variable para reutilizar na mesma sessão.