Cloudflare Agents 正式发布
内容提要
Cloudflare推出Agents功能，整合代理部署与管理，首推代理追踪，支持OpenTelemetry兼容框架（如Think、Flue、AI SDK），提供会话回放和追踪视图，帮助开发者观察代理行为、模型调用及成本。追踪数据可导出，定价基于Workers观测，免费测试至2026年10月。
延伸解读
代理追踪的独特价值
传统应用监控只能看到HTTP请求和数据库查询，但代理可能返回200却仍失败，比如选错工具或陷入重试循环。代理追踪新增了模型调用、工具执行、审批事件等跨度，并附带模型和令牌数等元数据，让开发者能定位问题根源，而不仅仅是看到表面症状。
会话回放与追踪的互补
会话回放展示完整对话记录，包括系统指令、模型思考、工具调用及结果，帮助理解代理的决策过程；追踪则显示执行瀑布流，关联代理操作与底层基础设施（如D1、KV）。两者结合，既能从宏观上把握代理行为，又能深入微观执行细节，便于调试和优化。
数据隐私与成本考量
消息和工具负载可能包含个人信息或敏感数据，可通过storeMessages和storeTools关闭记录。追踪数据可导出到任何OTLP兼容平台，用于评估和分析，但需注意每个跨度都计为可观测性事件，免费期至2026年10月，之后将按Workers Observability定价，需关注成本控制。
Q&A
Cloudflare Agents 是什么？
Cloudflare Agents 是 Cloudflare 推出的一项功能，旨在帮助开发者部署和管理托管在 Cloudflare 上的代理（agents）。它提供了一个统一的界面来查看所有代理会话，并提供了代理追踪等可观测性工具，以帮助开发者理解代理行为、模型调用和成本。
Cloudflare Agents 的代理追踪支持哪些框架？
代理追踪目前支持 OpenTelemetry 兼容的代理框架，包括 Think、Flue 和 AI SDK。未来将支持任何符合 OpenTelemetry 标准的工具包。
如何在 Cloudflare Workers 上启用代理追踪？
首先，在 wrangler.jsonc 配置文件中启用追踪：设置 observability.traces.enabled 为 true。然后根据使用的框架进行额外设置：对于 Think 和 Flue，使用它们的追踪集成；对于 AI SDK，使用 Cloudflare 的 wrapAISDK() 适配器；对于自定义框架，使用自定义 spans API 并遵循 OpenTelemetry 的生成式 AI 语义约定。
Cloudflare Agents 的追踪数据可以导出吗？
可以。追踪数据可以导出到任何支持 OTLP 的提供商，只需在 Worker 的 Wrangler 配置文件中配置目标即可。
Cloudflare Agents 的定价是怎样的？
代理追踪基于 Workers 追踪，目前处于测试阶段，免费使用。从 2026 年 10 月 1 日起，将纳入 Workers Observability 定价：Workers Free 计划每天包含 200,000 个事件，保留 3 天；Workers Paid 计划每月包含 2000 万个事件，超出部分每百万个事件收费 0.60 美元，保留 7 天。
Cloudflare Agents 的会话回放功能有什么作用？
会话回放功能允许开发者查看代理会话的完整对话记录，包括系统指令、用户消息、模型思考、工具调用及其参数和结果，以及最终响应。这有助于开发者发现工具参数错误、理解工具选择时的上下文、查看子代理的交接，以及识别早期回合对后续结果的影响。
Cloudflare Agents 的追踪视图能展示哪些信息？
追踪视图以瀑布图形式展示代理执行的详细信息，包括每个代理调用的耗时、模型调用（含 token 使用量）、工具执行、以及底层 Workers 基础设施操作（如 D1 查询、KV 写入）。这有助于开发者分析时间消耗和性能瓶颈。
