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)