Skip to main content
agentscope-extensions-memory-bailian 接入阿里云百炼的长期记忆服务,提供云端托管、企业级的语义记忆能力,支持 rerank、judge、rewrite 等检索增强特性。

何时使用

  • 已经在使用阿里云百炼平台,希望直接复用平台上的记忆库。
  • 关注检索质量,想启用百炼提供的 rerank / judge / rewrite 流水线。
  • 需要按 userId + memoryLibraryId + projectId 三个维度做记忆隔离。

添加依赖

快速上手

BailianLongTermMemory 实现了 AutoCloseable,建议用 try-with-resources,确保底层 HTTP 连接被释放。

检索增强开关

百炼记忆服务在召回基础上还支持三个流水线开关:
不需要的特性建议保持默认(关闭),可以减少调用延迟和费用。

消息过滤行为

百炼记忆只会写入用户和助手之间的”自然”对话:
  • 仅写入 MsgRole.USERMsgRole.ASSISTANT 消息。
  • ToolUseBlock 的助手消息(即工具调用请求)会被跳过。
  • <compressed_history> 标记的压缩历史消息也会被跳过,避免重复存储。
如果你希望让工具调用结果进入记忆,需要自己用更上层的逻辑写入,再调用 record(...)

Builder 配置参数