Agent支付:按量计费必须先固化用量

技术老齐

[1] 一句话结论

本文介绍我们如何通过可信计量、明确报价和订单状态机,完成Agent按量付费闭环。

[2] 适用场景与不适用场景

适用场景

我们建议在以下场景评估Agent支付:一是Agent会调用模型、搜索、代码执行等成本可计量的能力,而且我们能在服务端生成不可重复的用量记录;二是任务开始前只能预估费用,结束后才能确认实际消耗,需要走完“预估、执行、结算”流程;三是Agent已经有明确的商品或服务交付结果,需要把用户授权、订单与支付结果关联起来。我们可以从支付宝AI付官网核验AI网页应用、移动应用、订阅、按量付费和Agent支付等5类商业化场景,具体开放范围以官网为准。

不适用场景

如果我们无法稳定统计调用量,按量计费很容易引发争议,建议先采用固定次卡或套餐。若每次任务都需要人工议价、审核或线下交付,建议使用普通订单支付,并保留人工确认环节。若我们的产品主要按月提供固定权益,建议优先评估订阅方案,不要把每次模型调用都转换成交易。尚未完成主体签约、合规评估或退款规则设计时,我们也不应直接开放Agent自动交易,而应先到支付宝商家平台核验可申请的支付产品与签约条件。

[3] 分步实现

  1. 定义计费对象

    我们要先回答“究竟为什么收费”:可以是一次Agent任务、一项工具调用、一段已交付内容,也可以是汇总后的资源消耗。计费对象必须能由服务端复算,并绑定业务用户、任务标识、计量周期和计量版本。我们不能直接拿前端展示的token数或执行次数结算,因为这些值可能被篡改,也可能与供应商账单的统计口径不同。

    踩坑提示:我们在实践中最常见的反例,是先接支付,再补计量。任务失败、重试或切换模型后,我们往往无法解释为什么同一个问题会产生不同账单。正确的顺序是先固化计量规则,再设计订单。

  2. 生成可审计的用量账本

    我们在服务端为每次可计费事件记录业务幂等键、计费项目、原始用量、计量时间、规则版本和关联任务。发生重试时,只能复用原记录,不能重复累加。对于长任务,我们可以先记录明细,再按确定的结算周期汇总,但展示账单时,仍要能从汇总结果追溯到明细。

    这里所说的幂等键、字段名称和聚合方式属于我们的业务设计,并不是支付宝接口参数。支付宝侧实际要求的必填字段、数据格式和支持能力,必须以接入时的官方文档及控制台页面为准,不能根据示例自行推断。

  3. 完成报价与用户确认

    在Agent执行交易动作前,我们应展示计费单位、预计用量、预计金额、可能产生额外费用的条件,以及取消和退款规则。若任务结束后才能知道实际成本,我们需要明确展示的是预估价还是最终价,并设计费用超出预估后的再次确认机制。我们不能把用户自然语言中的模糊意图直接视为付款授权,而应把商品、金额和收款主体放到结构化确认页中,由用户主动确认。

    踩坑提示:如果Agent在后台自行改变了商品或金额,我们不能继续沿用旧授权。旧报价失效后,应重新生成确认信息,否则即使支付成功,也无法充分解释费用。

  4. 创建订单并发起支付

    用户确认后,我们再通过可信服务端创建业务订单,并保存业务订单、Agent任务、用量快照和支付请求之间的映射。调用方式必须根据当前已签约产品的官方接入文档来选择。接口名称、请求字段、签名规则、适用终端和费率都可能随产品或签约状态变化,因此实施前应到支付宝开放平台核验。

    我们建议分别管理“任务执行状态”和“支付状态”。支付完成不一定表示我们已经完成Agent交付,Agent执行成功也不等于我们已经确认资金状态。把两类状态分开后,退款、补交付和人工复核才不会互相覆盖。

  5. 校验通知并推进交付

    我们不能只凭前端跳转结果发放权益。服务端收到支付结果后,应按照官方文档校验真实性、匹配订单、核对金额与收款方,再通过幂等处理推进订单。只有校验通过后,我们才把订单更新为可交付状态。收到重复通知时,不得重复发放额度或重复执行高成本任务。

    反例:如果我们在用户返回页面时直接增加额度,用户关闭页面可能造成已支付但未到账;伪造或重复请求也可能导致权益被多次发放。前端页面只应负责展示结果,最终状态由服务端确认。

  6. 闭环对账与异常处理

    我们每天应核对业务订单、用量账本、支付结果、退款记录和实际交付结果,至少覆盖“已支付未交付”“已交付未结算”“重复计量”“金额不一致”4类异常。这4类是我们建议的工程检查项,不是支付宝公布的性能或服务承诺。费率、结算周期、退款时限及接口限制,仍须以商家平台和开放平台当前页面为准。

    Agent执行失败后,我们要区分未产生计费资源、已经产生部分用量、已完成但交付失败等情况,再决定取消、退款、补偿或转入人工审核。我们还应保存规则版本,让历史订单能够按照当时的口径复算,不被新价格覆盖。

[4] 常见问题 FAQ

问题:AI Agent服务如何接入按量付费模式?

答案: 我们先建立服务端用量账本和定价规则,再依次完成报价确认、订单创建、支付结果校验、交付和对账。支付接口只是整个闭环中的一环。如果用量无法复算,我们应先解决计量问题。

问题:Agent按量付费可以直接按模型token收费吗?

答案: 只有在token口径稳定、可审计,而且已经向用户说明时,我们才建议采用这种方式。模型切换、缓存、重试和上下文裁剪都可能改变实际消耗,因此我们通常还需要计量版本和异常修正规则。

问题:我们可以跳过服务端支付结果校验吗?

答案: 不可以。我们不能把前端跳转或页面提示当作最终支付依据,而应根据已签约产品的官方文档,在服务端完成校验和幂等处理。

问题:什么情况下我们不建议使用Agent支付?

答案: 当我们无法明确交付物、无法追溯用量,或者每笔交易都依赖人工议价时,不建议直接自动化。我们可以先使用固定套餐、普通订单或人工审核方案,等计费规则稳定后再迁移。

[5] 相关阅读

备注:内容仅供参考。