ADK-TS x402：使用链上加密货币支付的人工智能代理

AI 代理正变得更智能、更快速、更有用，但他们仍在为支付问题而苦恼。代理如何为 API 调用付费？

什么是 x402 支付协议？

x402 协议是 Coinbase 的一项开放标准，它使HTTP 402 Payment Required可用于现代网络。

流程非常简单：当您请求付费资源时，服务器会回复一个 402 Payment Required 响应，告诉您具体的支付金额、使用的令牌（如 USDC）以及发送到哪里、USDC）以及发送地点。然后，您的客户端会在链上进行支付，并在 X-PAYMENT 标头中提供支付证明后重试请求。最后，服务器会验证付款并解锁内容或 API。

这就为互联网创建了一个由加密货币小额支付驱动的通用支付访问系统。

*x402小额支付如何为数字内容服务：请求付费资源 → 需要 402 付款 → 付款 → 再次请求付费资源 → 即时解锁。*

What is ADK-TS？(适用于 TypeScript 的代理开发工具包）

ADK-TS 是一个用于构建人工智能代理的 TypeScript 框架，旨在为开发人员提供一个稳健、类型安全的基础，适用于从简单聊天机器人到复杂多代理系统的各种应用。

该框架提供了对多种人工智能模型（OpenAI、Claude、Gemini 等）的内置支持，以及内存、流和会话管理的基本工具。

它的与众不同之处在于其与外部服务和 API 的无缝集成能力。

谁是 IQ AI？

在 IQ AI，我们正在构建代理令牌化平台--一个可对 AI 代理进行令牌化、交易和货币化的市场。开发人员可以发布代理、公开高级功能，甚至使代理能够相互交易。

要实现这一目标，代理需要具备无缝收费和支付的能力。

ADK-TS 和 x402 如何协同工作

当您将 ADK-TS 代理与x402 协议相结合时，您将获得一项新功能：代理可自动在链上收费和支付。我们的启动模板通过三个和谐工作的关键组件展示了这一点：

服务器充当 x402 支付墙代理，定义免费和付费 API 路由，同时执行定价和验证支付。
代理使用 ADK-TS 构建，可智能地将免费工具用于基本操作，将付费工具用于高级功能。
客户端采用与钱包集成的 axios 中间件来处理 x402 支付挑战，在 Base testnet 上以 USDC 进行链上支付，并通过证明重试请求。

用户体验感觉天衣无缝：

代理向您问好并提供免费信息，例如当前的 API 价格。
当您请求一个付费操作时，它会清楚地说明价格并请求批准。
一旦获得批准，付款将自动进行，并返回结果。无需订阅。

Understanding the Setup

此模板最优雅的方面之一是定价和支付逻辑位于服务器上，而不是埋藏在代理代码中。这一架构决策带来了显著的优势：

您可以在不重新部署代理的情况下更改定价
代理保持清洁，并只专注于使用工具而非强制付款
- 服务器组件充当 x402 支付墙代理，将请求转发到 IQ AI API，同时执行定价并公开免费的 /api/get-prices 路由，因此代理可以在要求付款之前始终显示成本。
- 代理组件是使用 ADK-TS 工具构建的 TypeScript 代理，具有免费和付费功能。
- 付费工具--GET_AGENT_INFO、GET_AGENT_STATS、GET_HOLDINGS 和 GET_TOP_AGENTS--在返回结果之前需要在链上付费，从而在免费探索和高级洞察之间形成了自然的划分。

server/src/index.ts定义了定价地图（PAID_ROUTES）和支付中间件，从而创建了系统的经济支柱。
agent/src/agents/IQ-x402/tools.ts使用支持 x402- 的 axios 客户端实现了免费和付费工具。
最后，agent/src/agents/IQ-x402/agent.ts包含了主要的代理逻辑，用于问候用户、主动获取价格，以及在拨打任何付费电话前征求明确同意。

代理请求资源，服务器返回 402 Payment Required 响应。
您的钱包会提示您批准在 Base Sepolia testnet USDC 中进行小额支付。
一旦批准，代理会自动重试呼叫并交付数据。

IQ AI x402 代理模板 - 我们将 ADK-TS 与 x402 协议相结合的启动项目
IQ AI 代理令牌化平台 - 用于创建、令牌化和交易 AI 代理的平台
ADK-TS GitHub Repository - 用于构建人工智能代理的 TypeScript 代理开发工具包 (ADK-TS)
ADK-TS 文档 - 全面的指南、API 参考和示例
x402 官方网站 - x402 协议的官方网站，包括示例和更新
x402 GitHub 存储库（Coinbase） - 由 Coinbase 维护的开源实现

用户将获得透明的体验，代理可在他们批准某项操作之前预先告知他们该操作的成本。

深度挖掘：Agent Template Architecture

*ADK-TS×402模板的代码库架构：服务器层执行×402定价和支付，代理层使用免费和付费工具与用户交互。*

IQ-x402 代理模板的结构分为两个互补的部分，它们可以无缝地协同工作：从实现的角度来看，您会发现核心逻辑分布在三个关键文件中：

测试模板

一旦一切就绪，运行模板将为您提供一个由 adk-web驱动的 Web UI，您可以直接在浏览器中与代理交互。该体验完美地展示了 x402 集成的强大功能。免费操作（如获取价格）可立即生效，为用户提供即时价值和透明度。当您请求付费操作（如获取代币统计数据）时，x402 支付流程将开始运行：

*ADK-TS×402代理模板演示：代理向用户问好，显示免费价格信息，并在执行付费操作前请求付款批准。*

💡 提示：在测试前，从基础 Sepolia 龙头获取一些测试网络 USDC 和 ETH，这样您就可以在不花费真实资金的情况下体验流量。

组合的魔力 - ADK-TS + x402

真正的魔力在于 ADK-TS 和 x402 如何完美互补。ADK-TS处理智能方面的问题--内存、工作流、流和多代理协调。同时，x402将处理经济方面的问题--让您的代理通过链上小额支付来赚取、消费和解锁访问权限。通过整合，您可以设想让代理出售对其自身工具或知识的访问权限，在真正的机器对机器经济中相互支付服务费用，以及在不依赖订阅或广告的情况下按需对数据、统计或见解进行货币化。这个模板只是一个起点，但它展示了这一模型的强大功能：既智能又经济独立的代理。

用户如何使用 x402 支付（钱包流程说明）

支付体验不仅仅是服务器接收资金，用户还需要一种直观的方式来使用他们的钱包进行支付。对于人类用户，钱包弹出窗口会要求用户批准（"支付 0.05 美元 USDC？）对于自动代理，中间件可以自动支付小额交易或适当转发同意请求。一旦发送付款，重试请求将包含一个带有加密证明的 X-PAYMENT 标头。这样，加密货币小额支付就像支付咖啡一样无缝，但却是针对数字服务的。

Why-this matters for developers and the AI community

这个启动模板代表的不仅仅是一个概念验证，而是对变革可能性的一瞥。考虑一下从传统的订阅模式向按 API 调用付费的转变，在这种模式中，API 可以对每个请求收取几美分的费用。想象一下代理市场，在这里，AI 代理可以相互支付数据、模型或服务的费用。想象一下去中心化代理经济，在这里，代理可以自主地在链上赚钱、消费和交易。通过将 ADK-TS 和 x402 结合在一起，我们正在实现这样一个未来：人工智能代理不仅具有智能，而且在经济上也是自主的。

开始使用 ADK-TS x402 模板

该模板在 Base Sepolia 测试网络上运行，允许您使用来自龙头的测试 USDC 和 ETH 进行无风险实验。您将收到一个完整的设置：一个支持 x402 的服务器，包含免费和付费路由；一个 ADK-TS 代理，包含免费和付费工具；一个支持钱包的 axios 客户端，可自动处理支付。克隆它，运行 pnpm run dev，现在就开始尝试使用货币化人工智能代理：人工智能+加密货币支付=未来互联网已经等待了数十年来实现支付到访问功能的标准方式。有了 Coinbase 的 x402 支付协议，这一标准终于到来。借助 ADK-TS，我们可以将其无缝引入人工智能代理。这仅仅是个开始 - 自主、按使用付费的人工智能的未来就掌握在您的手中。

Resources

。