MongoDB Blog

Introducing the MongoDB Claude SDK Session Adapter: Durable Session Storage for Agents

6.9内容质量

TL;DR · AI 摘要

Introducing the MongoDB Claude SDK Session Adapter: Durable Session Storage for Agents MongoDB The Claude Agent SDK is a...

核心要点

  • 主题聚焦:Introducing the MongoDB Claude SDK Session Adapt
  • 来源:MongoDB Blog,建议结合原文判断细节。
  • AI 分析暂不可用,本条为保底评分与摘要。
#AI#编程#前端#后端#产品
打开原文

介绍 MongoDB Claude SDK 会话适配器:为代理提供持久化会话存储 | MongoDB

Claude 代理 SDK 是一个软件包,它允许你将 Claude Code 自身的代理循环直接嵌入到你的应用程序中:无需定义这些工具或自行管理代理循环,即可实现网页搜索、文件搜索、文件编辑、MCP 服务器连接等功能。该 SDK 默认还会自动将会话记录持久化到本地文件系统。Claude 将其称为 Agent SessionStore。

今天,我们激动地宣布推出 MongoDB Claude SDK 会话适配器,目前提供 Python 版本(TypeScript 版本将于 2027 年 1 月发布)。

什么是 Claude 代理 SessionStore?

但首先,让我们理解 SessionStore 究竟意味着什么。它是 Claude 代理 SDK 中用于在代理运行的机器之外保存代理会话的扩展点。配置一个 SessionStore 后,SDK 会镜像代理工作的每一次对话回合和操作,因此会话可以在任何能够访问该存储的实例上从断开处精确恢复。

当代理不再运行在单一的持久化机器上时,这一点尤为重要。假设一个团队将 Claude 代理部署为 Lambda 函数,作为公司内部服务供各团队调用。每次调用都是一个临时实例;调用之间没有本地磁盘可以存储任何内容。没有 SessionStore 时,每个请求默认是无状态的;代理无法记住之前发生的事情。配置了 SessionStore 后,无论哪个实例处理了上一次操作,任何调用都可以恢复会话的完整历史记录。

这就是 MongoDB 会话适配器填补的空白。

对于需要在多台机器上开发代理的多个团队的企业来说,这种能力尤其有用。这些企业需要能够跨主机故障生存的会话存储,能够随着代理舰队规模扩大而扩展,并且遵循与其余数据环境相同的访问控制和保留规则,而不是为代理记忆单独构建的附加系统。

MongoDB Claude SDK 会话适配器

MongoDB Claude SDK 会话适配器为 Claude 代理提供持久化会话存储:记录对话及其操作历史,使代理无论是在同一台笔记本电脑、不同服务器还是分布式部署中的任何服务器上,都能从断开处精确恢复。

该适配器解决了三个关键领域:

  • 跨环境连续性:无论是在重启后由不同后端实例继续对话,还是用户在不同设备上恢复会话,会话状态不会保留在启动它的机器上。由于每一步操作都会实时镜像到 MongoDB,部署中的任何实例都可以从上一个实例停止的位置精确恢复。
  • 故障恢复能力:如果主机崩溃或容器在对话过程中被重新调度,不会丢失任何数据。条目会实时写入 MongoDB,而不是进行本地批处理或缓存,因此无论哪个实例恢复会话,都能看到与失败实例相同的最新完成步骤状态。
  • 数据保留与可审计性:许多团队需要保留代理对话记录以满足内部数据保留或审计要求。无需单独搭建系统,会话数据会存储在你已经在运行的 MongoDB 集群中,遵循与其余数据相同的访问控制和备份策略。

该适配器直接实现了Claude Agent SDK的会话存储接口,因此你只需在ClaudeAgentOptions中用几行代码即可将会话记录镜像到MongoDB:

Python

代码片段

from pymongo import AsyncMongoClient from claude_agent_sdk import ClaudeAgentOptions from claude_agent_sdk_mongodb_session_store import MongoDBSessionStore client = AsyncMongoClient(MONGODB_URI) store = MongoDBSessionStore(client=client) await store.create_schema() options = ClaudeAgentOptions( session_store=store, # 你代理的其他配置... )

完成。使用这些选项启动的每个会话都会被存储到MongoDB中,并可以在不同设备间恢复。每个代理本地写入;MongoDB使对话在应用实例之间可移植。

图1. 该适配器如何让你访问镜像到MongoDB的代理会话记录。

今天立即开始!

只需运行以下命令即可为你的Claude代理启用会话存储:

Shell

pip install claude-agent-sdk-mongodb-session-store

查看文档了解如何探索源码、提交问题和参与贡献。我们很期待看到你构建的内容!

附加资源:

  • Claude Agent SDK 文档
  • MongoDB 会话适配器 GitHub 仓库
  • 代理SDK概述 - Claude代码文档