Composio Browser Tool 与零数据保留(ZDR)项目不兼容:原因、排查与配置修复指南
Composio Browser Tool 与零数据保留(ZDR)项目不兼容:原因、排查与配置修复指南
导读
本文讲解 Composio Browser Tool 的一个关键运维限制:Browser Tool 依赖持久化浏览器 Profile 维护会话状态,因此无法在启用了零数据保留(Zero Data Retention,ZDR)或“移除执行数据”的项目中正常工作。文章会依次说明该限制的成因、两条可落地的修复路径(迁移项目 / 调整日志存储设置)、对应的 Dashboard 操作路径与 API 参数 log_visibility_setting: show_all,并结合仓库中的日志存储行为文档与项目配置 API 示例,帮助你快速定位并修复因数据保留策略导致的浏览器工具失效问题。
问题现象:Browser Tool 在 ZDR 项目中无法工作
官方知识库对这一问题有明确表述(见 原始知识源文档 与 知识库指南版本):
Browser Tool requires persistent browser profiles to maintain session state, so it is incompatible with projects configured for Zero Data Retention or removal of execution data.
即:Browser Tool 需要持久化浏览器 Profile 来维持会话状态,因此它与配置为零数据保留(ZDR)或移除执行数据的项目不兼容。
在实践中,这意味着当你把 Browser Tool 相关的执行放到一个启用了“Don't store data / 移除执行数据”的项目下运行时,浏览器自动化任务可能无法正常维持登录态、Cookie 或会话上下文,表现为会话丢失、重复登录或执行失败。
根因:持久化 Profile 与“不留数据”策略天然冲突
Browser Tool 本质上是一个执行浏览器自动化的工具:它在远程浏览器环境中模拟真实用户操作,而这些操作依赖浏览器 Profile(包括 Cookie、LocalStorage、IndexedDB、扩展状态等)在多次调用之间保持连续。
- 持久化浏览器 Profile 是维护会话状态的前提——没有它,每次执行都相当于一个全新浏览器,无法延续上一次的登录与页面状态;
- 零数据保留(ZDR)或“移除执行数据” 的策略要求执行数据不被存储,这与持久化 Profile 所依赖的“状态需要被保存、可恢复”的机制直接冲突。
因此,二者在项目级配置上互斥:要么关闭数据移除策略让 Profile 得以持久化,要么把 Browser Tool 放到一个不做数据移除的项目中运行。
解决方案一:将 Browser Tool 迁移到未启用 ZDR 的项目
最直接的修复方式是将 Browser Tool 的使用迁移到一个没有启用 ZDR(或未配置移除执行数据)的项目:
- 在 Composio 中创建一个未启用“Don't store data / 移除执行数据”的新项目,或确认某个已有项目未开启该策略;
- 将 Browser Tool 的调用、认证配置与连接迁移到该项目下;
- 在迁移后重新测试一次浏览器自动化执行,确认会话状态可以跨调用保持。
这种方案适合 Browser Tool 是唯一受影响工具的团队:把“需要持久化状态”的工作负载与“需要严格数据移除”的项目隔离,避免在同一个项目中反复切换策略。
解决方案二:调整项目的日志存储 / 数据可见性设置
如果 Browser Tool 必须留在当前项目中,可以将项目的日志/数据可见性设置从“移除执行数据”改为“存储/展示全部日志”——前提是政策允许。
Dashboard 操作路径
在控制台中按以下路径修改:
Project Settings → Log storage configuration(日志存储配置)
将数据可见性策略从“移除执行数据”切换为“存储/展示全部日志”。
API 设置
项目级配置中对应字段为 log_visibility_setting,将其设置为 show_all:
{
"log_visibility_setting": "show_all"
}
这一字段属于项目配置(Project Config)体系。仓库中的 MCP API Key 强制变更日志 展示了同类项目配置的 PATCH 调用方式,可作为参考(端点与鉴权方式一致,仅请求体字段不同):
curl -X PATCH "https://backend.composio.dev/api/v3/org/project/config" \
-H "Content-Type: application/json" \
-H "x-api-key: ak_your_api_key" \
-d '{"log_visibility_setting": "show_all"}'
设置成功后,项目配置响应中会包含该字段(如 "log_visibility_setting": "show_all"),表示执行数据不再被移除,Browser Tool 所需的持久化 Profile 状态得以保留。
深入理解:“Don't store data”到底移除了什么
在动手修改之前,理解“Don't store data”的精确语义很重要。根据仓库中的 Dashboard 日志存储行为文档(原始来源见 docs/kb/source/dashboard/log-storage/public.md):
- 审计行仍然存在:开启“Don't store data”后,新的工具执行仍会出现在 Tool Logs 中,并带有工具名、状态、时间戳、耗时、相关标识符等审计元数据;
- Payload 内容被移除:在这些审计行中,请求参数与响应 payload 内容不再被存储;
- 不追溯清理:修改该设置不会追溯清除旧的 payload。如需验证设置是否生效,应在修改后运行一次新的测试并检查新增的日志行;若新的请求/响应内容仍然可见,可带上时间戳与日志引用联系支持。
这一点与 Browser Tool 的冲突直接相关:浏览器 Profile / 会话状态本质上属于需要被持久化的执行状态,而“Don't store data”正是要移除这类数据,因此二者无法共存。
边界与合规提醒:该设置不等于合同级零保留
需要注意的是,“Don't store data”这一项目级设置并不定义所有合同层面的保留或删除窗口。仓库中的 合规、数据保留与模型训练文档 明确说明:
- 标准计划不保证端到端零数据保留或零训练;项目级“Don't store data”只减少 Composio 自身存储的内容,不约束第三方提供商在执行过程中处理或保留的数据;
- 部分工具包执行和浏览器自动化依赖第三方提供商或子处理者,数据在执行期间可能流向这些提供商,其保留与训练条款可能不同;
- 需要合同级零数据保留、无训练、DPA 或安全审查条款的客户,应使用 Enterprise 轨道,以便将这些要求显式写入范围。
因此,当你把 log_visibility_setting 改为 show_all 以恢复 Browser Tool 功能时,实际上是在项目层面放宽数据移除策略——请结合你的合规要求与政策评估这一取舍,确认存储执行数据是否被允许。
修复后的验证步骤
无论选择哪条修复路径,建议按以下步骤验证:
- 确认项目策略已变更:通过 Dashboard(Project Settings → Log storage configuration)或 API 检查
log_visibility_setting已变为show_all(或确认新项目未启用 ZDR); - 运行一次新的浏览器自动化执行:触发一次需要维持会话状态的任务(如登录后连续操作),确认多次调用之间状态可延续;
- 检查 Tool Logs:确认新执行的日志行正常记录请求与响应 payload(如果仍然看不到 payload 内容,说明设置未生效或缓存未刷新,可重新检查项目配置);
- 长期观察:确认后续会话不因数据移除而重置,同时核对该项目的日志保留是否符合你的合规预期。
总结
| 要点 | 说明 |
|---|---|
| 冲突原因 | Browser Tool 需要持久化浏览器 Profile 维持会话状态,与 ZDR / 移除执行数据策略互斥 |
| 方案一 | 将 Browser Tool 迁移到未启用 ZDR 的项目 |
| 方案二 | 将项目日志存储设置改为存储/展示全部日志(政策允许时) |
| Dashboard 路径 | Project Settings → Log storage configuration |
| API 参数 | log_visibility_setting: "show_all"(通过项目配置 API 设置) |
| 注意事项 | “Don't store data”只移除新 payload、不追溯清理、不约束第三方提供商 |
围绕这一主题,仓库中还有两份相关文档可继续深入:日志存储行为详解 帮助理解“Don't store data”的精确语义,数据保留与模型训练指南 帮助评估放宽存储策略后的合规边界。