Pular para o conteúdo principal

Memória de sessão

Durante uma conversa, o agente pode salvar informações como variáveis de sessão — valores que persistem e são reutilizados ao longo da mesma conversa.

Variáveis de sessão

Variáveis de sessão são pares chave-valor que o agente salva automaticamente (ou a seu pedido) para reutilizar mais tarde.

Exemplos de uso:

# O agente salva a URL do banco após criar
DB_URL = "postgres://user:pass@localhost:5432/mydb"

# ID de um recurso criado
USER_ID = "abc-123-def"

# Diretório do projeto
PROJ_DIR = "/home/carlos/projetos/api"

Painel de variáveis

No chat, um painel lateral exibe todas as variáveis da sessão com seus valores e descrições. Você pode:

  • Ver o que está salvo
  • Referenciar valores na conversa
  • As variáveis são injetadas no contexto do agente automaticamente

Pedindo ao agente para salvar variáveis

Salve a URL do servidor como variável SERVER_URL
Guarde o token de API que geramos como variável API_TOKEN

Limitações da memória de sessão

  • Variáveis de sessão não persistem entre sessões diferentes
  • Para informações permanentes, use o contexto do projeto
  • Variáveis de sessão existem apenas dentro da conversa atual

Contexto vs. variáveis de sessão

Contexto do projetoVariáveis de sessão
PersistênciaEntre todas as sessõesSó na sessão atual
Tipo de infoStack, convenções, objetivosURLs, IDs, tokens temporários
Quem editaVocê (na config do projeto)O agente (automaticamente)