用途:为已搭建好的智能体添加持久化、跨会话的长期记忆,记忆按用户隔离,底层使用 Databricks 托管的 Unity Catalog 记忆存储(memory-store REST API),受 UC 治理。该技能是附加项,不负责搭建智能体;若尚无 .env(未配置认证),需先运行 quickstart 技能。
主要能力:暴露六个工具——search_memory、save_memory、get_memory、list_memories、update_memory、delete_memory,均为对 UC 记忆存储 API 的轻量 REST 调用。召回以搜索优先:search_memory 做语义检索并对条目做 BM25 关键词加权,返回带完整内容的排序条目,因此 list_memories 与 get_memory 是回退路径而非主召回路径。无需预置数据库、建表、配置嵌入端点,也不新增 Python 依赖(复用模板已有的 databricks-sdk)。与自托管 Lakebase 记忆不同,本技能是托管记忆;它与短期/会话记忆(OpenAI AsyncDatabricksSession 或 LangGraph checkpointer)叠加,但长期记忆系统只应有一个,若模板已有需先移除。框架无关,兼容 OpenAI Agents SDK 与 LangGraph。
使用方式:先创建或确认记忆存储(POST /api/2.1/unity-catalog/memory-stores 或 GET 确认),将完整名 catalog.schema.name 写入 .env 与 databricks.yml 的 config.env(DATABRICKS_MEMORY_STORE)。再通过权限 API 为开发者用户和部署后的应用服务主体授予 READ_MEMORY_STORE 与 WRITE_MEMORY_STORE。工具代码放入 agent_server/utils_memory.py,scope 由可信代码设定(部署时用 OBO 转发令牌取当前用户 id,本地用 X-Forwarded-User 或 custom_inputs.user_id),绝不由模型选择。
适用场景:Databricks Apps 上已有智能体、需要按用户或团队共享的长期记忆。
限制:记忆存储 API 处于 beta,行为可能变化;scope 是隔离边界,服务主体可见所有 scope,必须失败关闭;DAB 尚无 MEMORY_STORE 授权,需直接调用权限 API。