内容提要
Cloudflare推出Monetization Gateway测试版,允许域名所有者通过x402协议向AI代理收费,支付以USDC在Base链结算。代理运行时需在模型外管理支出授权,设置钱包限额和单次交易上限。可变定价下,每次调用按授权上限预估,超时重试可能重复付费。开发者需自行追踪支付记录,区分重试与重复购买,并将支付与模型调用关联,以排查意外成本。
延伸解读
代理支出管控:从模型内到模型外
文章强调,代理运行时必须在模型之外管理支出授权。Cloudflare计划中的Virtual Wallets允许账户钱包所有者设置津贴、允许列表和单笔交易上限,这些限制适用于代理调用的任何工具。这意味着团队不能依赖模型自身判断是否该花钱,而应在运行时层面强制约束,避免代理在长任务中累积超支。
可变定价与重试风险:按上限预估更安全
对于可变定价,x402的upto方案要求客户端授权一个费用上限,实际费用由卖家源站报告。文章建议,在结算报告实际金额前,运行时应按每次调用消耗全部授权上限来预估。同时,超时重试可能导致重复付费,因为支付可能已在结算后完成但响应丢失。开发者需自行记录每笔支付,区分重试与重复购买。
支付记录与可观测性:追踪意外成本
一次成功的工具调用在追踪中并不显示代理沿途花了多少钱,尤其涉及重试时。文章指出,每次调用需携带支付历史,以便开发者区分两次尝试与两次购买,并将意外成本追溯到具体工作流。Cloudflare计划为卖家暴露Monetization Gateway交易日志,但买家仍需自己的遥测来关联支付与模型及工具调用。
Q&A
Cloudflare的Monetization Gateway是什么?它如何让域名所有者向AI代理收费?
Cloudflare的Monetization Gateway是一个测试版服务,允许域名所有者向AI代理收取访问API、MCP工具、网站和数据集的费用。它通过x402协议在HTTP请求中携带支付授权,并在支付以USDC在Base区块链上结算后释放资源。
代理运行时如何管理付费工具调用的支出授权?
支出授权应放在模型外部。Cloudflare计划中的Virtual Wallets允许Account Wallet所有者设置津贴、允许列表和最大交易规模,这些限制适用于代理决定调用的任何工具。客户端方面,Agents SDK的withX402Client包装器接受确认回调,在资金移动前接收支付要求,传入null则允许自动支付。
在可变定价下,代理如何预估每次调用的成本?
在可变定价下,代理应假设每次调用会消耗其授权的上限金额,直到结算报告实际金额。Cloudflare支持x402的upto方案,客户端授权一个上限,卖家源报告实际费用。例如API2PDF使用upto,因为每个PDF作业消耗不同的计算和带宽。
付费工具调用中,重试可能导致什么问题?如何避免重复付费?
如果请求在支付完成后但响应到达客户端前失败,重试可能导致重复付费。Cloudflare在网关内处理支付过程,包括需要重试的失败交易,而x402客户端在重试前检查HTTP状态和响应。代理框架需要自己的支付记录,以区分购买失败、支付成功但响应丢失以及新交易。
开发者如何追踪代理的支付记录并关联到模型调用?
开发者需要自己的遥测来将支付与触发它们的模型和工具调用关联起来。每次调用需要携带其支付历史,以便区分两次尝试和两次购买,并追踪意外成本。Cloudflare计划公开Monetization Gateway交易的日志,但这些日志面向卖家,买家仍需自己的遥测。
Cloudflare的Monetization Gateway目前支持哪些价格范围?
网关目前支持从0.001美元到100美元的价格范围。