Warning
这是一种遗留方法。 对于新智能体,请使用智能体记忆和智能体会话,Azure Databricks 会在 Lakebase 上为你运行这些。 想了解更多关于旧版代理产品的信息,请参见 “旧版代理产品”。
自主管理的代理内存使用 Databricks Lakebase(一种完全托管的 Postgres OLTP 数据库)作为代理的持久化内存存储。 如果需要直接访问内存(例如,将内存与现有数据管道集成或使用自定义架构),或者需要由 Lakebase 支持的短期内存,请使用此方法。 此方法要求你管理数据库架构、连接设置和访问控制。
如果你不需要直接的 SQL 访问或自定义模式,请改用 智能体记忆,由 Azure Databricks 为你管理。 有关这两种方法的比较,请参阅 代理内存。
Requirements
- 在工作区中启用 Databricks 应用。 请参阅 设置 Databricks Apps 工作区和开发环境。
- Lakebase 实例。 请参阅 获取 Postgres 数据库。
短期和长期记忆
自托管内存同时支持短期内存和长期内存,可以使用以下任一或两者生成代理:
- 短期内存 使用线程 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。