Três chamadas: armazenar, recuperar, responder.
Uma única API. A chamada recall() retorna contexto de curto prazo, de longo prazo e do entorno em uma única ida e volta, pronto para inserir no seu prompt.
Armazenar
add() guarda fatos e trocas: as palavras do seu usuário, as do próprio assistente (speaker "me") ou as de uma pessoa nomeada. Indexado na entrada, sem chamada de LLM.
Recuperar
recall() retorna curto prazo + longo prazo + contexto em uma única chamada - os turnos recentes, até 20 memórias e até 20 linhas da conversa ao redor, não importa quanto você tenha armazenado.
Responder
Entregue esse contexto limitado ao seu LLM - qualquer provedor, sua chave.
from wontopos import Client mem = Client(api_key="wos-...") mem.add("she prefers tea over coffee", user_id="alice") mem.add("I suggested the jasmine tea", user_id="alice", speaker="me") # its own words # one call: short + long + context ctx = mem.recall("what does alice drink?", user_id="alice")
Memórias carregam um falante. O padrão são as palavras do seu usuário, speaker "me" guarda o que o próprio assistente disse, e um nome como "Bob" lembra quem disse, permitindo lembrar por pessoa.