0读前必读与术语 Read me first

这份手册面向智能体开发人员 / 实施顾问，目标只有一个：让你拿到客户的业务描述后，能在最短时间内判断「用哪个能力、建什么表、配什么任务、画什么流程」，并稳定交付上线。手册不讲销售话术，只讲机制与做法。

0.1 平台的两块拼图

0.2 五个必须分清的概念

0.3 一条必须记住的判定链

客户说的一句话需求
   ↓ ① 归到 11 种任务类型之一
   ↓ ② 判定是否属于「3 执行操作 / 9 自动操作 / 10 间隔取数 / 11 定时监控」
   ↓      是 → 必须设计流程        否 → 只需配置知识库 + 数据表权限
   ↓ ③ 设计底座数据表（基础表 → 业务表 → 应用表）
   ↓ ④ 编排流程节点（拍视频生成草稿 → 人工校准）
   ↓ ⑤ 测试环境运行 → 交付客户正式上线 → 开启任务监控

1十分钟建立心智模型 Mental model

把平台想成三层楼，数据从下往上流，指令从上往下走。搞清楚这三层，后面所有功能都有归属。

1.1 三层架构

1.2 一次任务执行的完整时序

开发时脑子里要有这条时间线，任何一步掉链子都能定位到具体环节：

1.3 开发视角的"五件套"

无论客户场景多复杂，你手上能用的武器就这五件，缺哪件就补哪件：

2从 0 到 1 搭第一个业务智能体 Quick start

本节用一个真实高频需求贯穿全程，照着做一遍，后面所有章节都是它的展开。

2.1 七步实操

1. 需求采集：问清 8 个问题
   别急着动手，先问透。这 8 个问题决定了后面全部配置：
   ① 数据从哪来（系统名 / 网址 / 有无 API）？② 多久做一次、几点做？③ 做给谁看？④ 现在的表格长什么样（要一份样本）？ ⑤ 涉及哪些主数据（客户/产品/仓库/员工）？⑥ 有没有判断规则（什么情况不算、什么情况要标红）？⑦ 做完要通知谁、以什么形式？ ⑧ 出错时希望怎么处理（重试 / 告警 / 停下等人工）？
2. 场景归类：命中「10 间隔取数任务」+「6 查数据」
   每天定时从外部取数落库 = 间隔取数任务；员工随时问"某个客户本月多少单" = 查数据。 前者必须设计流程，后者不用流程，配好数据表与知识即可。一个智能体可以同时挂两类任务。
3. 建底座表：2 张基础表 + 1 张业务表 + 1 张应用表
   先建主数据再建流水，顺序不能反。
   · BASE_CUSTOMER 客户基础表：客户编码（唯一主键）、客户名称、销售负责人、账期
   · BASE_PRODUCT 产品基础表：产品编码（唯一主键）、产品名称、规格、单位、分类
   · BIZ_SALE_ORDER 销售订单业务表：订单号（唯一主键）、下单日期、客户编码、产品编码、数量、单价、金额、销售员
   · APP_SALE_DAILY 日汇总应用表：统计日期、客户编码、产品编码、总数量、总金额（来自业务表聚合查询）
4. 配字段规则与计算函数
   把"人肉算"的部分交给字段：
   · 金额字段配置 计算={单价}*{数量}
   · 客户名称配置映射取值 ← BASE_CUSTOMER.客户名称（按客户编码）
   · 订单号配置 索引=XS+{下单日期yyyyMMdd}+3位当日序号
   · 客户编码开联想，录入时输入编码自动带出名称与负责人
   · 金额字段开界面汇总，页面底部直接显示合计
5. 建智能体与任务
   智能体「销售数据助手」，类型选企业智能体，大模型 DeepSeek，运行环境 4核4G·2并发（见 4.2 选型矩阵），归属销售部。
   任务①「销售订单日同步」：类型=间隔取数任务，工作日机制=工作日双休，定时=每日 07:00，线程 1。
   任务②「销售数据问数」：类型=查数据，上架用户开启，无需定时。
6. 拍视频生成流程 → 人工校准
   让内勤按平时操作录一段 3 分钟屏幕视频（打开 ERP → 订单查询 → 输入昨天的日期 → 查询 → 导出）。 系统自动解析为流程草稿：打开 URL → 输入内容 → 点击元素 → 获取表格数据 → ……
   你需要校准四件事：① 元素定位改成稳定选择器；② 日期硬编码换成变量；③ 增加"查无数据"的失败分支；④ 尾部接上"提交写入数据"与"微信发送文件"。
7. 三态发布
   测试环境运行 跑 3~5 天比对人工结果 → 交付客户正式上线 → 交付上线并开启任务监控（见 6.1）。

2.2 本案例最终流程链路

// 任务：销售订单日同步（间隔取数任务）
开始
 ├─ login 变更账号登入状态          → 切到 ERP 账号，避免登录态串号
 ├─ web  打开URL页面                → ERP 销售订单查询页
 ├─ local 变量附值                  → 起止日期 = 昨日 00:00 ~ 23:59
 ├─ web  输入内容 ×2                → 填入日期区间
 ├─ web  点击元素                   → [查询]
 ├─ web  等待元素显示               → 等结果表格出现（超时 30s）
 ├─ if   页面元素条件判断           → 是否存在"暂无数据"
 │    ├─ 是 → chat 微信发送消息「昨日无新增订单」→ 停止任务
 │    └─ 否 ↓
 ├─ web  获取表格数据               → 得到数组 orderList
 ├─ local 取数组长度                → n
 ├─ if   数组元素索引取数           → 循环 n 次
 │    ├─ local 取数组元素            → 当前行 row
 │    ├─ data 获取系统数据条数       → 按订单号查重（幂等）
 │    ├─ if   变量值条件判断          → 已存在？
 │    │     ├─ 是 → data 更新当前数据
 │    │     └─ 否 → data 提交写入数据  → BIZ_SALE_ORDER
 │    └─ ↩ 回到数组循环
 ├─ data 生成系统报表数据           → APP_SALE_DAILY 日汇总
 ├─ data 导出excel数据文件          → 套用导出模板
 ├─ chat 微信发送文件               → 销售总监群
 ├─ chat BI页面数据汇报             → 推送今日看板
 └─ other 停止任务

2.3 交付前自检 10 问

3AI 底座数据系统 · 开发手册 Data foundation

底座是"地基"。建表质量直接决定智能体好不好用：表建错了，流程写得再漂亮也是在数据垃圾上跑。本章按"建表 → 配字段 → 配规则 → 配函数 → 配联动 → 外接"的顺序组织。

3.1建表：三类表怎么选 Table modeling

决策树

这个数据是不是"被别人反复引用"的主数据？（客户、产品、仓库、员工、科目、分类）
   ├─ 是，且变更频率低 → 基础数据表
   └─ 否 ↓
它是不是业务过程中产生的单据 / 流水 / 记录？（订单、出入库、工单、考勤、报销）
   ├─ 是，会不断增加 → 业务数据表
   └─ 否 ↓
它是不是对上面两类做条件查询 / 聚合后的结果？（日汇总、排行榜、对账差异、待办清单）
        → 应用数据表（不落原始数据，只存视图结果）

业务数据表可配置的 5 项规则

数据表的三种来源形态

3.2字段与 11 项属性 Fields

每张表自带的 8 个默认字段

建表即自动生成，无需配置，也不要删除。它们是你做权限、审计、分配的免费基础设施：

字段 11 项属性配置速查

搜索的 4 种形式

字段类型选型

3.3表规则与菜单搭建 Rules & menus

建完表要让客户用起来，需要把它挂到菜单。系统支持 5 种方式搭建菜单权限：

3.4数据三种来源形态落地方式 Data source

注：界面自动化不在"三种形态"正式分类内，但作为无 API 系统的兜底手段，实际交付中占比很高，务必配合 5.14 的异常设计与任务监控使用。

3.5ETL 字段计算函数速查 Field functions

这是底座最值钱的能力之一：把人肉在 Excel 里做的计算，搬到字段上自动执行。凡是"这个字段是由别的字段算出来的"，都应该配函数，而不是在流程里算完再写。

A 族 · 编码与序号生成

B 族 · 数学与金额计算

C 族 · 日期与时间

D 族 · 文本处理

E 族 · 赋值策略

F 族 · 业务语义函数

组合拳示例

// 场景：跨境平台账单入库，需要清洗单号、识别平台、换算时间、分摊运费
字段「订单号」      替换={原始单号}>>@>>            // 去掉 @ 前缀
字段「标准单号」    网店订单号={原始订单号}>>{备注}
字段「平台」        账单类型=平台>>{交易类型}>>{备注}
字段「下单时间」    时间转换=毫秒数>>时间             // 接口给的是时间戳
字段「收入年月」    日期计算=转换>>{下单时间}>>yyyyMM
字段「分摊运费」    分摊金额={总运费}>>{单价}>>{数量}
字段「实收」        计算={单价}*{数量}-{分摊运费}
字段「支付状态」    三元运算={收款金额}/{订单金额}?未支付:付订

// 场景：人事档案自动派生
字段「出生日期」    身份证取生日={身份证}
字段「年龄」        身份证取年龄={身份证}
字段「入职年限」    日期计算=相差年>>{入职日期}>>{今天}
字段「转正日期」    日期计算={入职日期}+{试用期天数}

3.6主键索引四类与配置策略 Indexes

索引是数据质量的守门员。开发时每张表至少要明确"用什么防止重复"。

3.7字段映射取值 Field mapping

映射解决一件事：业务表里只存编码，名称/属性由主数据表自动带出来。这样主数据改一次，所有历史单据显示同步更新，不会出现"客户改名了但老订单还是旧名"的错乱。

两类映射

配置三要素

映射配置 = {
  源表：      BASE_CUSTOMER          // 从哪张表取
  关联键：    BIZ_SALE_ORDER.客户编码 = BASE_CUSTOMER.客户编码   // 按什么对上
  取值字段：  客户名称 / 销售负责人 / 账期天数   // 取哪些回填到本表哪些字段
  触发时机：  新增时 / 保存时 / 关联字段变更时   // 什么时候重新取
}

3.8ETL 智能联动 · 21 种动作 Smart linkage

联动是底座的"自动化触发器"：当一张表发生某个动作时，自动对别的表做点什么。这是替代大量流程节点的关键——能在联动里做的，就不要画到流程里，联动更稳、更快、更好维护。

方向符号的含义

21 种联动动作全表

联动 vs 流程：怎么选

3.9血缘关系、排序汇总与生命周期 Lineage & others

血缘关系配置

以业务单号为关联键，把多张表按时间顺序串成一条链。配置后，输入一个单号就能查到上下游所有相关数据。

典型链路（销售履约）：
  销售订单 ──> 出库单 ──> 物流轨迹 ──> 签收记录
       └──> 开票申请 ──> 收款记录 ──> 对账明细

配置内容：{ 主表, 关联单号字段, 上游表列表, 下游表列表, 时间排序字段 }
效果：客服问"单号 X 到哪了"，智能体一次查全链路，不用在 5 个系统里翻

界面排序汇总配置

数据生命周期

按天设置存储期，超期历史数据自动删除。配置建议：

3.10定时任务与导出模板 Scheduler

定时任务三类用途

时间与并发规划

导出 Excel 模板配置

客户往往要求"导出的表跟我们原来的格式一样"。用导出模板配置列顺序、列名、格式（金额千分位、日期格式）、是否带合计行、是否冻结首行。

3.11API 集成、账套与对外应用 Integration

两个 KEY/SECRET 别搞混

接口对接标准动作

1. 建账套
   录入第三方 Key/Secret、BaseURL、租户信息。一个系统一套，环境（测试/生产）分开建。
2. 确认增量方式
   优先按 updatedSince 时间窗口增量；无更新时间的接口退化为按单号查重（幂等兜底）。
3. 字段映射
   第三方字段 → 底座字段。注意时间格式用「时间转换」函数、编码用「过滤/替换」清洗、金额确认单位（元/分）。
4. 配定时任务
   设定频率与时间窗口，先手动跑一次验证，再开定时。
5. 配异常处理
   超时、限流、鉴权失效分别给不同处理：重试 / 降频 / 告警。

3.12系统管理对开发的约束 Admin

这一块平时不是开发做，但它的配置会直接影响你搭的东西跑不跑得起来。

4AI 智能体搭建 · 开发手册 Agent builder

智能体是"容器"。开发顺序永远是：先建智能体 → 再建任务 → 需要流程的再画流程。别一上来就扎进画布。

智能体（一个数字员工）
 ├── 基础配置：类型 / 发布状态 / 大模型 / 运行环境 / 基础知识 / 全局参数 / 归属部门
 ├── 任务 A：查数据        ← 不需要流程
 ├── 任务 B：做统计        ← 不需要流程
 ├── 任务 C：间隔取数任务  ← 需要流程
 └── 任务 D：自动操作任务  ← 需要流程

4.1智能体七要素配置 Configuration

4.2运行环境六档选型矩阵 Runtime sizing

4.311 种任务类型决策 Task types

拿到需求后第一件事就是归到这 11 类。标红四类必须设计流程，其余靠配置与知识库即可。

决策口诀

用户说话才触发？
 ├─ 是 → 要改/写外部系统吗？
 │        ├─ 是 → 3 执行操作（要流程）
 │        └─ 否 → 统计？1  导出？2  调API？4  知识问答？5  查？6  加？7  改？8
 └─ 否（自动跑）→ 去外部拿数据回来？10 间隔取数
                  操作底座已有数据？9 自动操作
                  盯系统有没有异常？11 定时监控

4.4任务配置与工作机制 Task config

定时机制怎么选

4.5基础知识双引擎 Knowledge

智能体的知识来自两部分，二者互补：

实践建议

5AI 智能体任务流程设计 · 开发手册 Flow design

只有 4 类任务需要设计流程：3 执行操作 9 自动操作任务 10 间隔取数任务 11 定时监控任务。流程 = 节点 + 连线 + 变量，三者搞懂就能画任何业务。

节点分类全景（共 11 类 93 个）

5.1画布三要素与变量系统 Canvas & variables

变量的三种引用写法

{字段名}              // 引用底座当前记录的字段，如 {订单号} {客户编码}
{对象}.{子字段}       // 引用对象内部字段，如 {收货地址}.{城市}
{变量名}              // 引用流程里定义的变量 / 全局参数，如 {PAGE_SIZE} {erpUrl}

流程里的四类数据形态

标准循环写法（遍历数组）

// 这是流程里最高频的结构，背下来
web  获取表格数据            → 得到数组 list
local 取数组长度             → 得到 n
local 变量附值  i = 0
if   数组元素索引取数        → 条件：i < n
  ├─ 否 → 退出循环
  └─ 是 ↓
local 取数组元素  list[i]    → 得到 row
  ... 处理 row ...
local 变量附值  i = i + 1
  └─ ↩ 回到 if 判断

5.2网页操作节点 web（22） Browser

操作浏览器访问业务系统。无 API 系统的唯一解，也是最容易受界面改版影响的模块，务必配合"等待元素显示 + 失败分支 + 网页截图留证"。

5.3逻辑判断节点 if（6） Logic

5.4人机交互节点 chat（13） Interaction

负责"把结果交付给人"和"从人那里拿信息"。这是让客户感知到价值的一环——同样的数据，不发消息等于没做。

5.5数据处理节点 data（15） Data ops

与 AI 底座交互的节点群。任何流程最终都要落到这里——取数不落库等于白跑。

data 获取系统数据条数（按唯一键）
  ↓
if   变量值条件判断  条数 > 0 ?
  ├─ 是 → data 更新当前数据
  └─ 否 → data 提交写入数据

5.6本地计算节点 local（8） Local compute

5.7登录态节点 login（2） Session

5.8桌面软件节点 windows（10） Desktop

用于没有网页界面的老系统：传统 ERP 客户端、报关软件、开票软件、仓库 PDA 管理端。

5.9电子表格节点 excel（6） Spreadsheet

5.10图片处理节点 pic（5） Image

5.11子流程与其它操作（6） Subflow & misc

子流程拆分建议

// 把下面这些做成公共子流程，所有项目复用
SUB_LOGIN          登录并校验会话 → 失败则告警
SUB_FETCH_TO_DB    取数 → 查重 → 写入/更新（通用幂等写入）
SUB_NOTIFY         按级别发消息（正常汇总 / 异常告警）
SUB_EXPORT_SEND    导出 Excel → 上传服务器 → 发送文件
SUB_ERR_HANDLE     统一异常处理（截图 + 记录 + 通知 + 停止）

主流程只关心业务顺序，公共能力全部下沉到子流程

5.12十大可复用流程模板 Templates

这 10 个模板覆盖了企业里 80% 的自动化需求。接到需求先找模板，改参数即可，别从空白画布开始。

模板 1 · 外部系统取数入库（最高频）

login 变更账号登入状态 → web 打开URL → web 输入内容(日期区间) → web 点击元素(查询)
→ web 等待元素显示 → if 页面元素条件判断(暂无数据?) → [有] 发通知+停止
→ web 获取表格数据 → local 取数组长度 → 循环{
     local 取数组元素 → data 获取系统数据条数(唯一键)
     → if 条数>0 → data 更新当前数据 / else → data 提交写入数据
  }
→ data 生成系统报表数据 → chat 微信发送消息(汇总)

模板 2 · 自动审单

data 获取系统数据列表(状态=待审核) → 循环{
     data 获取系统单个数据(关联客户/库存)
     → if 变量值条件判断(金额>阈值?)   → [超] chat 微信对话获取数据(人工确认) → if 微信对话条件判断
     → if 变量值条件判断(库存足够?)   → [否] 标记缺货 + 通知
     → [全部通过] data 更新当前数据(状态=已审核)
     → 子流程 SUB_NOTIFY
  }

模板 3 · 对账核验

web 下载文件(平台账单) → data 导入Excel数据文件 → data 等待excel导入完成
→ data 获取系统数据列表(本方流水) → data 进行系统数据对账
→ data 获取系统数据列表(差异记录) → if 变量值条件判断(差异数>0?)
     → [是] data 导出excel数据文件 → chat 微信发送文件 + 消息告警
     → [否] chat 微信发送消息(对账通过)

模板 4 · 自动跟单 / 超期提醒

data 获取系统数据列表(状态 in 待发货/在途 且 时间超阈值)
→ if 变量值条件判断(条数>0)
→ 循环{ local 取数组元素 → local 函数处理(算超期天数)
        → if 变量值条件判断(超期>N天) → chat 微信发送消息(责任人) + data 更新当前数据(标记已催办) }
→ chat BI页面数据汇报(超期看板)

模板 5 · 知识库 QA 问答（无需流程）

配置：智能体基础知识 = 制度文档 + FAQ文本 + 关联基础数据表(产品/客户/价格)
任务类型：5 知识库 / 6 查数据
关键点：基础数据表作为知识 → 业务人员维护即更新知识，永不脱节

模板 6 · 对话式导出数据

任务类型：2 导数据（无需流程）
配置要点：授权可导出的表与字段、配导出模板、限制单次导出行数
增强：配定时报表任务，让日报主动生成，减少人工发起

模板 7 · OCR 票据录单

用户上传票据图片 → data 提交写入数据(含图片字段)
→ 联动：附值<<保存业务单据图片OCR字段提取 → 自动回填金额/日期/对方名称
→ if 变量值条件判断(识别置信度低?) → chat 微信对话获取数据(人工确认补正)
→ data 更新当前数据 → 联动：保存>>生成下游凭证单据

模板 8 · 多平台数据同步

循环各平台账号{
   login 变更账号登入状态 → web 打开URL → web 获取表格数据
   → local 变量附值(平台标记) → 子流程 SUB_FETCH_TO_DB
}
→ data 生成系统报表数据(跨平台汇总) → local 函数处理(单位/币种统一，用「时间转换」「算术计算」)
→ chat BI页面数据汇报

模板 9 · 定时监控与告警

web 打开URL → web 获取表格数据 / 获取BI统计项数值
→ if 变量值条件判断(指标超阈值?)
     → [是] web 网页截图 → chat 微信发送消息(含截图) + 记录到监控表
     → [否] other 不操作
→ data 提交写入数据(监控快照，用于趋势分析)

模板 10 · 桌面老系统取数

windows 窗口(激活ERP客户端) → windows 输入(查询条件) → windows 回车
→ windows 表格取值 → local 过滤数组(去重/筛条件)
→ 子流程 SUB_FETCH_TO_DB → data 导出excel数据文件 → chat 微信发送文件

5.13拍视频生成流程与人工校准 Video to flow

这是面向AI 的核心差异化能力：让最懂业务的一线员工录一段操作视频，系统自动理解并生成流程草稿。开发者的角色从"从头画"变成"校准与增强"。

录制规范（给客户的话术）

系统生成了什么

视频 → 分帧与画面理解 → 操作语义化 → 流程草稿
草稿包含：
  · 步骤序列（打开URL / 输入 / 点击 / 取值 / 下载 …）
  · 每步的元素定位（多策略，取最稳的）
  · 输入值的占位（硬编码值会标出，提示改为变量）
  · 数据结构推测（表格 → 数组 + 列映射）

开发者必须做的四件校准

1. 把硬编码换成变量
   视频里输入的"2026-10-29"要换成 {昨日} 变量；账号、店铺、仓库换成全局参数。不换，任务就只能跑那一天。
2. 加固元素定位
   自动生成的定位可能不够稳。改成 id / name / 业务语义属性；删除易变的层级路径。
3. 补异常分支
   视频只录了"顺利的情况"。你要补：查无数据、登录失效、元素超时、数据为空——每条都要有分支与通知。
4. 接上底座与通知
   视频止于"导出完成"。你要接：写入底座表、生成报表、发消息发文件。这一步才是真正产生价值的地方。

5.14异常、重试与幂等设计 Reliability

这一节决定你的交付是"能用"还是"敢用"。企业客户可以接受慢，不能接受错。

幂等三原则

异常分级处理

必须加的四个保险

6调试、发布与运维 Debug & delivery

交付不是"跑通了"就结束，而是"跑稳了、客户敢用、出问题有人知道"。

6.1三态发布流程 Release

并行验证技巧

测试环境跑通后，建议做一周双轨运行：智能体照跑，人同时照旧做一份，每天比对。差异清零后才停人工。这是让客户建立信任最快的方式，也让客户自己得出"确实没错"的结论。

6.2故障排查速查表 Troubleshooting

6.3上线检查清单 Go-live checklist

7附录 Appendix

7.1术语对照表 Glossary

7.2命名与建模规范（建议） Conventions

7.3新人高频疑问 FAQ FAQ

Q1：客户要的功能，到底该用"联动"还是"流程"？

同库内、即时、确定性 → 联动；跨系统、需重试、需判断、需通知 → 流程。例："订单保存后自动生成出库单"用联动（第 11 号动作）；"每天从 ERP 拉订单"用流程。

Q2：一个智能体该建几个任务？

按客户的独立诉求拆。一个典型客户 3~5 个任务：1 个定时取数 + 1 个自动处理 + 1~2 个对话查询 + 1 个定时报表。拆得清楚，出问题时能单独停用某一个。

Q3：客户没有 API，只能爬网页，能做吗？

能做，但要管理预期：界面改版会导致失效。必须做到：开启任务监控、关键步骤截图、失败立即告警、约定巡检周期。并在合同/方案里说明这一点。

Q4：客户问"智能体会不会乱改我的数据"？

三层防护讲给他听：① 权限：角色菜单权限 + 部门数据范围；② 审计：操作记录全程留痕，谁改的一查就知道；③ 可控：任务可随时停用，重要动作可配"人工确认"分支（微信对话条件判断）。

Q5：大模型选千问还是 DeepSeek？

本平台两个都支持。选型看客户偏好与合规要求。但请记住：自动化类任务的价值主要来自流程与数据，模型只是配角，不要在这个问题上耗太久。

Q6：怎么让方案更容易被客户接受？

① 先做小：选一个每天占人 1~2 小时的重复场景，一周见效；② 双轨验证：人机同时做，让客户自己比对；③ 保留控制权：给客户开关与查看入口，而不是黑盒运行；④ 用他的表：导出模板照他现有 Excel 配，格式熟悉感很关键。

Q7：任务迁移什么时候用？

做标准化交付时用：在一个"模板智能体"里把任务与流程调好，新客户来了直接迁移过去，只改全局参数与账套配置。这是把交付从几天压到几小时的关键动作。

7.4客户交付物清单 Deliverables