用途:connect cognee 的会话记忆与永久图谱。会话记忆是按 session_id 键控的快速缓存,写入即返回、不做 LLM 抽取;improve() 把会话内容桥接进图谱并增强图谱本身。remember() 内部会自动调用 improve(),所以通常不必手动调用。
主要能力:
- 写入会话记忆:remember(text, session_id=...) 存为 Q&A 条目;remember(cognee.QAEntry(...), session_id=...)、remember(cognee.TraceEntry(...), session_id=...) 或 @cognee.agent_memory(save_session_traces=True) 记录智能体步骤;remember(cognee.FeedbackEntry(...), session_id=...) 或 cognee.session.add_feedback(...) 记录反馈;cognee.session.get_session(session_id, last_n=...) 读取会话。
- 会话感知查询:recall(query, session_id=...) 先查会话缓存再查图谱。
- 显式桥接:cognee.improve(dataset="main_dataset", session_ids=["chat_1"])。
- 九个有序阶段:feedback_weights、persist_session_qa(唯一致命阶段)、persist_agent_traces、extract_agent_context、distill_sessions、update_user_preferences、build_truth_subspace、triplet_enrichment、global_context_index。1–7 阶段需 session_ids;8、9 仅作用于图谱。
使用要求:需 CACHING=true(默认),缓存后端 CACHE_BACKEND 可取 sqlite(默认)、postgres、redis、fs、tapes;会话按 SESSION_TTL_SECONDS 过期(默认 7 天)。脚本退出前可 await cognee.wait_for_background_tasks()。improve() 返回 ImproveResult,可按 status、stages、stage_summary() 等查看各阶段结果。
适用场景:对话/智能体记忆持久化、把会话学习提炼进图谱、按用户偏好个性化、全局上下文索引。
限制:不带 session_ids 的 improve(dataset) 通常所有阶段 skipped,属正常;类型化条目不会自动触发 improve;同一数据集或会话的 improve 加锁,重入立即返回 lock_held,锁仅进程内有效,不跨多个 API worker 共享;会话桥接每用户每会话只做一次;CACHING=false 时会话写入只告警或报 RuntimeError;第 2 阶段失败会抛出(HTTP 409)且携带 .improve_result;远程模式下后台 improve 为 fire-and-forget、status 长期 running 且无轮询;IMPROVE_STAGES_DISABLED 校验未知阶段名或 persist_session_qa 会抛 ValueError。相关设置包括 IMPROVE_AUTO_ENABLED、IMPROVE_DEBOUNCE_ENTRIES、IMPROVE_DEBOUNCE_SECONDS、IMPROVE_FEEDBACK_ALPHA 等。