智能体支付防超支,不能只限单笔
文章指出,单笔支付上限无法阻止循环请求或提示注入导致的累计支出,预算应在模型之外强制执行。其介绍的开源 Python 库提供按钱包与收款方滚动计费、异常支出暂缓及签名决策回执。
AI 深度解读
给 AI Agent 的每笔付款设上限,挡得住一次大额误付,却挡不住连续小额扣款。原文围绕 Python 库 sra-riskgate 1.8.0,给出的方案是:把累计预算、异常拦截和审计凭证放到模型之外,再让 Agent 按检查结果决定是否签名。
这篇值得读的地方,是它把「限制 AI 花钱」拆成了具体工程规则。但它也留下一个关键边界:当前账本存在并发竞争,能否守住硬预算,取决于支付入口怎样部署。
每笔不超过 $50,为什么钱包还是会空
使用 x402 支付 API 费用时,Agent 会为每次请求签署一份 USDC 授权。如果服务端持续索要付款,或者提示注入让 Agent 陷入循环,每笔都低于 $50,仍然可以不断扣下去。按原文描述,稳定币付款完成后无法追回,事后发现异常并不能撤销之前的损失。
作者援引 Cloud Security Alliance 在 10 月整理的 x402 SDK 问题:共 25 项缺陷,其中一项是默认客户端会按服务端要求付款,直到钱包余额耗尽。原文没有给出这里的年份、受影响 SDK 版本及修复状态,不能据此认定所有现有客户端都有同样行为。
不过,这个案例指向的设计问题很明确:收款方提出报价,不等于付款方应该接受报价。
付款规则应由付款方制定,并在模型无法自行改写的位置执行。
sra-riskgate 是 Apache 2.0 开源 Python 库,安装命令是 pip install "sra-riskgate>=1.8.0"。1.8.0 增加了滚动预算、异常暂挂、签名凭证和统一策略文件。它提供检查结果,不持有资金,也不替 Agent 签名。
累计预算要在批准时记账,批量调用也要合并检查
作者给出的示例,同时限制钱包总支出和单个收款方的累计收入:
from sra_riskgate import ActionDecision, SpendGuard, SpendLedger, check_payment
AGENT = "0x1111111111111111111111111111111111111111"
API = "0x2222222222222222222222222222222222222222"
guard = SpendGuard(
SpendLedger("~/.sra-riskgate/ledger.jsonl"), # 本地 JSON Lines 文件;省略路径则仅保存在内存中
total_limit=5.00, # 每个 Agent 钱包最多支出 $5……
per_payee_limit=2.00, # ……向单个收款方最多支付 $2……
window_seconds=86_400, # ……统计任意连续 24 小时
)
for i in range(1, 6):
r = check_payment(chain_id=8453, sender=AGENT, recipient=API, amount=0.50,
peg_deviation_pct=0.0, spend_guard=guard)
print(i, r.decision.value, r.flags)
要看的是 per_payee_limit=2.00:前四笔各 $0.50 可以批准,第五笔会使累计金额达到 $2.50,因此返回 hold,标记为 PAYEE_BUDGET_EXCEEDED。
这里的记账时机比阈值更重要。付款一获批准就占用预算,不能先拿到十次批准,再集中付款。若批准后没有实际发送,可以检查时传入 payment_id="inv-42",再调用 guard.release("inv-42") 释放占用。被暂挂或因其他原因拒绝的付款不计入预算;账本损坏或无法读取,则暂挂所有付款。
预算耗尽返回的是 hold,不是 reject。超预算只能说明需要人工查看,不能直接证明欺诈。
检查还要覆盖实际签署的对象。库通过 check_transaction() 检查原始交易或 ERC-20 转账,通过 check_authorization() 检查 x402 / EIP-3009 授权,通过 check_user_operation() 检查 ERC-4337 智能账户操作,都可传入 spend_guard=guard。
批量调用会逐项检查,再检查整体,并只记账一次。两笔向同一地址支付 $1.20 的调用,单看都低于 $2,合计却超预算,因此返回 BATCH_TOTAL 和 PAYEE_BUDGET_EXCEEDED。只检查每个子调用,会给拆单留下通道。
异常检测、凭证和配置,各自解决什么问题
累计预算管总量,异常检测管支付模式。max_payments_per_hour=60 限制支付频率,对应 RATE_SPIKE;amount_spike_factor=5 将本次金额与该钱包向同一收款方支付的近期金额中位数比较,对应 AMOUNT_SPIKE。
例如,平时每次搜索付 $0.002,突然出现 $5 请求,就应暂挂。但新收款方没有历史可比,金额异常规则不会据此判断它,需要配合 known_recipients,将未知地址标记为 NEW_COUNTERPARTY。
签名凭证回答另一个问题:检查器当时为什么放行或暂挂?
issue_receipt() 会记录决策、标记、解释、付款内容、策略哈希、时间和库版本,verify_receipt() 用于校验。使用 ReceiptSigner.hmac(secret) 时,持有同一密钥的人也能制作凭证,因此它适合验证内容完整性,不能向外部证明唯一签发者。
需要审计方独立验证时,作者建议安装 pip install "sra-riskgate[receipts]",使用 ReceiptSigner.ethereum(receipts_only_private_key),再通过 expected_signer="0xYourReceiptAddress" 校验。签收据的密钥应单独使用,地址不持有资金。
凭证证明的是检查器作出的决定,不能证明付款已经发送;链上结算要另用 verify_settlement() 检查。
规则集中到文件后,团队可以像审查代码一样审查付款权限:
{
"version": 1,
"name": "api-buying-agents",
"max_amount": 25,
"known_recipients": ["0x2222222222222222222222222222222222222222"],
"blocked_addresses": [],
"screening": {
"providers": [{"type": "chainalysis", "api_key_env": "CHAINALYSIS_API_KEY"}, {"type": "trm"}]
},
"budgets": {"window_hours": 24, "total": 50, "per_payee": 20},
"anomalies": {"max_payments_per_hour": 60, "amount_spike_factor": 5},
"ledger": "~/.sra-riskgate/ledger.jsonl"
}
要看的是 api_key_env:文件只写环境变量名,直接填写 api_key 会被拒绝。未知字段也会报错,避免把 max_amount 拼成 max_ammount 后,限制悄悄失效。
load_policy("payment-policy.json") 读取后,可用 policy.check_kwargs() 传入检查,凭证则记录 policy.sha256。安装 PyYAML 后也支持 .yaml。
Claude Desktop 和 Cursor 可以通过 uvx sra-riskgate-mcp 接入同一套 MCP 检查。预算、账本、凭证分别支持 SRA_BUDGET_TOTAL、SRA_BUDGET_PER_PAYEE、SRA_MAX_PAYMENTS_PER_HOUR、SRA_LEDGER_FILE、SRA_RECEIPT_KEY,也可用 SRA_POLICY_FILE 指定文件。同一规则同时出现在文件和独立环境变量里,会报配置错误。
我的判断
我赞同把累计预算放到模型之外。相较于提示词里写一句「最多花多少」,这套做法有明确状态、有拒绝继续付款的执行位置,也能留下可核查的决策记录。
但检查器必须成为签名前绕不过去的入口,预算才有约束力。 把它注册成 MCP 工具,并不自动保证 Agent 每次都会调用;如果付款路径可以跳过检查,工具存在也守不住钱包。
更直接的限制来自账本。作者明确承认:账本按机器保存,两次同时检查可能在任一结果写入前都通过。要实现硬限制,目前需要单进程、逐笔串行检查。对于多个 Node worker 或多台机器共享付款钱包的服务,这个前提不能忽略。原文没有给出共享账本或并发原子性的实现。
异常阈值也缺少对照数据。每小时 60 笔、金额放大 5 倍是可配置示例,作者没有报告误报率、漏报率或真实攻击测试结果。「约五分钟接入」应理解为跑通演示的说法,不能代替生产验证。
另外,预算以美元合计,覆盖 USDC、USDT、USDB、USDG。这个设计依赖它们的美元锚定属性;原文没有展开脱锚时如何估值,也没有解释示例中 peg_deviation_pct=0.0 的数据应从哪里获取。
能拿来做什么
- 给会购买 API 服务的 Agent 同时设置单笔、钱包累计和单个收款方预算,并把检查接到实际签名入口。执行端只有收到
approve才继续签名。 - 如果 Node 服务使用多个 worker,先确认预算由谁统一扣减。沿用本文实现时,应把支付检查收敛到单进程串行入口,不能让每个 worker 各自读取本地文件就认为额度已经共享。
- 在 Claude Desktop 或 Cursor 中接入 MCP 时,把策略文件纳入代码审查,检查未知收款方、配置冲突和账本损坏时是否确实停止付款。密钥通过环境变量或密钥管理服务提供。
- 将批准记录与实际结算分别核对。取消发送时释放对应
payment_id的预算占用,排查付款问题时同时查看签名凭证与verify_settlement()的链上结果。