# 学习路径卡：从真实业务痛点到可验证流程能力 演练平台：斑头雁 BetterYeah。 平台链接： - 官网：https://www.betteryeah.com/ - 文档：https://ai-docs.betteryeah.com/%E4%BB%80%E4%B9%88%E6%98%AFFlow.html 演练边界： - 现场只用低敏样例和演练知识库里的静态资料，先验证 Agent / Flow / Skill 的结构、路径、输出和日志。 - 不现场接真实 OA、ERP、MES、预算系统、采购系统或供应商系统。 - 真实触发、接口、权限、回写和日志留到系统集成阶段设计。 | 阶段 | 核心问题 | 案例 / 演练 | 本页产出 | |---|---|---|---| | 概念抛出 | 什么才算企业级 Agent？ | 采购预算预审互动判断 | Agent 定义 + 判断标准 | | 规划规则 | 采购流程里 10 个可 AI 化节点，是否就要 10 个 Agent？ | 人 - AI - 人、AI - AI、人 - AI - AI - 人 | Agent 数量初判 + 理由 | | 二次演练 | 换一个来料质量异常场景，还能不能规划出来？ | 来料质量异常闭环案例 | Agent 定义卡定稿 | | 提示词 | 一句话任务为什么不能直接上线？ | 提示词六段式改写 | 系统提示词定稿 | | 知识库 | 知识库为什么不是资料仓库？ | 资料归位 + 命中测试 | 知识库目录 + 5 条测试题 | | Skill | Skill 越多越好吗？ | 写 Skill 输入、返回和失败处理 | Skill 清单 | | Workflow | Workflow 先画什么？ | 画触发、节点、分支、人工断点 | Workflow 草图定稿 | | 搭建验证 | 斑头雁里先搭哪条最小路径？ | Flow 到 Agent 调用 | 最小演示路径 | | 集成验收 | Agent 最后建在哪里？ | 集成画布 + 最小验证 | 验证表 + 下一步清单 | 使用方式： - 讲解样例和练习题一般分开，避免前面讲完答案、后面还练同一题。 - 第 5 部分 Workflow 统一使用采购预算预审资料包，重点是在斑头雁里用知识库样例资料画出可验证路径。 - 先读 12-采购预算预审资料包，再填写其他材料。 - 每个演练必须留下可继续推进的材料。

# 现状流程表 | 角色 | 活动 | 所在系统 | 输入 | 输出 | 痛点 | 是否可 AI 化 | |---|---|---|---|---|---|---| | 采购员 | 填写采购申请 | OA | AGV 采购需求、报价单、拟选供应商资料、采购说明 | CG-2026-001 | 缺技术验收标准和预算例外说明 | 部分 | | 财务 | 查预算余额 | 预算系统 | 项目、科目、金额 180,000 元 | 可用余额 142,000 元，差额 38,000 元 | 切系统，手工比对口径 | 是 | | 财务 | 查历史价格 | 采购系统 | 品类、规格、数量、拟选供应商 | 同规格区间 148,000-156,000 元，本次高出上限 15.4% | 价格异常口径容易漏写 | 是 | | 财务 | 查供应商风险 | 供应商系统 | 拟选供应商名称 / 编号 | 准入有效，风险等级中，近 90 天延期 2 次 | 信息分散，难沉淀为标准意见 | 是 | | 财务 | 写预审意见 | OA | 预算、价格、供应商、附件状态 | 预审建议、依据、补件项、人工确认项 | 表达不一致，经理看不到完整依据 | 是 | | 经理 | 审批 | OA | 财务复核后的预审意见 | 通过 / 退回 / 预算例外 | 责任判断，不能交给 AI 自动完成 | 否，人工确认 |

# Agent 定义卡 Agent 名称：采购预算预审 Agent 服务对象：财务预审人员、采购经办人。 业务责任：在采购立项 / 采购申请正式审批前，基于预算、历史价格和拟选供应商风险，生成可复核的预审建议。 主案例：华东某制造公司 CG-2026-001，18 万元 AGV 搬运设备采购申请，预算可用 14.2 万元，历史价区间 14.8-15.6 万元，拟选供应商中风险，缺技术验收标准和预算例外说明。 触发条件：OA 采购申请准备提交正式审批；财务在 OA 单据页点击“生成预审建议”；用户在对话侧栏输入采购申请编号。 可以做： - 读取采购申请 / 采购单字段。 - 调用预算校验、历史价比对、供应商风险摘要等 Skill。 - 引用制度和规则。 - 输出依据、风险、建议话术、人工确认项。 不做： - 不自动审批。 - 不自动承诺供应商价格。 - 不自动调整预算。 - 不替经理或财务承担最终责任。 人工断点： - 预算不足但仍需采购。 - 历史价格差异超过阈值。 - 供应商存在风险。 - 缺字段或规则冲突。 - 缺少技术验收标准、预算例外说明、比价或议价记录。 验收指标： - 30 条样本中字段读取准确率、风险召回、越权拦截、人工复核通过率。 - 现场最小样本至少跑通 T01-T08 八类输入。

# Workflow 方案图模板 Workflow 名称： 业务场景： 本次练习目标： 演练约束： - 本次重点验证 Flow 路径、节点输入输出、异常分支和日志。 - 如果现场不接真实系统，可用低敏样例、知识库资料或固定返回代替接口。 - 这张模板只帮助你把流程画清楚，不直接给标准答案。 - 真实触发、权限、回写和审计留到系统集成阶段设计。 触发入口： - 现场演示： - 真实上线： - 谁来触发： 输入信息： | 字段 | 来源 | 是否必填 | 备注 | |---|---|---|---| | | | | | | | | | | | | | | | 节点清单： | 节点 | 作用 | 输入 | 输出 | 失败处理 | |---|---|---|---|---| | 开始节点 | 接收触发信息 | | | | | 理解 / 抽取节点 | 抽取结构化字段 | | | | | 资料 / 知识节点 | 查询规则、模板或样例 | | | | | 判断节点 | 汇总资料形成结论 | | | | | 分支节点 | 区分正常 / 异常 / 转人工 | | | | | 输出节点 | 返回结构化结果 | | | | 异常： - 缺字段： - 资料未命中 / 接口失败： - 风险命中： - 规则冲突： - 越权请求： 人工断点： - 需要谁确认： - 确认什么： 验收样本： - T01 正常： - T02 缺字段： - T03 风险命中： - T04 接口失败： - T05 越权请求：

# 采购预审 Flow 节点配置清单 目标：这份清单按斑头雁 BetterYeah Flow 当前官方手册整理，目的是让你先把一个可运行的采购预算预审演示 Flow 搭出来，再去微调话术。 边界：本练习不接真实 OA、预算、采购或供应商系统；采购申请、预算样例、历史价样例、供应商风险、预审规则、输出模板全部来自下载资料和知识库。 先准备两样资料： - `18-采购预审单据样例.docx`：作为开始节点输入时的单据样本。 - `19-采购预审知识库Word资料包.zip`：解压后把 5 份 Word 全部上传到同一个知识库。 - `22-采购预算预审规则.docx`：独立规则版，方便单独发放或单独上传。 知识库内应包含： - 采购单摘要：CG-2026-001、项目、科目、金额、拟选供应商、附件清单。 - 预算样例：项目可用余额、差额、预算例外口径。 - 历史价样例：同规格历史采购区间、样本数量、差异率口径。 - 供应商风险样例：准入状态、风险等级、延期交付记录、更新时间。 - 预审规则：字段完整性、预算不足、价格异常、供应商风险、越权请求。 - 输出模板：预审建议、依据、风险点、补件项、人工确认项。 ## 1. 统一约定 先把节点名称改成下面这一组，后面所有变量和逻辑条件都按这些名字写： - `start`：开始节点，系统默认。 - `llm_parse`：抽取采购单字段。 - `kb_lookup`：查询知识库。 - `llm_review`：生成预审结论和路由。 - `branch_route`：逻辑分支。 - `llm_draft_continue`：生成“可继续推进”草稿。 - `llm_draft_supplement`：生成“需补件”草稿。 - `llm_draft_manual`：生成“转人工复核”草稿。 - `output`：输出节点，系统默认。 为什么要先改节点名：官方文档说明，开始节点的字段名就是变量名，节点输出结果默认用节点名称作为变量名；普通节点里用 `{{变量名}}`，逻辑节点里直接写变量名，不要再加 `{{}}`。 ## 2. 开始节点 `start` 开始节点选择 `表单类型`，不要选 Webhook。默认自带的 `消息` 字段直接改造成下面第 1 个字段。 | 字段名称 | 变量名称 | 字段类型 | 是否必填 | 占位符 / 选项 | |---|---|---|---|---| | 采购申请摘要 | `purchase_request` | 文本域 | 是 | 粘贴采购申请摘要，至少包含项目、采购物料、金额、拟选供应商、附件情况 | | 当前办理角色 | `operator_role` | 单选下拉框 | 是 | 采购经办人 / 财务预审 / 业务负责人 | 调试时，可以直接把 `18-采购预审单据样例.docx` 里的正文内容粘贴进 `purchase_request`。 ## 3. 节点总连线 `start -> llm_parse -> kb_lookup -> llm_review -> branch_route` 再从 `branch_route` 分出三条线： - `continue -> llm_draft_continue -> output` - `supplement -> llm_draft_supplement -> output` - `Else -> llm_draft_manual -> output` 注意：官方文档说明 `output` 节点本身不支持自定义配置，只会把前一个节点的结果直接传出去。所以这里不要想着在 `output` 节点里再改字段，只要把三个草稿节点分别连到 `output` 即可。 ## 4. 节点逐项照填 ### 4.1 `llm_parse`：采购单抽取节点 节点类型：`LLM` 模型：任选一个支持 `JSON` 输出的文本模型；优先 `qwen-plus` 或 `deepseek-V3`。 输出格式：`JSON` 建议把创造性 / 温度调低，目标是抽取稳定，不是发挥。 提示词直接粘贴： ```text 你是采购预算预审流程里的“单据抽取节点”。 你的任务只有两个： 1. 从采购申请摘要中抽取字段。 2. 判断哪些关键字段缺失。 你不是审批人，不做“通过/驳回/转人工”的最终结论。 输入信息： - 当前办理角色：{{operator_role}} - 采购申请摘要：{{purchase_request}} 请严格输出 JSON，对象字段固定如下： { "doc_no": "", "project_name": "", "budget_subject": "", "purchase_item": "", "amount": 0, "currency": "CNY", "supplier_name": "", "attachment_list": [], "missing_fields": [], "query_text": "", "input_risk_hints": [] } 字段要求： 1. `amount` 只保留数字，不要带人民币符号。 2. `attachment_list` 只放附件名称字符串数组。 3. `missing_fields` 只列关键缺失项，例如：预算依据、技术验收标准、比价记录、供应商材料。 4. `query_text` 用一句中文搜索串，把项目、采购物料、预算科目、供应商和风险线索串起来，供知识库节点直接查询。 5. 没有的信息留空字符串、0 或空数组，不要编造。 6. 不要输出 JSON 以外的任何解释。 ``` 这个节点跑完后，重点检查 `llm_parse.query_text` 是否可读、`missing_fields` 是否真的被抽出来。 ### 4.2 `kb_lookup`：知识库查询节点 节点类型：`知识库节点` 知识库：选择刚才上传 5 份 Word 的那个采购预审演练库。 标签：可空。 查询方式：`混合查询` 查询关键词：`{{llm_parse.query_text}}` 最大结果数：`6` 结果重排：`开启` 输出方式：`文本` 这里故意选 `文本` 输出，不选 `JSON`。原因很简单：这一步只是给下一个 LLM 节点读规则、样例和模板，文本更容易直接粘过去用，现场也更稳。 ### 4.3 `llm_review`：预审判断节点 节点类型：`LLM` 模型：任选一个支持 `JSON` 输出的文本模型；尽量和 `llm_parse` 用同一类稳定模型。 输出格式：`JSON` 提示词直接粘贴： ```text 你是采购预算预审流程里的“预审判断节点”。 你要依据采购申请抽取结果和知识库命中的规则/样例，给出预审结论，但你不能替代正式审批。 输入 1：采购申请抽取结果 {{llm_parse}} 输入 2：知识库命中内容 {{kb_lookup}} 请严格输出 JSON，对象字段固定如下： { "route": "continue", "risk_level": "low", "summary": "", "basis": [], "risk_points": [], "missing_items": [], "manual_confirm_points": [], "budget_gap": 0, "price_delta_pct": 0, "supplier_risk_level": "unknown" } 判断要求： 1. `route` 只能是 `continue`、`supplement`、`manual` 三个值之一。 2. 如果关键材料缺失，或者知识库规则明确要求补充资料后再判断，`route` 输出 `supplement`。 3. 如果命中高风险、预算明显不足、价格异常、供应商风险较高、越权请求，`route` 输出 `manual`。 4. 只有在资料完整、风险可控、且没有触发人工断点时，`route` 才能输出 `continue`。 5. `risk_level` 只能是 `low`、`medium`、`high`。 6. `basis`、`risk_points`、`missing_items`、`manual_confirm_points` 一律输出字符串数组。 7. `budget_gap` 用数字；预算不足时填差额值，拿不到就填 0。 8. `price_delta_pct` 用数字；拿不到就填 0。 9. `summary` 用一句完整中文概括当前预审判断。 10. 不要输出“已审批通过”“已付款”“已定标”之类越权结论。 11. 不要输出 JSON 以外的任何解释。 ``` ### 4.4 `branch_route`：逻辑分支节点 节点类型：`逻辑分支` 按下面顺序建 3 个分支： 分支 1 名称：`continue` ```javascript llm_review.route === "continue" ``` 分支 2 名称：`supplement` ```javascript llm_review.route === "supplement" ``` 分支 3：保留系统默认 `Else` 为什么这么写：官方手册明确说逻辑分支里的条件必须是 JavaScript 表达式，而且变量不要加 `{{}}`。所以这里直接写 `llm_review.route`，不要写成 `{{llm_review.route}}`。 ### 4.5 `llm_draft_continue`：可继续推进草稿 节点类型：`LLM` 输出格式：`文本` 提示词直接粘贴： ```text 你要输出一段可直接放进 OA 的采购预审意见。 采购单抽取结果： {{llm_parse}} 预审判断结果： {{llm_review}} 请按下面结构输出，不要多写解释： 预审结论：可继续推进 依据： 1. ... 2. ... 风险提示： - ... 人工确认项： - ... 要求： 1. 语气客观、简短。 2. 只写预审建议，不写最终审批结论。 3. 如果没有明显风险，风险提示写“未见需立即中止的异常，但仍需按正式审批流程复核”。 ``` ### 4.6 `llm_draft_supplement`：补件通知草稿 节点类型：`LLM` 输出格式：`文本` 提示词直接粘贴： ```text 你要输出一段“补件后再提”的采购预审意见。 采购单抽取结果： {{llm_parse}} 预审判断结果： {{llm_review}} 请按下面结构输出，不要多写解释： 预审结论：需补件后再提 缺失项： 1. ... 2. ... 依据： 1. ... 2. ... 补充完成后再检查： - ... 要求： 1. 缺失项必须和 `llm_review.missing_items` 对齐。 2. 不要写成驳回，只写“补齐后再审”。 3. 不要输出最终审批语言。 ``` ### 4.7 `llm_draft_manual`：转人工复核草稿 节点类型：`LLM` 输出格式：`文本` 提示词直接粘贴： ```text 你要输出一段“建议转人工复核”的采购预审意见。 采购单抽取结果： {{llm_parse}} 预审判断结果： {{llm_review}} 请按下面结构输出，不要多写解释： 预审结论：建议转人工复核 触发原因： 1. ... 2. ... 依据： 1. ... 2. ... 建议由谁确认： - ... 下一步动作： - ... 要求： 1. 触发原因优先写预算异常、价格异常、供应商风险、越权请求等。 2. 明确“建议转人工复核”，不要代替人工做最终决定。 ``` ## 5. 最小调试方法 1. 先只跑 `llm_parse`：确认它真的输出了合法 JSON，而不是一段说明文字。 2. 再跑 `kb_lookup`：确认查询词不是空的，而且能命中预算、历史价、供应商风险、规则、模板这几类内容。 3. 再跑 `llm_review`：确认 `route` 只会出现 `continue / supplement / manual` 三个值。 4. 最后看 `branch_route`：如果分支没走通，先检查是不是把逻辑条件写成了 `{{llm_review.route}}`，这是错的。 5. 调试面板里优先看日志页：官方手册说明日志能看到每个节点的入参、出参和耗时；单节点运行时，除了开始 / 输出 / 逻辑节点，其他节点都可以单独调。 ## 6. 这份配置单能不能做到“复制粘贴就搭出来” 可以做到 `80% 到 90%`： - 可以直接复制的是：节点命名、表单字段、3 段 LLM 提示词、逻辑分支条件、知识库节点的查询方式和结果数。 - 仍要人工点选的是：具体模型下拉框、知识库资源本身、是否开启结果重排、分支连线。 - 如果现场有人完全照抄却还是跑不通，优先检查三件事：`llm_parse` / `llm_review` 有没有真的设成 `JSON` 输出；知识库是否已上传 5 份 Word；逻辑条件里有没有误加 `{{}}`。 ## 7. 搭建顺序复盘 1. 建 `start` 表单。 2. 建 `llm_parse`，先单节点跑通。 3. 上传 5 份知识库 Word，建 `kb_lookup`。 4. 建 `llm_review`，确认 `route` 三选一稳定输出。 5. 建 `branch_route`，按 `continue / supplement / Else` 分线。 6. 建 3 个草稿节点，分别连到 `output`。 7. 用 `18-采购预审单据样例.docx` 和 `06-最小验证表.md` 逐条复跑。

# 知识库与提示词说明 知识库放什么： - 稳定规则、制度摘要、判断口径。 - 字段说明、术语词典、SOP 片段。 - 输出模板、典型案例、边界规则。 接口查什么： - 实时库存、预算余额、在途订单、当前状态。 - 当前单据字段、实时日志、实时设备状态。 - 会随日期、角色、系统状态变化的结果。 容易误放进知识库的内容： - 某一周的实时快照。 - 这次单据的即时返回结果。 - 未来几天会变化的库存、需求、价格或状态。 这些信息更适合由系统返回、Skill 查询或样例表提供，而不是当成固定知识长期上传。 系统提示词最小结构： 1. 你是谁：说明角色和服务对象。 2. 帮谁做什么：只负责哪一步，不包揽全流程。 3. 输入是什么：用户输入、系统带入、知识命中、Skill / Flow 返回。 4. 步骤是什么：先检查、再查询 / 调用、最后汇总。 5. 输出格式：固定栏位，便于复制进系统或表单。 6. 不能做什么：越权动作、泄露规则、无依据编造都要写清。