ClouisleClouisle

教程:工作流自动化

构建一个接收请求、分类、调用 API 并返回结果的工作流

本教程构建一个“工单分流”工作流:接收用户输入,用问题分类节点判断优先级,调用知识库和外部 HTTP API,最后输出工单结果。

前置条件

当前团队有 chat 模型、至少一个已处理知识库和可调用的测试 HTTP 端点。要发布 Webhook,需要创建 API Key 并具备工作流发布权限。

最终结果

已发布工作流拥有输入变量、分类分支、知识库检索、HTTP 工具调用、输出节点和运行追踪。

工单分流工作流成品
工单分流工作流成品

步骤 1:定义开始输入

明确输入契约,后续节点才能通过变量选择器获得稳定类型。

创建工作流并选择用户输入开始节点,添加:customer_id(文本,必填)、message(段落,必填)、priority(下拉选项,可选,默认 normal)。

步骤 2:分类和分支

先分类再执行副作用操作,避免把所有请求发送到同一业务队列。
  1. 添加问题分类节点,定义 billing、technical、general 三个类别。
  2. 添加条件分支,将高优先级或技术问题导向知识库与 API 分支。
  3. 使用变量选择器连接输入和分类输出。
工作流条件分支
工作流条件分支

步骤 3:检索和调用 HTTP API

工具节点只接收必要参数,敏感凭据使用工具凭据注入。
  1. 添加知识库检索,查询使用 {message},Top K 使用 5。
  2. http_request 节点只存在于执行器层,编辑器节点面板不提供,请在能力 > 工具 > 创建工具 > HTTP API 创建一个 HTTP 工具:方法选择 POST,URL 填测试端点,超时 (秒) 保持默认 30。
  3. 回到工作流添加工具节点,选择刚创建的 HTTP 工具。
  4. 在参数配置中把 customer_id、分类结果和知识库摘要映射到工具的入参,并测试失败分支。

步骤 4:定义输出并调试

  1. 添加输出节点,映射 category、ticket_id、answer 和 sources。
  2. 打开检查清单,修复所有错误。
  3. 选择调试运行,分别测试正常请求、未知分类、API 超时和无知识库结果。
  4. 在运行抽屉查看每个节点的输入输出和错误。

步骤 5:发布 Webhook

  1. 打开工作流设置,选择 Webhook 触发器并保存。
  2. 选择发布,运行页呈现选择表单与结果。
  3. 在访问 API复制 URL。
  4. 使用 API Key 发送 JSON 请求,使用 stream_url 查看 SSE 执行事件。

验收标准

正常请求返回工单 ID;条件分支按分类执行;HTTP 失败可在追踪中定位;Webhook 只接受有效 Bearer API Key;运行日志显示节点状态、耗时和输出。

这篇文章对你有帮助吗?

本页目录