Tres llamadas: store, recall, responder.
Una sola API. La llamada recall() devuelve el contexto de corto plazo, largo plazo y entorno en un solo viaje de ida y vuelta, listo para insertar en tu prompt.
Store
add() guarda hechos y turnos: las palabras de tu usuario, las del propio asistente (speaker "me") o las de una persona con nombre. Se indexa al entrar, sin llamada a LLM.
Recall
recall() devuelve corto plazo + largo plazo + contexto en una sola llamada - los turnos recientes, hasta 20 memorias y hasta 20 filas de la conversación de alrededor, sin importar cuánto hayas almacenado.
Responder
Entrega ese contexto acotado a tu LLM - cualquier proveedor, tu clave.
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")
Los recuerdos llevan hablante. Por defecto son las palabras de tu usuario, speaker "me" guarda lo que dijo el propio asistente, y un nombre como "Bob" recuerda quién lo dijo, para poder recordar por persona.