教程:工作流自动化
构建一个接收请求、分类、调用 API 并返回结果的工作流
本教程构建一个“工单分流”工作流:接收用户输入,用问题分类节点判断优先级,调用知识库和外部 HTTP API,最后输出工单结果。
前置条件
当前团队有 chat 模型、至少一个已处理知识库和可调用的测试 HTTP 端点。要发布 Webhook,需要创建 API Key 并具备工作流发布权限。
最终结果
已发布工作流拥有输入变量、分类分支、知识库检索、HTTP 请求、输出节点和运行追踪。

步骤 1:定义开始输入
明确输入契约,后续节点才能通过变量选择器获得稳定类型。
创建工作流并选择用户输入开始节点,添加:customer_id(文本,必填)、message(段落,必填)、priority(下拉选项,可选,默认 normal)。
步骤 2:分类和分支
先分类再执行副作用操作,避免把所有请求发送到同一业务队列。
- 添加问题分类节点,定义
billing、technical、general三个类别。 - 添加条件分支,将高优先级或技术问题导向知识库与 API 分支。
- 使用变量选择器连接输入和分类输出。

步骤 3:检索和调用 HTTP API
工具与 HTTP 节点应只接收必要参数,敏感凭据使用工具凭据注入。
- 添加知识库检索,查询使用
{message},Top K 使用5。 - 添加HTTP 请求,选择
POST,URL 使用测试端点。 - 在请求体中映射
customer_id、分类结果和知识库摘要。 - 设置超时
30秒并测试失败分支。
步骤 4:定义输出并调试
- 添加输出节点,映射
category、ticket_id、answer和sources。 - 打开检查清单,修复所有错误。
- 选择调试运行,分别测试正常请求、未知分类、API 超时和无知识库结果。
- 在运行抽屉查看每个节点的输入输出和错误。
步骤 5:发布 Webhook
- 打开工作流设置,选择 Webhook 触发器并保存。
- 选择发布,运行页呈现选择表单与结果。
- 在访问 API复制 URL。
- 使用 API Key 发送 JSON 请求,使用
stream_url查看 SSE 执行事件。
验收标准
正常请求返回工单 ID;条件分支按分类执行;HTTP 失败可在追踪中定位;Webhook 只接受有效 Bearer API Key;运行日志显示节点状态、耗时和输出。
这篇文章对你有帮助吗?