跳到主要内容

参考资源

模板、视频、故障排查、常见问题——查漏补缺用，不用通读。

1. 行业模板​

OpenHex 提供五大行业模板，选一个就能直接开始。每个模板预置了 System Prompt、本体字段和 3 个典型客户问题，不是空壳。

模板适用场景预置本体字段示例典型客户问题
外贸跟单产品询价、报价单生成、物流查询产品名、面料、克重、FOB 价、CIF 价、MOQ、交期「500 件 T 恤 FOB 洛杉矶多少钱」「最快几天到」「能不能打样」
留学顾问选校推荐、申请流程、材料清单学校名、专业、排名、托福要求、学费、录取率「GPA 3.5 能申哪些学校」「申请材料有哪些」「截止日期什么时候」
财税法律税务流程、法规查询、费用估算税种、税率、适用范围、办理流程、所需材料「小规模纳税人怎么开专票」「劳动合同到期怎么赔」「股权转让要交哪些税」
品牌营销投放方案、内容策略、报价估算渠道、预算范围、方案类型、执行周期、参考案例「小红书投放方案怎么出」「5 万预算能做什么」「公众号选题怎么规划」
招聘猎头岗位发布、简历筛选、面试流程岗位名、薪资范围、要求、面试流程、部门「Java 开发还招吗」「怎么投简历」「面试流程是什么」

使用方式： 首页 → 新建 Agent → 选择行业模板 → 回答一个目标客户问题 → Agent 自动生成。

后续方向： 模板市场——用户可发布自己调好的 Agent 模板，别人一键复用。这块还在规划中。

2. 视频课​

蓝标已录制 4 场视频，面向不想读文档的用户和企业内训场景。

序号主题时长
1OpenHex 平台概览与核心概念~30min
2外贸跟单 Agent 从零到上线~45min
3Agent 能力评估与迭代优化~30min
4企业级 Agent 治理与运营~35min

每场视频配套： 关键时间点索引 → 课后练习 → 相关文档链接。

3. 故障排查​

按症状查，每条告诉你症状、可能原因、排查方法、怎么解决。

Web 嵌入后聊天窗口不显示​

  • 可能原因： Agent 未发布，或 SDK 代码不完整
  • 排查： 确认 Agent 状态为「已发布」。检查粘贴的代码是否完整（<script src="..."></script> 整段）
  • 解决： 发布 Agent 后重新复制代码，完整粘贴到 </body> 之前

知识库上传失败​

  • 可能原因： 文件格式不支持，或文件过大
  • 排查： 确认文件格式（支持 PDF、Word、Excel、Markdown、TXT）。检查文件大小
  • 解决： 转换格式后重试，或拆分大文件分批上传

Agent 回复「我不知道」​

  • 可能原因： 知识库里没有相关内容，或内容有但检索不到
  • 排查： 在试一试搜同样的问题，看知识库是否召回
  • 解决： 没召回 → 补充知识库。有但检索不到 → 检查文件格式（扫描件 PDF 不可检索，转成 Markdown）

Agent 回复内容过时​

  • 可能原因： 知识库内容未更新，或本体数据是旧的
  • 排查： 对比知识库/本体里的数据 vs 当前实际数据
  • 解决： 更新知识库和本体，删除或标注过时内容

发布后客户扫不开​

  • 可能原因： Agent 未发布成功，或链接失效
  • 排查： 确认 Agent 状态为「已发布」。重新生成分享链接
  • 解决： 重新发布 Agent，生成新链接

微信公众号接入后无响应​

  • 可能原因： 服务器 URL 或 Token 配置不一致，或消息推送未开启
  • 排查： 逐字核对 OpenHex 后台和微信公众平台的服务器配置。确认微信公众平台已开启消息推送
  • 解决： 修正配置 → 在 OpenHex 后台点「测试连接」

支付回调失败​

  • 可能原因： 支付渠道的回调 URL 配置错误
  • 排查： 检查支付宝/微信支付后台的回调 URL 是否与 OpenHex 提供的一致
  • 解决： 修正回调 URL，用测试手机重新走一遍支付流程

Skill 执行超时​

  • 可能原因： 技能代码执行时间过长，或依赖的第三方 API 响应慢
  • 排查： 会话详情 → 沙箱日志 → 看执行耗时
  • 解决： 优化技能代码（减少不必要的 API 调用、加缓存、精简依赖）

本体数据不生效​

  • 可能原因： 字段名与知识库内容不匹配，或数据格式错误
  • 排查： 检查本体字段名是否和知识库里的术语一致（如知识库写「FOB 价格」，本体字段叫「FOB 价」→ 匹配不上）
  • 解决： 统一术语，或者在知识库里补充同义词

测试集回归全部失败​

  • 可能原因： Agent 配置有重大变更（如知识库清空、Prompt 被改坏）
  • 排查： 检查最近一次配置变更记录。逐条看失败用例的 Agent 实际回答
  • 解决： 回退配置 → 逐条修复 → 重新跑回归

积分消耗异常快​

  • 可能原因： 技能有死循环或高频调用，知识库太大导致检索超时，或有人在压测
  • 排查： 费用中心 → 按 Agent 拆分 → 看哪个 Agent 费用暴涨。会话详情 → 看沙箱耗时
  • 解决： 修复技能代码，优化知识库大小，设预算预警

4. FAQ​

OpenHex 和 ChatGPT 有什么区别？​

ChatGPT 是一个通用对话模型，OpenHex 是一个 Agent Service 平台。区别在于：ChatGPT 只能聊天，OpenHex 上的 Agent 能跑代码、生成文件、调 API、沉淀客户数据。而且 OpenHex 的 Agent 可以发布到微信、官网、飞书——ChatGPT 不能。

一个 Agent 能同时服务多少客户？​

没有硬性上限。平台自动弹性扩缩，从 10 个客户到 10 万个客户，不改一行代码。

知识库支持哪些文件格式？​

PDF、Word、Excel、Markdown、TXT。也支持飞书文档和 GitHub/GitLab 仓库（接入后自动同步）。注意：扫描件 PDF 不可检索，需要先 OCR 转成可编辑文字。

积分怎么算？10 积分 = ¥1 是什么意思？​

OpenHex 按积分计费，10 积分 = ¥1。纯文字对话不消耗积分，只有沙箱执行（跑代码、调 API、生成文件）才消耗。具体的沙箱费率看费用中心。

能不能用自己的域名？​

自建端支持自定义域名。SDK 嵌入方式本身就是在你自己的网站上运行，天然是自己的域名。

数据安全吗？我的知识库会不会被平台拿去训练？​

不会。你的知识库、会话记录、客户数据都属于你，平台不做训练用途。多租户隔离、细粒度权限、审计日志默认开启。

支持哪些语言？​

Agent 的语言取决于你喂给它的知识库和 System Prompt。你写中文 Prompt、上传中文知识库 → Agent 说中文。写英文的 → 说英文。大模型本身支持多语言。

怎么让 Agent 说英文？​

System Prompt 用英文写，知识库上传英文资料，Agent 就会用英文回复。

能不能接 WhatsApp / Line / Telegram？​

目前官方渠道支持微信、飞书、自建端、Web 嵌入。WhatsApp / Line / Telegram 可以通过 API 或 Skill 自定义接入。

免费额度用完了怎么办？​

升级套餐：连续 2 周沙箱执行超过免费额度 80% → 升级 Pro。也可以直接充值积分，按需付费。

最后更新：2026-09-08