Memória
O recurso Memória dá a cada bot memória persistente de longo prazo que sobrevive entre sessões. Bots podem lembrar fatos, preferências e contexto entre conversas sem você repetir.
Como Funciona
Cada bot tem seu próprio armazenamento de memória isolado respaldado por IndexedDB. Entradas de memória são pares chave-valor que persistem no navegador através de recarregamentos de página e sessões.
Quando um bot tem entradas de memória, elas são automaticamente injetadas no prompt do sistema antes de cada mensagem ser enviada. O modelo recebe o contexto armazenado como parte de suas instruções, dando acesso a informações lembradas sem consumir histórico de chat visível.
O formato injetado parece assim internamente:
<memory>
- user_name: Alice
- preferred_language: Python
- project: Building a REST API with FastAPI
</memory>
Adicionando Memórias
O Comando /remember
Digite um comando de memória diretamente no chat:
Diga ao bot: bcz_remember("user_name", "Alice")
Quando o modelo inclui bcz_remember("key", "value") em sua resposta, a plataforma automaticamente analisa e armazena a entrada de memória. Isso permite ao modelo decidir o que vale a pena lembrar baseado em suas conversas.
Painel de Memória em Configurações
Você também pode gerenciar memórias manualmente:
- Abra Configurações
- Navegue para a seção Memória do bot atual
- Adicione, edite ou remova entradas de memória individuais
Visualizando Memórias
Todas as entradas de memória para o bot atual são visíveis em Configurações. Cada entrada mostra:
- Chave -- o identificador (ex: "user_name", "project_context")
- Valor -- a informação armazenada
- Timestamp -- quando a entrada foi atualizada pela última vez
Editando e Excluindo Memórias
A partir do painel de Memória em Configurações:
- Edite qualquer entrada de memória mudando sua chave ou valor
- Exclua entradas individuais com o botão remover
- Limpe todas as memórias do bot atual
Excluir uma memória é permanente. Não há como desfazer. Se você limpar todas as memórias, o bot recomeça fresco sem nenhum contexto lembrado.
Formato de Memória
Memórias são armazenadas como pares chave-valor:
| Chave | Valor | Exemplo de Uso |
|---|---|---|
user_name | Alice | Personalizar respostas |
preferred_language | Python | Preferência de geração de código |
timezone | US/Pacific | Respostas conscientes de tempo |
project | FastAPI REST API | Contexto de projeto em andamento |
coding_style | PEP 8, type hints, docstrings | Preferências de estilo de código |
Chaves devem ser descritivas e concisas. Valores podem ser qualquer texto.
Casos de Uso
- Preferências pessoais -- nome, fuso horário, linguagem de código, estilo de comunicação
- Contexto de projeto -- detalhes do projeto atual, tech stack, requisitos
- Instruções recorrentes -- "sempre formate código com comentários", "prefira respostas concisas"
- Conhecimento de domínio -- armazene fatos que o bot deve sempre saber sobre seu ambiente
- Resumos de conversa -- deixe o bot manter um resumo contínuo de discussões passadas
Comece com algumas memórias chave (seu nome, linguagem preferida, nome do projeto) e deixe crescer naturalmente. O bot se torna mais útil conforme acumula contexto sobre suas preferências e fluxos de trabalho.
Isolamento Por Bot
Memória é por bot -- cada bot tem seu próprio armazenamento de memória independente. Memórias não vazam entre bots. Isso significa:
- Seu assistente de programação lembra sua tech stack
- Seu assistente de escrita lembra seu estilo de escrita
- Nenhum vê as memórias do outro
Detalhes de Armazenamento
| Propriedade | Detalhe |
|---|---|
| Backend | IndexedDB (armazenado como ais-memory-{botId}) |
| Persistência | Sobrevive recarregamentos de página, reinicializações de navegador, trocas de sessão |
| Escopo | Local no seu navegador -- nunca enviado a nenhum servidor |
| Exportação | Incluído em backup "Exportar Todos os Dados" |
| URLs Compartilhados | Memória NÃO é incluída em URLs de bots compartilhados |
Integração com Tool-Call
Modelos com suporte a chamada de ferramentas podem gerenciar sua própria memória através de chamadas de ferramenta estruturadas. Quando o modelo produz uma chamada bcz_remember() em sua resposta, a plataforma automaticamente:
- Analisa a chamada de função
- Extrai a chave e valor
- Armazena (ou atualiza) a entrada de memória no IndexedDB
Isso permite ao modelo decidir autonomamente que informação é importante o suficiente para lembrar para conversas futuras.
Injeção de memória adiciona ao comprimento do prompt do sistema, que conta para a janela de contexto do modelo. Se você tem muitas entradas de memória, elas consomem tokens que poderiam ser usados para histórico de conversa.