Pular para o conteúdo principal

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:

  1. Abra Configurações
  2. Navegue para a seção Memória do bot atual
  3. 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
aviso

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:

ChaveValorExemplo de Uso
user_nameAlicePersonalizar respostas
preferred_languagePythonPreferência de geração de código
timezoneUS/PacificRespostas conscientes de tempo
projectFastAPI REST APIContexto de projeto em andamento
coding_stylePEP 8, type hints, docstringsPreferê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
dica

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

PropriedadeDetalhe
BackendIndexedDB (armazenado como ais-memory-{botId})
PersistênciaSobrevive recarregamentos de página, reinicializações de navegador, trocas de sessão
EscopoLocal no seu navegador -- nunca enviado a nenhum servidor
ExportaçãoIncluído em backup "Exportar Todos os Dados"
URLs CompartilhadosMemó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:

  1. Analisa a chamada de função
  2. Extrai a chave e valor
  3. 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.

informação

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.