Anchor Browser 集成 AgentCore payments,让 AI 智能体自动完成 x402 支付
Building agents that transact with Anchor Browser and AgentCore payments
Anchor Browser 与 Amazon Bedrock AgentCore payments 集成,让 AI 智能体在浏览器会话内自动完成 x402 协议的付费访问。
原文给出 x402 支付在浏览器会话内的完整接入方式,读者可据此判断智能体付费访问的工程路径。
AI 智能体越来越需要访问按请求计费的网络资源。例如,优质数据集按查询收费,研究 API 按调用次数计费,付费墙出版商将内容置于付费之后。当 AI 智能体遇到这类资源时,服务器会返回 HTTP 402 Payment Required。智能体没有内置的支付机制,会话没有附带预算,也没有以编程方式满足该请求的方法。任务因此停滞,需要人工介入。
Anchor Browser with Agentic Payments 代表智能体处理机器对机器的支付工作流。它与 AWS Generative AI Innovation Center Partner Agent Factory 合作开发,现已在 AWS Marketplace 上提供。本文介绍 Anchor Browser 如何与 Amazon Bedrock AgentCore payments 集成,使 AI 智能体能够自主为受 x402 保护的页面和 API 付费。x402 协议是一种基于 HTTP 的机器对机器支付的开放标准。服务器会返回 402 Payment Required,并附上金额、可接受的支付方式以及智能体用于完成交易的支付地址。
Anchor Browser 是专为 AI 智能体打造的基于云的浏览器自动化解决方案。每个智能体会话都在一个受管理的浏览器环境中运行,该环境维护身份验证状态、处理导航、捕获网络请求,并提供页面交互的实时视图。
Amazon Bedrock AgentCore 提供大规模构建、连接和优化智能体的能力。Amazon Bedrock AgentCore payments 是 AgentCore 中一项完全托管的能力,AI 智能体可用它自主发现、访问和支付 API、Model Context Protocol (MCP) 服务器以及网络内容。AgentCore payments 管理钱包连接,在基础设施层强制执行可配置的支出限额,并通过 x402 协议处理支付。它还通过 Amazon CloudWatch 提供对支付尝试、批准、拒绝和结算的可观测性。
当在 Anchor Browser 中运行的智能体遇到 402 响应时,AgentCore payments 会在配置的预算内授权并完成交易。工作流继续执行,不会中断。
挑战
当自主智能体遇到受 x402 保护的资源时,工作流会停滞。智能体发出请求,例如获取一份优质研究报告或调用付费数据增强 API,服务器会返回 HTTP 402 Payment Required。如果没有支付机制,本应自主运行的任务现在需要人工介入。
如今,开发者必须构建整个支付栈。这项工作涉及四类复杂性:
支付协议处理
- 从 HTTP 响应中检测并解析 402 挑战,并将需要支付的响应与其他 4xx 错误区分开来。
- 以商户期望的确切格式,用加密证明构造正确的支付头。
- 支持多种支付方案(exact、upto 及协议变体),而无需将特定于供应商的逻辑硬编码到智能体中。
- 在可能在挑战格式、支持的稳定币或结算时间上有所不同的 x402 商户实现之间保持兼容性。
安全与密钥管理
- 存储用于签署支付的私钥,需要在暴露于不可信输入的环境中安全地存储密钥。
- 管理钱包生命周期操作,包括密钥轮换、凭证刷新和提供商故障转移。
运营韧性
- 在保留会话状态、Cookie 和请求上下文的同时,使用支付头重新提交原始请求。
- 提供幂等性,这对钱包操作至关重要。
- 在并发的代理执行中,通过实时预算跟踪,强制执行每会话和每交易的支出限额。
可观测性与合规性
- 在审计日志中记录每一次支付尝试、批准、拒绝和结算,以便合规与对账。
如果没有托管支付服务,代理必须将整个支付栈内部化。在每次返回 402 响应的受 x402 保护的调用中,代理必须在内部编排完整的支付流程,包括:
- 对证明进行签名。
- 附加正确的头。
- 重试请求。
- 结算交易。
- 记录结果。
这些步骤中的每一步都需要开发人员构建、保护和维护的自定义代码。图 1 展示了这一架构。代理包含八个紧密耦合的组件(钱包、私钥、预算控制、签名证明、附加头、重试逻辑、结算支付和日志记录)。代理连接到 x402 API,402 质询向后流动,重试向前流动。
图 1:代理支付栈
安全考量不仅限于工程工作量。
不受控的支出。 如果没有在基础设施层面强制执行的硬性支出限额,一个 bug、重试循环、提示注入或无意访问都可能触发意外支付。代理在循环中重试付费端点时,会持续授权支付,直到发生人工干预。
密钥暴露。 当私钥驻留在代理运行时内时,它们与不受信任的网页、第三方工具和外部依赖共享执行环境。这些途径可能会无意中泄露控制真实资金的凭证。
签名流程暴露。 如果签名基础设施可从运行时访问,威胁行为者可以尝试访问密钥或将支付重定向到未经授权控制的地址。有效的缓解措施要求密钥从一开始就不进入运行时。
基于浏览器的代理引入了一个额外约束:支付必须在同一浏览器会话内发生。否则,会话录制和实时视图将不再与实际执行的内容匹配。
解决方案
Anchor Browser 和 AgentCore payments 通过将整个支付栈移入托管基础设施来解决这一复杂性。
与无状态工具调用不同,Anchor Browser 提供具有持久身份、可重复且确定性工作流以及可靠登录、导航和完成任务所需会话上下文的真实云浏览器。身份验证、导航、网络请求、录制和实时视图都发生在同一浏览器会话内。当需要支付时,交易会在该会话内发生。录制会捕获从请求到 402、到支付、再到内容交付的完整序列。Anchor 代理包含一个内置的 x402 工具,可在浏览器上下文中原生处理付费 API 调用。该内置工具无需对现有的基于 Playwright、Puppeteer 或 Chrome DevTools Protocol 的工作流进行任何更改。
AgentCore payments 充当支付层。该服务的核心是 Payment Manager,这是为 AWS 账户协调支付操作的顶层资源。创建 Payment Manager 需要指定授权方类型和 IAM 角色。随后,AgentCore 会在 Amazon Bedrock AgentCore Identity 中配置相应的工作负载身份。
其余组件将 Payment Manager 连接到外部钱包基础设施:
- PaymentConnector 将 Payment Manager 与外部钱包提供商集成,可以是 Coinbase Developer Platform(Coinbase CDP)或 Stripe Privy。
- PaymentCredentialProvider 将钱包提供商凭证安全地存储在 AgentCore Identity 中。
- PaymentInstrument 标识从中提取资金的具体钱包地址。
Anchor Browser 通过 AgentCore payments 使用受支持的钱包提供商设置钱包,而无需将钱包密钥或私钥放入代理运行时。AgentCore payments 通过配置的提供商处理钱包操作。对于端点发现,AgentCore 通过 Amazon Bedrock AgentCore Gateway 提供精心整理的 Coinbase x402 Bazaar MCP 服务器,使代理能够以编程方式发现可用的按使用付费 x402 端点。
AgentCore payments 重构了支付架构。敏感操作从代理运行时移出,进入托管服务层。Anchor Agent 仅保留两个与支付相关的组件:预算会话和 x402 工具。基础设施(包括身份验证、钱包密钥、支付限额、可观测性和支付证明签名)位于 AgentCore payments 层。图 2 展示了 Anchor Agent 连接到 AgentCore payments 托管层,该层处理与 Coinbase CDP 或 Stripe Privy 的钱包提供商集成。
图 2:Anchor Browser 与 AgentCore payments 集成
支付流程如何运作
以下步骤描述了从浏览器会话遇到受 x402 保护的资源,到代理收到响应并继续任务的端到端过程。
- Anchor Browser 为浏览器会话创建专用的 AgentCore PaymentSession。 当会话在开启 x402 的情况下启动时,Anchor Browser 通过 AgentCore payments 配置一个 PaymentSession,将浏览器会话链接到已配置的支付工具和预算。
- 浏览器收到 HTTP 402 Payment Required 响应。 代理导航到某个 URL,或发起 fetch 或 XMLHttpRequest(XHR)请求。商户返回 402 质询,其中指定了金额、可接受的支付方式和支付地址。
- 浏览器选择兼容的支付方式。 Anchor Browser 读取 402 质询负载,并将请求的支付方式与链接到 PaymentSession 的工具进行匹配。
- AgentCore 验证会话预算并生成加密支付证明。 AgentCore payments 验证支付金额是否在会话支出限额内。然后,该服务使用配置的钱包提供商(Coinbase CDP 或 Stripe Privy)对交易进行签名,并返回加密证明。密钥材料不会进入浏览器或代理运行时。
- 浏览器使用支付标头重试原始请求。 浏览器将签名证明附加为
PAYMENT-SIGNATURE(用于 x402 v2)或X-PAYMENT(用于 x402 v1),然后仅重试原始请求一次。 - 商户验证并结算付款,然后返回受保护的资源。商户验证加密证明,在链上结算交易,并提供内容。智能体继续执行任务。
在整个流程中,钱包凭证始终保留在 AgentCore 和所配置的钱包提供商处。
前提条件
开始之前,请确保你拥有有效的 Anchor Browser API 密钥(ANCHOR_API_KEY)。如需创建,请参阅 Anchor Browser 快速入门指南。
设置自动 x402 付款
为 Anchor Browser 设置智能体付款需要一个会话属性。将 session.x402 设置为 true。该属性默认为 false。启用后,浏览器会话可以自动访问受 x402 保护的网站,付款由 AgentCore payments 签名,并在同一浏览器会话内重试。启用 session.x402 即授权浏览器使用所配置的支付工具进行真实付款。
以下示例展示了如何使用 cURL 和 JavaScript 为 Anchor Browser 创建启用付款的会话:
cURL
curl --request POST
--url https://api.anchorbrowser.io/v1/sessions
--header "anchor-api-key: $ANCHOR_API_KEY"
--header "content-type: application/json"
--data '{"session":{"x402":true}}'JavaScript
const response = await fetch('https://api.anchorbrowser.io/v1/sessions', {
method: 'POST',
headers: {
'anchor-api-key': process.env.ANCHOR_API_KEY,
'content-type': 'application/json',
},
body: JSON.stringify({ session: { x402: true } }),
});
const { data: session } = await response.json();
console.log(session.cdp_url);通过 Chrome DevTools Protocol 连接后,智能体正常导航。你无需在自动化代码中包含钱包密钥或付款标头。浏览器会透明地处理 402 挑战、付款签名和重试,适用于文档导航、fetch 和 XHR 请求。
付款会话限制与行为
Anchor Browser 通过 AgentCore payments 集成在会话级别强制执行以下防护措施。每个可付款的浏览器会话都在配置的支出和时间约束内运行。有关具体限制,请参阅 Anchor Browser 技术文档。
如果商户响应格式错误、未提供兼容的网络、预算耗尽,或 AgentCore payments 拒绝付款,浏览器会将原始 402 响应原样返回给页面。你的自动化代码随后可以将该 402 作为标准 HTTP 错误处理。
x402 会话属性仅控制对第三方资源的付款。该属性不会替代 Anchor 积分,也不为浏览器会话付费。
Anchor Browser 的自动化代码
你为 Anchor Browser 编写的自动化代码保持不变。以下示例表明无需任何付款专用代码:
const { chromium } = require('playwright');
// Connect to the x402-enabled session via CDP
const browser = await chromium.connectOverCDP(session.cdp_url);
const page = await browser.newPage();
// Navigate to an x402-protected resource exactly as with a free page
await page.goto('https://premium-research.example.com/market-report');
// The page loaded, the payment was handled automatically
// Extract content as normal
const content = await page.textContent('article');没有钱包逻辑,没有付款标头构造,也没有重试代码。智能体导航到该 URL。如果服务器返回 402,Anchor Browser 会与 AgentCore payments 协调以签署付款证明,使用适当的付款标头重试请求,并将内容交付到页面。你的自动化代码收到最终渲染的页面,完全不会察觉发生了付款。
此模式统一适用于付费墙新闻、授权金融数据、受限 API 文档、按量计费的研究数据库,以及其他通过 402 挑战来限制内容的资源。
使用内置 x402 工具进行 API 调用
付费资源并不限于网页。许多是期望 POST、PUT 或其他 HTTP 方法的 API。常见示例包括数据增强服务、高级推理端点和授权内容 API。对于这些用例,Anchor Browser 智能体包含一个内置 x402 工具,你可以在浏览器上下文中像调用标准 HTTPS API 一样调用它。
你的 agent 通过 fetch 或 XHR 发起 API 调用。如果服务器返回 402 质询,浏览器会通过 AgentCore payments 协调支付签名,并使用已签名的支付头重试请求。你的代码接收响应时,就好像该端点免费一样。该工具不绑定特定的供应商、模型或框架。支付作为会话级能力运行在你现有工具之下,无需更改 agent 代码。
// Fetch call to a paid API endpoint within the x402-enabled session
const response = await page.evaluate(async () => {
const res = await fetch('https://data-enrichment.example.com/api/v1/enrich', {
method: 'POST',
headers: { 'content-type': 'application/json' },
body: JSON.stringify({ company_domain: 'example.com' }),
});
return res.json();
});
// If the API returned 402, AgentCore handled payment automatically
// The response contains the enriched data
console.log(response);你的自动化代码不会获得钱包凭证。仅当 session.x402 设置为 true 时,才可使用自动支付,并且仍受上一节所述支出和过期限制的约束。
主要优势
此集成将支付从应用代码移至基础设施层:
无需构建支付基础设施。无需集成钱包 SDK,无需编写 402 响应解析器,无需实现重试循环,无需维护请求头构造逻辑,也无需构建自定义审计日志。AgentCore payments 管理整个支付栈。
无需更改现有工具。Playwright 脚本、Puppeteer 自动化、Chrome DevTools Protocol 命令以及 Anchor Browser 中的 agent 流程继续像以前一样运行。支付是附加到浏览器的会话能力,而不是对 agent 逻辑、提示或工具定义的修改。
私钥不会进入运行时。签名和结算在 AgentCore payments 内部进行。该服务通过 AgentCore Identity 中的安全凭证存储与 Coinbase CDP 或 Stripe Privy 通信。agent 运行时无法访问可转移资金的密钥材料。
预算在基础设施层强制执行。每个会话都在 AgentCore 授权支付前强制执行的既定支出限额内运行。Amazon Bedrock AgentCore Observability 通过 Amazon CloudWatch 提供完整的支付审计跟踪。当会话达到支出限额时,AgentCore payments 会拒绝支付。
付费任务可成功完成。付费 GET 页面可加载。付费 API 调用可返回响应。agent 完成工作流,而不是在 402 响应处停止并需要人工干预。
账单已合并。Anchor Browser 以积分形式结算第三方 x402 费用,并与浏览器会话时间计入同一张发票。无需管理单独的加密资产托管,无需监控 USDC 余额,财务团队也无需对链上结算进行对账。
结论
Anchor Browser 与 AgentCore payments 集成后,使 AI agent 能够自主处理付费墙网页和付费 API 端点的 x402 支付质询。钱包凭证不会进入 agent 代码,也无需自定义支付基础设施。
随着越来越多的 Web 转向按请求定价,缺乏支付机制的 agent 无法完成涉及付费资源的任务。此集成填补了这一空白:agent 端到端完成付费工作流,在既定预算内运行,通过 AgentCore Observability 实现完全可观测性,并且运行时中不包含加密密钥材料。
要开始使用,请浏览以下资源:
- Anchor Browser 中的自动 x402 支付
- AgentCore payments 开发者指南
- AgentCore payments 与浏览器集成
- AWS Marketplace 上的 Anchor Browser
关于作者
Cher Simon
Cher 是 AWS 的首席深度学习架构师,她帮助客户、初创公司和 AWS 合作伙伴构建大规模、高性能的 AI/ML 解决方案。她是一位出版过著作的作者,专长于将 AI 研究转化为可投入生产的解决方案。
Guy Ben Simhon
Guy 是 Anchor Browser 的联合创始人兼 CPO,负责产品与战略。他专注于构建基础设施,使 AI 智能体能够可靠地与网络交互,并大规模运行真实的计算机环境。
Elay Gelbart
Elay 是 Anchor Browser 的创始及首席工程师,开创了其浏览器基础设施和核心工程。他专长于大规模浏览器基础设施、分布式系统,以及为 AI 智能体构建可靠的执行环境。
Chethan Shriyan
Chethan 是 AWS 的首席产品经理 – 技术方向。他在产品和业务管理方面拥有超过 12 年的经验。Chethan 热衷于构建和交付能为客户生活带来有意义影响的技术产品。
Peter Jiang
Peter 是 AWS 的高级软件开发人员,常驻华盛顿州西雅图。他是 Amazon Bedrock AgentCore 支付计划背后工程团队的核心成员,该计划为 AI 智能体提供支付能力。Peter 在金融和支付行业拥有超过 8 年的经验,曾推出多个涵盖银行、加密货币和智能体系统的全新项目。
来源:AWS Machine Learning Blog · aws.amazon.com

