Q：为什么之前写入的记忆检索不到？

A：如果是首次添加记忆，记忆库需要 3–5 分钟完成索引构建，因此无法立刻检索到结果。请耐心等待几分钟，在记忆库中看到事件后再进行检索。
如果是多次添加记忆，请确认调用 AddSession 接口时是否使用了相同的 session_id。如果相同，新会话会覆盖原有的用户画像和事件。
若排除以上原因，请反馈给产研团队进行排查。

Q：AddSession 一次写入多少 message 比较合理？

A：建议攒多轮对话后再调用 AddSession，避免过于频繁写入带来费用增加和抽取效果不佳。目前记忆库单次最多支持 100 条 message，推荐先尝试一次写入约 100 条，再根据结果和业务需求进行调整。

Q：什么时候需要检索画像，什么时候需要检索记忆？

A：画像更新的频率较低，建议在每个 session 开始时获取一次用户画像即可，无需在每轮对话中请求；而事件记忆则建议在每轮对话中都进行检索，以确保上下文信息的完整性。

Q：建记忆库时，是为每个用户单独建一个库，还是统一写到一个库？

A：推荐将使用相同记忆抽取配置的用户统一写入同一个库，检索时通过用户 ID 进行过滤即可。

Q：为什么在 AddSession 的 metadata 中配置了用户和助手的 ID，但画像和事件仍然只归属到用户？
A：只有在 messages 中同时传入 user 和 assistant 的消息时，画像和事件才会分别归属到对应的主体。接口不会仅依赖 metadata 中的 ID 进行关联；如果只传 user 消息，事件不会自动关联到 metadata 中的 assistant。