Webhook 触发 Skywork 工作流的核心是事件驱动：外部系统发生事件时立即向配置的 HTTP 端点发送 POST 请求，n8n 接收后启动流程，调用 Skywork 模型处理并推送结果，全程零轮询、免人工、多源兼容。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
用 Webhook 触发 Skywork 自动化工作流，核心是让外部事件“一发生就启动”，而不是等人工点或定时轮询。关键不在调多少接口，而在选对触发点、配好身份验证、确保请求能被正确解析。
Webhook 是怎么触发 Skywork 工作流的
Webhook 本质是一个可被外部系统调用的 HTTP 端点。当你的业务系统（比如表单提交页、监控告警平台、飞书机器人）检测到某个事件（如用户提交、错误产生、审批通过），它会立刻向你配置好的 Webhook 地址发起 POST 请求，把结构化数据（通常是 JSON）推过来。n8n 或 Skywork Agent 收到后，直接启动后续流程——比如调用 Skywork-R1V 理解图片、用 UniPic 转换风格、再把结果发到 Notion 或飞书。
- 不是“轮询”：不用每分钟查一次有没有新任务，省资源、零延迟
- 不是“手动点”：无需人盯界面，真正实现事件一发生就响应
- 不是“只接飞书”：任何能发 HTTP 请求的系统都能成为触发源（网页、IoT 设备、数据库变更监听器等）
三步配出可用的 Webhook 触发入口
以 n8n 为例（目前最轻量易上手的载体），搭建一个能跑通的 Webhook 入口只需三步：
- 拖入 Webhook 节点：作为工作流第一个节点，HTTP 方法选 POST，路径自定义（如 /skywork/news-alert）
- 加认证头（生产必备）：在 Headers 里设 X-API-Key: your_secret_key，n8n 后续节点可校验该值，防未授权调用
- 定义输入结构：明确告诉下游“这次请求带了什么”。例如，若触发源发来的是含 {"url": "https://xxx.com/article", "keyword": "Skywork"} 的 JSON，就在 Webhook 节点开启 “Respond to Webhook” 模式，并勾选 “Output full request body”，确保内容完整流入后续节点
让 Skywork 模型真正“干活”的关键配置
Webhook 只是起点，真正调用 Skywork 模型能力靠的是 HTTP Request 节点。这里最容易出错的是格式与上下文：
天工 Skywork 桌面版是专为 Mac 用户打造的本地 AI 办公助手，被称为“macOS版Claude Cowork”。它无需上传云端，即可直接读取并处理本地复杂文件。产品采用本地虚拟机隔离技术保障数据安全，并创新支持 Claude 与 Gemini 双模型智能路由。内置超百项精选技能，轻松实现跨格式办公与多模态内容创作，全面赋能桌面生产力。
- URL 必须匹配模型端点：R1V 多模态用 /v1/chat/completions，UniPic 图像生成用 /v1/images/generations，不能混用
- Headers 必须带鉴权：Authorization: Bearer sk-xxx，且 key 权限需开通对应模型调用
- Body 要严格兼容 OpenAI 格式：即使传图，也要把 base64 字符串塞进 "images" 字段（非 multipart），且 "messages" 中 content 不能为空——哪怕只写“请分析这张图”
- 别跳过错误分支：HTTP 节点要配置“On error”走向，比如返回 401 就发飞书提醒密钥失效，返回 429 就暂停 60 秒重试，避免流程静默失败
从测试到上线：两个 URL 别搞混
n8n 自动生成两个 Webhook 地址，用途完全不同：
- 测试 URL：有效期仅 120 秒，请求数据直接显示在节点面板里，适合本地 curl 或 Postman 验证字段是否接收正确
- 正式 URL：工作流启用后永久有效，但数据不显示在编辑器中，需看执行日志排查问题；上线前务必关掉测试模式，否则外部系统调用会失败
上线前建议用真实场景压测一次：模拟表单提交、飞书消息、GitHub push，确认整个链路从接收→调模型→存结果→发通知，全程无卡点。
