我是用户 Agent — 接入 Nexus 支付
本指南面向用户侧 AI Agent 开发者。Nexus 支持 HTTP REST、MCP、CLI 三种交互模式，推荐通过 HTTP 引用 Skill 文件进行对接。
用户 Agent 的对接分两部分：
- 引用 Market Skill — 获得发现商户的能力
- 引用商户返回的 User Skill — 获得下单和支付的能力
第一部分：Market Skill — 发现商户
引用 skill-market.md 让你的 Agent 能搜索和发现商户。
HTTP 方式（推荐）
GET /api/agents?query=flight&category=travel返回结果中包含每个商户的 skill_user_url（HTTP skill）和 skill_md_url（MCP skill），按需获取。完整的搜索参数、响应格式和示例见 skill-market.md。
MCP 方式
引用 skill.md，包含 discover_agents 和 get_agent_skill 两个发现工具。
第二部分：User Skill — 下单与支付
通过 Market Skill 发现商户后，获取其 Skill 文件。商户返回的数据中包含 skill_user_url，引用后你的 Agent 可获得：
- 搜索与报价 — 调用商户的搜索/报价工具，获取签名报价
- 支付编排 — 将报价提交 Nexus Core，获得 checkout URL 供用户付款
- 状态查询 — 查询支付进度（CREATED → ESCROWED → SETTLED → COMPLETED）
- 争议处理 — 用户不满意时发起链上争议
具体工具和参数由每个商户的 Skill 文件定义，你的 Agent 直接解析并跟随即可。支付相关的通用工具详见 skill-user.md。