代理基础设施：AI 代理如何在 Quicknode 上订阅、配置和构建

代理基础设施：AI 代理如何在 Quicknode 上订阅、配置和构建 AI 代理现在可以通过钱包付款、创建 Quicknode 帐户，并通过一个请求接收完整的平台 API 密钥。没有仪表板，没有人工切换。

Quicknode 2026 年 5 月 6 日 — 阅读 6 分钟

人工智能代理已经知道如何进行一次性区块链调用。为代理提供一个资金钱包，将其指向支持 x402 或 MPP 的端点，它可以读取链状态、模拟交易或提交请求，而无需先创建帐户。

那个模型很有用。它可以快速让代理上线。但它让代理人扮演了一个狭窄的角色：呼叫者。

更重要的问题是，当代理需要像操作员一样行事时会发生什么：不仅查询基础设施，而且还支持它。

这就是 Quicknode 新订阅流程背后的转变。代理现在可以创建完整的 Quicknode 帐户并在一个请求中激活订阅、接收 QN_* API 密钥并立即开始配置基础设施。无需仪表板注册，无需人工审批队列，无需在工作流程中间进行手动切换。

两条访问路径，两项不同的作业

代理访问Quicknode有两种明确的方式，它们解决不同的问题。

第一条路径是通过 x402 或 MPP 按呼叫付费访问。代理发送区块链请求，内联结算付款，并获得响应。没有帐户，没有持久状态，没有长期有效的凭据。它非常适合一次性读取、事务检查、短期自动化以及代理需要的所有核心 RPC API 访问的情况。

第二条途径是代理订阅。相同的基于钱包的支付协议在这里做了更深入的事情：它们创建一个持久的 Quicknode 帐户，将其附加到付费计划，并返回完整的平台 API 密钥。这对于一个设置步骤来说并不是一个狭窄的标记。它与人类团队通过仪表板和 API 操作 Quicknode 时使用的凭证相同，使代理能够直接访问管理 API、Streams、Webhooks、SQL Explorer、键值存储、IPFS 和跨 81 个以上链的端点配置。

换句话说：按次付费访问使代理进入该链。订阅使他们成为一流的平台运营商。

将您的代理指向此处

对于构建代理工作流程的开发人员来说，入口点应该是直接且机器可读的。这就是 Agents.md 的作用。

该页面是作为代理商的操作指南而编写的。它列出了可用的访问路径，指向订阅流，链接到 x402 和 MPP 以进行无帐户访问，并为代理提供了一条进入基础设施管理的干净路径。这是您希望助手、编码代理或编排层在开始代表您做出选择之前阅读的页面。

您可以将代理指向规范表面并让它从那里开始工作，而不是从头开始教授每个集成：

阅读 https://www.quicknode.com/agents.md。使用您的资金钱包创建 Quicknode 订阅，然后在 Solana 主网上配置一个端点，然后启用多链。

当平台发布自己的机器可读入口点时，代理可以发现当前路径，而不是依赖于您自己的代码中包含的陈旧指令。

订阅流程分为三个步骤，每个步骤都被设计为软件可读。

它始于发现。代理可以在没有付款标头的情况下调用 POST https://www.quicknode.com/api/v1/agent/subscriptions，并接收描述可用计划、接受的付款方式、网络以及继续所需的信息的 HTTP 402 响应。代理不需要抓取定价页面或脆弱的仪表板自动化来了解存在哪些选项，并且在继续之前不必分解为单独的人工注册路径。

从那里，代理使用 x402 或 MPP 进行订阅。使用 x402，付款质询通过 HTTP 402 和 PAYMENT-REQUIRED 标头显示，并且签名的付款在 PAYMENT-SIGNATURE 标头中发回。对于 MPP，挑战通过 WWW-Authenticate: Payment 出现，并且凭证返回为 Authorization: Payment 。在这两种情况下，代理都可以依靠支付 SDK 来协商交换，而不是手动构建标头。

付款清算后，订阅响应将返回 QN_* API 密钥和真实账户。没有电子邮件确认循环，没有异步批准状态，也没有第二个系统进行轮询。 200 响应意味着帐户、订阅和 API 密钥已经生效。如果需要重试请求，流程也是为此设计的：相同的电子邮件和密码解析为现有帐户，而不是让代理清理重复的状态。该代理现在具有与任何其他 Quicknode 帐户相同的访问权限。

这使得下一步必须立即进行：提供基础设施。

通过管理 API 创建新端点是代理现在可以直接执行的众多任务之一：

× 终端 □curl -X POST https://api.quicknode.com/v0/endpoints \ -H "x-api-key: QN_abc123..." \ -H "Content-Type: application/json" \ -d '{"chain":"solana","network":"solana-mainnet"}'

响应返回带有 HTTP 和 WebSocket URL（如果支持）的活动端点。如果代理想要动态选择目标，它可以首先查询 GET https://api.quicknode.com/v0/chains 以发现支持的链和网络组合，然后进行相应的配置。

付款这一步只是门槛。真正的功能是代理可以使用相同的凭据直接继续进行平台操作。

保持账户运行

配置端点是第一个里程碑，而不是关系的结束。订阅将按照代理在注册时选择的时间间隔（每月或每年）继续进行，从而将帐户保留为持久的操作上下文，而不是一次性设置工件。

学分遵循相同的模式。代理可以通过 GET https://www.quicknode.com/api/v1/agent/balance 检查余额，通过 POST https://www.quicknode.com/api/v1/agent/top_up 充值，并使用与订阅相同的 x402 或 MPP 支付协议。这为代理提供了整个生命周期的一种计费路径：启动帐户、配置基础设施、监控支出、在耗尽之前补充积分，并在整个平台上保持运营。

对于喜欢模式优先发现的代理，Quicknode 还为更广泛的平台发布了机器可读的规范。最好的起点是 API 规范，它将当前的 OpenAPI 和 OpenRPC 表面收集到一处。从那里，代理可以加载 API 规范、生成请求形状并发现操作，而无需抓取文档散文。

代理访问的下一层

基于钱包的按通话付费访问是自主软件的第一个有用的步骤。它证明代理可以直接进行基础设施交易，无需 API 密钥交接或为人类构建的帐户创建流程。

订阅是下一步。它们为代理在完整的区块链开发平台上提供了持久的操作环境。这意味着一次性 RPC 调用的脆弱包装器更少，并且有更多空间来构建可以建立自己的端点、订阅自己的数据、存储自己的状态并保持运行的代理。

如果您正在构建的代理需要执行的操作不仅仅是查询一次链，请从 Agents.md 开始，并参阅使用 AI 构建以了解有关如何在 Quicknode 上使用代理进行构建的更多信息。