自管理代理内存 (Lakebase)

Warning

这是一种遗留方法。 对于新智能体,请使用智能体记忆和智能体会话,Azure Databricks 会在 Lakebase 上为你运行这些。 想了解更多关于旧版代理产品的信息,请参见 “旧版代理产品”。

自主管理的代理内存使用 Databricks Lakebase(一种完全托管的 Postgres OLTP 数据库)作为代理的持久化内存存储。 如果需要直接访问内存(例如,将内存与现有数据管道集成或使用自定义架构),或者需要由 Lakebase 支持的短期内存,请使用此方法。 此方法要求你管理数据库架构、连接设置和访问控制。

如果你不需要直接的 SQL 访问或自定义模式,请改用 智能体记忆,由 Azure Databricks 为你管理。 有关这两种方法的比较,请参阅 代理内存。

Requirements

短期和长期记忆

自托管内存同时支持短期内存和长期内存,可以使用以下任一或两者生成代理:

  • 短期内存 使用线程 ID 和检查点捕获单个会话会话中的上下文。 它在一次会话中为后续问题保留上下文。
  • 长期内存 提取并存储多个会话中的密钥信息。 它基于过去的首选项对交互进行个性化设置,并构建一个知识库,以改进随时间推移的响应。

有关内存类型的工作原理的详细信息,请参阅 代理内存。

具有短期和长期内存的代理

开始

要在 Databricks 应用上创建带内存的代理,可以克隆预构建的应用模板,并按照 使用遗留代理服务器在 Databricks 应用上运行代理中描述的开发流程进行操作。 以下模板演示如何使用常用框架向代理添加短期和长期内存。

LangGraph

克隆 代理-langgraph 高级 模板,以生成具有短期内存和长期内存的 LangGraph 代理。 模板使用 LangGraph 的内置检查点与 Lakebase 来进行持久状态管理,包括基于线程的对话上下文和跨会话的持久用户见解。

git clone https://github.com/databricks/app-templates.git
cd app-templates/agent-langgraph-advanced

OpenAI 代理 SDK

克隆 agent-openai-advanced 模板,以使用具有短期内存的 OpenAI 代理 SDK 生成代理。 模板使用 Lakebase 进行持久状态管理,通过自动聊天历史记录管理支持有状态多回合对话。

git clone https://github.com/databricks/app-templates.git
cd app-templates/agent-openai-advanced

长时间运行智能体的后台执行

高级模板 agent-langgraph-advanced 和 agent-openai-advanced 通过 LongRunningAgentServer 中的 databricks-ai-bridge 利用短期内存和长时间后台执行扩展基本模板。 它们新增了后台模式和流式模式,使代理任务在 Databricks Apps HTTP 连接超时后仍可继续运行,并支持通过轮询或恢复流式连接来获取结果。 有关完整的客户端协定,请参阅 高级模板自述文件。

部署和查询代理

配置好带内存的代理后,按照 使用遗留代理服务器在 Databricks Apps 上运行代理 中的步骤,在本地运行代理,评估并部署到 Databricks Apps。

其他资源