> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developers.alephant.io/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.alephant.io/_mcp/server. # n8n 工作流 x402 端点 > 使用 Alephant 将 n8n 工作流转为可变现的 x402 端点 一条 n8n 工作流不只可以是内部自动化。如果工作流从 Webhook 节点开始并返回稳定的 JSON 响应，Alephant 就能将其封装为受治理、支持支付感知的 x402 端点，供其他开发者和智能体付费调用。 核心思路很简单： ```text 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 演示](https://www.loom.com/share/789570d2f9ff485abc07577d46614c9f) ## 准备工作 创建付费端点前，请确认你已具备： * 一条从 **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-Type | `application/json` | 使端点对买方和智能体保持可预测。 | n8n 会为 Webhook 节点同时显示测试 URL 和生产 URL。构建工作流时使用测试 URL；仅在工作流发布后使用生产 URL。 ![n8n workflow canvas with Webhook trigger and Respond to Webhook output](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/a9ad4872c27cafe3cdc2b05e0595cbaed52efb34ecfd9c83692b9a7e0ad0bd1d/docs/assets/n8n/x402-n8n-workflow-canvas.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260727%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260727T075253Z&X-Amz-Expires=604800&X-Amz-Signature=bf86d5145be7979b082f78d872f05d10038fb3705584c811e094fff4b1ba3403&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) 在本示例中，工作流以 **Webhook Trigger: SERP Ranking** 开始，以 **Respond JSON to Webhook** 结束。中间部分可以保持常规 n8n 逻辑：输入规范化、数据获取、AI 步骤、MCP 工具、抓取、数据增强或格式化。 ## 2. 定义请求与响应契约 只有调用方清楚该发送什么、会收到什么时，Alephant 才能将工作流变现。请保持 n8n Webhook 契约清晰且稳定。 请求正文示例： ```json { "keyword": "Alephant", "domain": "alephant.io", "limit": 5 } ``` 响应正文示例： ```json { "ok": true, "keyword": "Alephant", "searchQueryUsed": "Alephant alephant.io", "targetDomain": "alephant.io", "count": 5, "targetFound": true, "summary": "The target domain appears in the sampled SERP results.", "results": [] } ``` 使用 **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](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/a0d8d6bc672b5e4e9b4ab4b5a68a5f22245499ae7aceca72f3af14b9d3e222f5/docs/assets/n8n/x402-create-workflow-agent.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260727%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260727T075253Z&X-Amz-Expires=604800&X-Amz-Signature=93899320fbc0511510981dfc2259429e8f9309293a7d3483ab1a311a185852bd&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) 名称和描述应体现付费能力，而不是内部实现。例如： | 字段 | 示例 | | -------- | -------------------------------- | | 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](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/edd0d90d251fea617eab3aa8aa5a24defb1ada1bc48ced7347fe3b60c04c120e/docs/assets/n8n/x402-create-paid-endpoint.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260727%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260727T075253Z&X-Amz-Expires=604800&X-Amz-Signature=29c92a9e79870c722094d77dcadcc8d7705e2837bf0f6181869218496c3a1b77&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) 先配置端点的基本字段： | 字段 | 示例 | 说明 | | -------- | -------------------------------- | ------------------------- | | 端点类型 | `Agent Endpoint` | 该端点调用已关联的 Alephant Agent。 | | 关联 Agent | `SERP Ranking Analysis Workflow` | 选择上一步创建的 Workflow Agent。 | | 端点名称 | `SERP Ranking Analysis` | 用户会在市场或端点列表中看到此名称。 | | 端点 Slug | `serp-ranking-analysis-tool` | Alephant 会在 x402 路由下暴露它。 | | 方法 | `POST` | 与 n8n Webhook 方法相匹配。 | | 转发目标 URL | n8n 生产 Webhook URL | 仅在配置直接转发细节时需要。 | 然后完成商业配置： * 设置每次调用的价格。 * 选择你的 x402 配置支持的结算网络和资产。 * 添加请求 schema 和响应示例。 * 配置端点策略，例如速率限制、买方访问、预算护栏和滥用控制。 * 决定私有发布、内部发布还是发布到市场。 x402 使用 HTTP `402 Payment Required` 流程。调用方请求端点、接收付款要求、提交签名付款负载；通过付款验证和策略检查后即可收到工作流结果。 ## 5. 发布到市场 端点发布后，可与其他 x402 条目一同出现在 Alephant 市场中。 ![Alephant marketplace showing x402 endpoint listings](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/dc7974c11c01689bb3389ff7ad6edb4147debc7fa8b6dfd6df4dd2816419ee77/docs/assets/n8n/x402-marketplace-listing.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260727%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260727T075253Z&X-Amz-Expires=604800&X-Amz-Signature=c3af2b0b185bb8e66aabdb04bf71e4e28e69fd66fbd859825a320de4a645835e&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) 一则好的条目应说明工作流执行的具体工作： * 买方提供什么输入。 * 买方收到什么输出。 * 工作流通常需要多长时间。 * 可能涉及哪些模型、数据源或外部 API 成本。 * 结果是确定性的、由 AI 生成的，还是尽力而为的。 对于 SERP 示例，条目应明确说明端点分析关键词排名和域名可见性，然后返回其他智能体或应用程序可以消费的 JSON 结果。 ## 6. 测试付费调用 首先在私有环境中直接测试 n8n 生产 Webhook： ```bash 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 钱包和协调服务，但请求形式应保持一致： ```bash curl -X POST "https://pay.alephant.io/x402/serp-ranking-analysis-tool" \ -H "Content-Type: application/json" \ -H "PAYMENT-SIGNATURE: " \ -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/工具支出和利润。 * 请求或响应契约变化时，为端点创建新版本。 ## 相关文档 * [n8n Webhook 节点](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.webhook/) * [n8n Respond to Webhook 节点](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.respondtowebhook/) * [x402 概览](https://docs.cdp.coinbase.com/x402/welcome) * [x402 的工作方式](https://docs.cdp.coinbase.com/x402/core-concepts/how-it-works) * [付费端点](/docs/overview/monetize/paid-endpoints) * [n8n 工作流治理](/sdk-reference/workflow-integrations/n-8-n-workflow-governance)