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 projeto | Variáveis de sessão | |
|---|---|---|
| Persistência | Entre todas as sessões | Só na sessão atual |
| Tipo de info | Stack, convenções, objetivos | URLs, IDs, tokens temporários |
| Quem edita | Você (na config do projeto) | O agente (automaticamente) |