概览案例展示

n8n 工作流 x402 端点

以 Markdown 格式查看

一条 n8n 工作流不只可以是内部自动化。如果工作流从 Webhook 节点开始并返回稳定的 JSON 响应，Alephant 就能将其封装为受治理、支持支付感知的 x402 端点，供其他开发者和智能体付费调用。

核心思路很简单：

Buyer or agent
-> Alephant x402 Paid Endpoint
-> Alephant Workflow Agent
-> n8n production Webhook URL
-> n8n workflow execution
-> Respond to Webhook JSON result
-> Alephant trace, cost, revenue, and margin record

本页说明如何在不重写现有工作流的情况下，将其封装为付费端点。

视频演示

观看从 n8n 工作流到 Alephant x402 端点的配置过程。

打开 Loom 演示

准备工作

创建付费端点前，请确认你已具备：

  • 一条从 Webhook 节点开始的 n8n 工作流。
  • 一个生产环境 n8n Webhook URL，而不只是测试 URL。
  • 最终使用 Respond to Webhook 节点返回稳定 JSON 对象。
  • 一个可创建 Workflow Agent 和 Paid Endpoint 的 Alephant 工作区。
  • 用于接收或结算 x402 支付的钱包或结算配置。

1. 将 n8n 工作流准备为 API

在 n8n 中，Webhook 节点是外部世界与工作流之间的边界。它接收 HTTP 请求、启动工作流，并可让工作流表现为 API 端点。

对于付费端点，请将 Webhook 节点配置为公开契约：

设置建议值原因
HTTP 方法POST付费工作流调用通常发送结构化 JSON 输入。
路径稳定的路径，例如 serp-ranking-analysis该路径会成为 Alephant 转发到的运行时 URL。
身份验证请求头认证、JWT 认证或私有网络访问使用 Alephant 作为支付关卡，但仍应尽可能保护直接 n8n 访问。
响应Using 'Respond to Webhook' Node让最终节点控制状态、请求头和响应正文。
响应 Content-Typeapplication/json使端点对买方和智能体保持可预测。

n8n 会为 Webhook 节点同时显示测试 URL 和生产 URL。构建工作流时使用测试 URL；仅在工作流发布后使用生产 URL。

n8n workflow canvas with Webhook trigger and Respond to Webhook output

在本示例中，工作流以 Webhook Trigger: SERP Ranking 开始，以 Respond JSON to Webhook 结束。中间部分可以保持常规 n8n 逻辑：输入规范化、数据获取、AI 步骤、MCP 工具、抓取、数据增强或格式化。

2. 定义请求与响应契约

只有调用方清楚该发送什么、会收到什么时，Alephant 才能将工作流变现。请保持 n8n Webhook 契约清晰且稳定。

请求正文示例：

1{
2  "keyword": "Alephant",
3  "domain": "alephant.io",
4  "limit": 5
5}

响应正文示例：

1{
2  "ok": true,
3  "keyword": "Alephant",
4  "searchQueryUsed": "Alephant alephant.io",
5  "targetDomain": "alephant.io",
6  "count": 5,
7  "targetFound": true,
8  "summary": "The target domain appears in the sampled SERP results.",
9  "results": []
10}

使用 Respond to Webhook 前的 n8n 节点来规范化输出。一个好的付费端点响应应当：

  • 返回一个 JSON 对象，而不是任意的节点输出列表。
  • 包含清晰的成功或错误字段，例如 ok。
  • 避免泄露提供商凭证、原始提示词、钱包元数据或 n8n 内部执行细节。
  • 在不同工作流版本中保持字段名稳定。
  • 返回客户端可以处理的 HTTP 状态码及有用错误信息。

3. 在 Alephant 中创建 Workflow Agent

在 Alephant 中创建一个代表 n8n 工作流运行时的 Agent。

选择 Workflow Agent，然后选择 n8n Workflow 作为运行时。这会告知 Alephant：智能体执行应转发到外部 n8n Webhook，而非作为仅直接调用模型的 AI Agent 处理。

Create a Workflow Agent for an n8n runtime in Alephant

名称和描述应体现付费能力，而不是内部实现。例如：

字段示例
Agent 名称SERP Ranking Analysis Workflow
描述分析目标域名的关键词排名、竞争对手可见性和 SERP 表现。
环境Production
运行时n8n Workflow

连接运行时时，使用 Webhook 节点中的 n8n Production URL。如果 n8n Webhook 要求密钥请求头，请在智能体运行时连接中配置该密钥，以免买方看到它。

4. 创建 x402 付费端点

创建 Workflow Agent 后，创建一个新的 Agent Paid Endpoint。

Create a new Agent Paid Endpoint linked to a Workflow Agent

先配置端点的基本字段：

字段示例说明
端点类型Agent Endpoint该端点调用已关联的 Alephant Agent。
关联 AgentSERP Ranking Analysis Workflow选择上一步创建的 Workflow Agent。
端点名称SERP Ranking Analysis用户会在市场或端点列表中看到此名称。
端点 Slugserp-ranking-analysis-toolAlephant 会在 x402 路由下暴露它。
方法POST与 n8n Webhook 方法相匹配。
转发目标 URLn8n 生产 Webhook URL仅在配置直接转发细节时需要。

然后完成商业配置：

  • 设置每次调用的价格。
  • 选择你的 x402 配置支持的结算网络和资产。
  • 添加请求 schema 和响应示例。
  • 配置端点策略，例如速率限制、买方访问、预算护栏和滥用控制。
  • 决定私有发布、内部发布还是发布到市场。

x402 使用 HTTP 402 Payment Required 流程。调用方请求端点、接收付款要求、提交签名付款负载；通过付款验证和策略检查后即可收到工作流结果。

5. 发布到市场

端点发布后，可与其他 x402 条目一同出现在 Alephant 市场中。

Alephant marketplace showing x402 endpoint listings

一则好的条目应说明工作流执行的具体工作：

  • 买方提供什么输入。
  • 买方收到什么输出。
  • 工作流通常需要多长时间。
  • 可能涉及哪些模型、数据源或外部 API 成本。
  • 结果是确定性的、由 AI 生成的，还是尽力而为的。

对于 SERP 示例，条目应明确说明端点分析关键词排名和域名可见性，然后返回其他智能体或应用程序可以消费的 JSON 结果。

6. 测试付费调用

首先在私有环境中直接测试 n8n 生产 Webhook：

$curl -X POST "https://n8n.example.com/webhook/serp-ranking-analysis" \
>  -H "Content-Type: application/json" \
>  -d '{"keyword":"Alephant","domain":"alephant.io","limit":5}'

然后通过 Alephant x402 端点测试。具体客户端代码取决于所用的 x402 钱包和协调服务，但请求形式应保持一致：

$curl -X POST "https://pay.alephant.io/x402/serp-ranking-analysis-tool" \
>  -H "Content-Type: application/json" \
>  -H "PAYMENT-SIGNATURE: <signed-payment-payload>" \
>  -d '{"keyword":"Alephant","domain":"alephant.io","limit":5}'

调用成功后，请在 Alephant 中检查：

  • 付款验证和结算状态。
  • Workflow Agent 执行状态。
  • 延迟和错误率。
  • AI token 成本和外部工具成本（如果有跟踪）。
  • 收入、费用和已知利润。
  • 与端点和智能体运行关联的请求日志。

生产检查清单

在广泛推广端点前：

  • 发布 n8n 工作流并使用生产 Webhook URL。
  • 使用请求头认证、JWT 认证、IP 允许列表或网络控制，保护直接 n8n 访问。
  • 在昂贵的工作流分支运行前验证请求正文。
  • 通过 Respond to Webhook 返回可预测的 JSON。
  • 在 Alephant 中添加端点 schema 和示例，让买方知道如何调用。
  • 设置速率限制、超时预期和预算护栏。
  • 跟踪每次调用的收入、模型成本、外部 API/工具支出和利润。
  • 请求或响应契约变化时，为端点创建新版本。

相关文档