AgentXPay 技能

让 AI Agent 具备在 Monad 区块链上自主发现 AI 服务、链上付费、管理钱包的能力。

核心机制：通过 x402 协议（HTTP 402 Payment Required），Agent 发送请求 → 收到 402 → 自动链上支付 → 携带交易哈希重试 → 获取 AI 服务响应，全程无需人工介入。

前置条件

在使用本技能前，需要确保以下配置可用：

1. 2. 依赖：@agentxpay/sdk、ethers v6

可用工具清单

本技能提供以下 7 个工具，AI 可根据任务需要选择调用：

工具 1: agentxpaydiscoverservices

用途：在 Monad 链上发现已注册的 AI 服务。

参数：

返回：{ services: [...], totalCount: number }

使用场景：用户问有哪些 AI 服务可用、找一个图像生成服务时调用。

执行方式：运行 scripts/run-tool.ts discover_services {category:LLM}

工具 2: agentxpaypayand_call（核心工具）

用途：通过 x402 协议自动付费调用 AI 服务端点。

参数：

返回：{ status, data, payment: { txHash, amount, serviceId }, latencyMs }

工作流程：

1. 1. 向目标 URL 发送 HTTP 请求
2. 若收到 HTTP 402 响应，解析 X-Payment-* 响应头
3. 自动调用 PaymentManager 合约完成链上支付
4. 携带 X-Payment-TxHash 重新发送请求
5. 返回 AI 服务响应 + 支付凭证

使用场景：用户说帮我调用这个 AI 接口、用 GPT-4 回答问题时调用。

执行方式：运行 scripts/run-tool.ts payandcall {url:http://...,method:POST,body:{prompt:hello}}

工具 3: agentxpaysmartcall（推荐：一步到位）

用途：智能发现 → 选择最优服务 → 自动付费调用，一步完成。

参数：

返回：{ selectedService: {...}, response, payment, latencyMs }

使用场景：用户描述一个需要外部 AI 服务的任务，但没有指定具体服务端点时。这是最常用的工具。

执行方式：运行 scripts/run-tool.ts smart_call {task:生成赛博朋克猫图片,category:Image}

工具 4: agentxpaymanagewallet

用途：创建和管理 Agent 智能合约钱包，包括授权/撤销 Agent 地址和通过钱包余额支付服务。

参数：

返回：{ walletAddress, balance, dailyLimit, dailySpent, remainingAllowance, txHash, agentAddress?, isAuthorized?, paymentServiceId?, paymentAmount? }

操作说明：

• - create：创建新的 Agent 智能钱包，设置每日支出限额
• fund：向钱包充值 MON
• getinfo：查询钱包余额、每日限额、今日已花、剩余额度
• setlimit：调整每日支出限额
• authorizeagent：授权一个地址（Agent）从该钱包支出
• revokeagent：撤销一个地址的钱包支出权限
• pay：通过钱包余额调用 PaymentManager.payPerUse 支付服务（需先授权）

使用场景：用户说创建一个 Agent 钱包、授权某个地址使用钱包、用钱包余额支付服务时调用。

工具 5: agentxpay_subscribe

用途：订阅链上 AI 服务的周期性计划。

参数：

返回：{ subscriptionId, planName, price, txHash, hasAccess }

使用场景：用户说订阅这个服务、我想包月使用时调用。

工具 6: agentxpaycreateescrow

用途：为定制 AI 任务创建链上资金托管。

参数：

返回：{ escrowId, amount, deadline, txHash }

使用场景：用户说我有一个定制任务需要先锁定资金时调用。

工具 7: agentxpaygetagent_info

用途：查询当前 Agent 的钱包地址、余额和网络信息。

参数：无

返回：{ address, balance, network }

使用场景：用户问我的钱包地址是什么、余额还有多少时调用。

标准操作流程 (SOP)

场景 A：用户需要调用外部 AI 服务

步骤 1: 调用 agentxpaydiscoverservices 查看可用服务和价格
步骤 2: 向用户展示服务列表和价格，确认是否继续
步骤 3: 用户确认后，调用 agentxpaypayandcall 或 agentxpaysmart_call
步骤 4: 返回 AI 服务响应 + 支付交易哈希

场景 B：用户直接描述任务（推荐）

步骤 1: 调用 agentxpaysmartcall，传入任务描述和可选的类别/预算
步骤 2: 技能自动发现服务 → 选择最优 → 付费调用
步骤 3: 返回结果给用户，附带所选服务信息和支付凭证

场景 C：用户要管理 Agent 钱包

步骤 1: 调用 agentxpaymanagewallet action=get_info 查看当前状态
步骤