实战教程
每篇跟着做完一个真实场景。从零到上线，每一步都有截图，做完一步验证一步——不跳步、不假设你「应该已经会了」。
创建agent模拟流程创建第一个Agent-flow .html
1. 外贸询单报价 Agent（0 → 上线）
这个场景要解决什么问题： 你是一家外贸公司，客户每天从 WhatsApp、邮件、微信来询价——500 件 T 恤发洛杉矶多少钱、换纯棉面料加多少钱、能不能走空运。你要建一个 Agent，自动报价、生成报价单 PDF、记住客户询价历史。
最终效果： 客户打开链接 → 打字「500 件纯棉 T 恤 FOB 洛杉矶」→ Agent 回复精确报价（单价、总价、物流方式、交期）→ 附带 PDF 报价单下载链接。客户信息自动记录在联系人列表里，下次再来不用重新自我介绍。
第 1 步：选行业模板，生成 Agent
- 在 OpenHex 首页点击「新建 Agent」
- 从五大行业模板中选「外贸跟单」
- 回答一个问题：你的目标客户是谁？→ 选「企业机构（B 端）」，补充一句「跨境电商卖家、海外采购商」
- 点击「生成 Agent」→ Agent 名称自动设为「外贸报价助手」
验证： Agent 出现在「我的 Agent」列表里，状态为「已创建」。
第 2 步：上传知识库
Agent 的回答质量取决于你喂给它的资料。上传以下内容：
- 产品目录（T 恤、卫衣、polo 衫的规格、面料、克重）
- 报价规则表（不同数量区间的单价）
- 物流费用表（海运/空运/快递到各主要目的地的费用和时效）
- 公司介绍和 FAQ（客户常问的 MOQ、样品政策、付款条件）
操作： Agent 编辑页 → 知识库 → 上传文件。支持 PDF、Word、Excel、Markdown。
上传建议： 按主题拆成小文件——产品资料一个文件夹、报价规则一个文件夹、物流一个文件夹。不要把所有东西塞进一个 200 页 PDF。
验证： 在演练场搜「T 恤面料」，知识库能召回相关内容。
第 3 步：写 System Prompt
Agent 编辑页 → System Prompt，写四段：
角色：你是外贸报价专员，负责回答客户的产品询价和物流咨询。
知识范围：只回答知识库里有明确信息的产品和报价。不在知识库里的产品，告诉客户需要确认。
行为边界：报价时列出 FOB 价、物流方式和交期。不确定价格就说需要确认，不编造数字。
输出格式：先报价 → 再报物流 → 最后报交期。价格标注币种和贸易术语。
验证： 在演练场问「T 恤多少钱」，Agent 回复了具体价格（含币种和贸易术语），而不是「我们的 T 恤很有竞争力」。
第 4 步：定义本体
Agent 编辑页 → 本体 → 新建字段。至少定义以下字段：
| 字段名 | 类型 | 示例 |
|---|---|---|
| 产品名 | 文本 | 纯棉圆领 T 恤 |
| 面料 | 文本 | 100% 精梳棉 |
| 克重 | 数字 | 180g/m² |
| FOB 价 | 数字 | 3.85（美元） |
| CIF 价 | 数字 | 4.20（美元） |
| MOQ | 数字 | 100（件） |
| 交期 | 文本 | 15-20 个工作日 |
上传产品数据：Excel 表格，每行一个产品，列对应上面的字段。
验证： 在演练场问「纯棉 T 恤 500 件 FOB 洛杉矶多少钱」，Agent 返回精确的 $3.85/件，而不是泛泛描述。
第 5 步：配 Skill——阶梯报价 + 报价单 PDF
在 Agent 编辑页 → 技能 → 新建技能，写两段逻辑：
技能 1：阶梯报价
- 从本体查询产品基础价格
- 根据客户说的数量，匹配价格阶梯（100-500 件 $4.50/件，501-2000 件 $4.00/件，2000+ 件 $3.60/件）
- 计算总价 = 数量 × 阶梯单价
- 需要时调用汇率 API 换算人民币
技能 2：生成报价单 PDF
- 接收报价数据（产品名、数量、单价、总价、物流方式、交期）
- 套用报价模板生成 PDF
- 返回下载链接
验证： 在演练场问「500 件纯棉 T 恤 FOB 洛杉矶」，Agent 回复了精确的阶梯价格，并附带了 PDF 报价单链接。点击链接能正常下载。
第 6 步：建测试集
Agent 编辑页 → 测试 → 新建测试用例。至少覆盖以下场景：
| 用例 | 用户问题 | 期望回答要点 |
|---|---|---|
| 基础询价 | 500 件 T 恤 FOB 洛杉矶多少钱 | 单价、总价、币种、贸易术语 |
| 大批量询价 | 3000 件 polo 衫 CIF 汉堡 | 阶梯价格、物流方式、交期 |
| 换面料 | 纯棉换成涤棉，价格差多少 | 面料差价、两种面料规格 |
| 物流查询 | 发洛杉矶最快几天 | 空运/快递时效、费用对比 |
| 样品询问 | 能不能先打样 | 样品流程、费用、时间 |
| 边界测试 | 你们和 XX 比有什么优势 | 客观对比，不贬低竞品 |
至少 10 条。每条期望答案写关键要点，不要写逐字标准答案。
验证： 跑回归测试（测试页 → 开始测试），所有用例得分 ≥ 80。
第 7 步：回归调优
跑完回归看三件事：
- 总分 ≥ 80 → 可以上线
- 哪条用例得分低 → 点进去看 Agent 实际回答了什么，修知识库/Prompt/本体
- 修完再跑一次回归，确认分数没降
验证： 核心业务场景（询价、报价单生成）全部通过。
第 8 步：发布 & 接入渠道
- Agent 编辑页 → 发布 → 生成分享链接和二维码
- 接入渠道：微信（公众号）/ WhatsApp / 邮件签名
- 把链接或二维码发给第一个客户
验证： 用自己的手机扫码 → 以客户身份发一条询价 → Agent 正常回复并生成报价单 → 在 OpenHex 会话管理里看到这条会话记录。
上线检查清单
- 回归测试全部通过（≥ 80 分）
- 知识库内容是最新的（产品价格、物流费用）
- 本体数据完整（所有产品都有价格和规格）
- 报价单 PDF 正常生成，链接可下载
- 联系人信息自动记录（客户名称、询价历史）
- 至少一个渠道可正常访问
后续迭代方向
- 第一周： 每天看会话记录，把答得不好的问题加入测试集
- 第二周： 补充客户常问但知识库没覆盖的内容（如退换货政策、定制流程）
- 第一个月： 根据真实询价数据调整价格阶梯，增加老客户自动折扣
- 持续： 每周跑一次回归，确认分数没降
2. 官网对外产品官
这个场景要解决什么问题： 你的公司官网每天有几百人访问，但大部分看完就走了——没人回答问题、没人引导留资。你要建一个 Agent 嵌入官网右下角，自动回答产品问题、引导客户留下联系方式。
最终效果： 客户浏览官网 → 右下角弹出聊天窗口 → 问「这个产品和 XX 比怎么样」→ Agent 客观对比并引导留资 → 客户留下姓名和手机号 → 联系人信息自动入库。
第 1 步：选模板，生成 Agent
- 新建 Agent → 选「知识问答型」模板
- 目标客户：选「大众消费者（C 端）」→ 补充「对产品感兴趣但还没购买的潜在客户」
- 生成 Agent
验证： Agent 已创建，基础 Prompt 已预置。
第 2 步：上传知识库
Agent 需要知道你的产品的一切。上传：
- 产品介绍页面内容（每个产品的功能、规格、价格）
- FAQ（客户常问的 20 个问题及答案）
- 客户案例（谁在用、用了什么效果）
- 公司介绍（品牌故事、资质、服务承诺）
操作： 知识库 → 上传文件。建议把官网的产品页、关于我们、FAQ 页面直接导出为 Markdown 再上传。
验证： 在试一试搜「XX 产品价格」，知识库能召回对应内容。
第 3 步：写 System Prompt
角色：你是 XX 公司的产品顾问，代表品牌跟客户交流。
知识范围：只回答知识库里有明确信息的产品问题。涉及价格、规格、功能的，以知识库为准。
行为边界：客观对比竞品，不贬低。不确定的事说「我帮你查一下」。客户问优惠时，引导留资：「留下联系方式，我们让顾问联系您，可能有专属优惠」。
输出格式：先回答问题 → 如果客户表现出兴趣，引导留资。语气友好但不啰嗦。
**验证：**在试一试问「你们和 XX 比怎么样」，Agent 客观对比了产品差异，没有贬低竞品。
第 4 步：配 Skill——留资表单
Agent 编辑页 → 技能 → 新建技能：
- 当客户说「想了解更多」「怎么买」「有没有优惠」时 → 触发留资引导
- Agent 回复：「好的！留下姓名和手机号，我们的顾问 1 小时内联系您，可能还有专属优惠。」
- 收集的信息自动写入联系人管理
验证： 在试一试模拟留资流程，确认信息正常入库。
第 5 步：建测试集
至少覆盖以下场景：
| 用例 | 用户问题 | 期望回答要点 |
|---|---|---|
| 产品功能 | XX 产品能做什么 | 功能列表、适用场景 |
| 价格询问 | 这个多少钱 | 价格、是否含税、有无优惠 |
| 竞品对比 | 跟 XX 比哪个好 | 客观对比，不贬低 |
| 留资引导 | 我想了解更多 | 引导留姓名+手机号 |
| 售后问题 | 买了之后怎么售后 | 售后流程、联系方式 |
| 负面情绪 | 太贵了，不值 | 不争辩，解释价值，引导留资 |
验证： 跑回归，所有用例 ≥ 80 分。
第 6 步：Web 嵌入
- Agent 编辑页 → 发布 → SDK 嵌入 → 复制代码
- 粘贴到官网 HTML 的
</body>之前 - 部署网页
自定义选项：
- 修改聊天窗口位置（右下角默认，可改为左下角）
- 自定义欢迎语：「你好，我是 XX 公司的产品顾问，有什么可以帮你？」
- 传递客户身份：
data-user-id属性，用于识别回头客
验证： 打开官网，右下角出现聊天窗口。发一条消息，Agent 正常回复。用手机浏览器打开，聊天窗口适配正常。
第 7 步：看数据
Agent 上线后，每天关注三件事：
- 会话量——每天有多少人跟 Agent 聊天
- 留资率——聊天的人里，有多少留下了联系方式
- 常见问题分布——客户问得最多的是什么，知识库有没有覆盖
验证： 运营后台 → 会话管理 → 能看到所有会话记录。运营后台 → 联系人管理 → 能看到留资的客户信息。
上线检查清单
- 回归测试通过
- 嵌入后样式正常，不遮挡官网重要内容
- 移动端适配，聊天窗口不占满屏幕
- 留资信息正常入库
- 欢迎语和品牌语气一致
后续迭代方向
- 第一周： 看客户问了什么知识库没覆盖的，补充进去
- 第二周： 优化留资话术，A/B 测试不同版本的欢迎语和留资引导
- 第一个月： 根据客户问得最多的产品，扩充知识库里的产品细节
- 持续： 把留资后成交的会话标记为「好例」，喂给 Agent 学习
3. 企业内部 AI PMO
这个场景要解决什么问题： 你的团队有 5 个项目在跑，每个人都在问「XX 项目到哪了」「谁在负责这个」「本周交付了什么」。你要建一个 Agent 接入飞书群，团队成员 @它 就能查进度、催交付、自动发周报。
最终效果： 团队成员在飞书群里 @PMO助手 「XX 项目进度」→ Agent 回复当前状态、负责人、截止日期、风险等级。每周五自动生成周报发到群里。
第 1 步：选模板，生成 Agent
- 新建 Agent → 选「自定义」模板
- 目标客户：选「创业团队·个体户·工作室」→ 补充「内部团队成员」
- 生成 Agent
验证： Agent 已创建，空白配置，从零开始。
第 2 步：上传知识库
Agent 需要了解团队的工作方式。上传：
- 项目流程图（从立项到交付的标准流程）
- 交付标准（每个阶段的交付物要求）
- 周报模板（格式、必填项）
- 团队分工表（谁负责什么）
验证： 在试一试搜「交付标准」，知识库能召回相关内容。
第 3 步：写 System Prompt
角色：你是团队的 PMO 助手，帮助成员了解项目进度、交付标准和团队分工。
知识范围：只能查询项目信息，不能修改。项目数据以本体为准，流程规范以知识库为准。
行为边界：不评价成员表现，不比较项目优劣。项目有风险时如实汇报，但不制造焦虑。
输出格式：查进度 → 项目名 + 当前状态 + 负责人 + 截止日期 + 风险等级。发周报 → 按周报模板格式输出。
验证： 在试一试问「XX 项目到哪了」，Agent 回复了正确的项目状态。
第 4 步：定义本体
Agent 编辑页 → 本体 → 新建字段：
| 字段名 | 类型 | 示例 |
|---|---|---|
| 项目名 | 文本 | 官网改版 |
| 负责人 | 文本 | 张三 |
| 截止日期 | 日期 | 2026-10-15 |
| 状态 | 枚举 | 进行中 / 已完成 / 延期 / 未开始 |
| 风险等级 | 枚举 | 低 / 中 / 高 |
| 本周进展 | 文本 | 已完成设计稿评审，开发进行中 |
上传项目数据：Excel 表格，每行一个项目。
验证： 在试一试问「有哪些项目在延期」，Agent 列出了所有状态为「延期」的项目。
第 5 步：配 Skill——查进度 + 催交付 + 发周报
Agent 编辑页 → 技能 → 新建三个技能：
技能 1：查项目进度
- 从本体查询项目状态
- 调用项目管理 API（如 Jira/TAPD/飞书多维表格）获取最新进展
- 返回格式化的项目状态
技能 2：催交付
- 检测到项目即将逾期或已逾期
- 自动发飞书消息给负责人：「XX 项目截止日期为 YYYY-MM-DD，当前状态为延期，请确认最新进展」
技能 3：发周报
- 每周五汇总所有项目的本周进展
- 按周报模板格式输出
- 自动发到指定飞书群
验证： 在演练场分别测试三个技能，确认 API 调通、消息正常发送。
第 6 步：建测试集
至少覆盖以下场景：
| 用例 | 用户问题 | 期望回答要点 |
|---|---|---|
| 查进度 | XX 项目到哪了 | 状态、负责人、截止日期 |
| 查负责人 | 谁在负责 XX | 负责人姓名 |
| 查延期 | 有哪些项目延期了 | 延期项目列表、风险等级 |
| 催交付 | XX 项目快到期了，催一下 | 确认已发飞书消息 |
| 本周交付 | 本周交付了什么 | 本周进展汇总 |
| 边界测试 | 帮我改一下 XX 项目的截止日期 | 拒绝修改，提示找 PM |
验证： 跑回归，所有用例 ≥ 80 分。
第 7 步：接入飞书
- Agent 编辑页 → 发布 → 渠道管理 → 添加渠道 → 选择「飞书」
- 在飞书开放平台创建应用 → 获取 App ID 和 App Secret
- 回到 OpenHex 填入 → 配置事件订阅
- 发布
- 在飞书群里 @Agent 测试
验证： 在飞书群里 @PMO助手 「XX 项目进度」，Agent 正常回复。确认飞书消息推送正常。
上线检查清单
- 回归测试通过
- 项目管理 API 调通
- 飞书消息正常发送和接收
- 周报内容准确（项目状态、进展、风险）
- 权限控制正确（Agent 只能查，不能改项目数据）
后续迭代方向
- 第一周： 观察团队成员最常问什么，优化回答格式
- 第二周： 根据团队反馈调整周报模板
- 第一个月： 增加更多数据源（如 Git 提交记录、需求文档），让 Agent 回答更全面
- 持续： 每次项目流程变更，同步更新知识库和本体
最后更新：2026-09-08