构建与配置
一、创建你的第一个 Agent
新手引导会带你走完这四步,5 分钟内就能看到 Agent 第一次回复。
快速创建
Step 1:完善基础资料
Step 2:完善agent职能信息
选择行业场景
Step 3:上传业务资料(可选,可跳过)
把你的产品目录、报价单、FAQ 文档拖进来。PDF、Word、Excel、网页链接都支持。这一步可以跳过,先看看效果再说。
agent创建成功




进入训练页后,在中间输入消息,从右侧导航打开配置面板。
二、配置
身份设定
Agent 不是冷冰冰的机器人——它需要性格、说话风格、做事原则。
创建 Agent 时,AI 会根据你选的行业和客户类型,自动生成一套身份设定。你可以在之后随时修改。
我是谁
Agent 的身份、性格、专业领域。决定了 Agent 在对话中「像谁」。
- 身份:Agent 的角色定位。
- 性格:Agent 的说话风格。直爽、温和、专业、幽默
- 专业领域:Agent 擅长什么。系统会根据你选的行业自动填充
我怎么做事
Agent 的行为准则和边界。决定了 Agent 在对话中「怎么做」。
- 工作准则:遇到问题怎么处理、回答的优先级是什么
- 行为边界:什么能做、什么不能做。比如「不确定的事说不知道,不要编造」
- 信任建立:靠专业能力赢得客户信任,而不是靠套话
AI 自动生成,你也可以自己改。 身份设定不是写死的——Agent 上线后,根据实际对话表现,随时回来调整。改完不需要重新发布,即时生效。

在工作台右侧打开身份设定,查看或编辑身份文档。
知识库
1.核心能力
| 能力 | 带来的价值 |
|---|---|
| 多源接入 | 本地文件、整个文件夹、飞书云文档、GitLab / GitHub 仓库,一个工作台全部收纳。 |
| 即传即用 | 知识库的改动直接作用于正在运行的智能体,无需重新发布、无需重启,资料更新即刻生效。 |
| 状态透明 | 上传、解析、索引、外部同步全流程状态可见,哪份资料就绪、哪份需要处理,一眼看清。 |
| 高效检索 | 按类型、处理状态、更新时间多维筛选,配合关键词全文搜索,快速定位任意一条资料。 |
一个工作台,收纳所有知识来源
点击右上角「+ 添加知识」,选择适合你的接入方式:

| 接入方式 | 适合场景 | 说明 |
|---|---|---|
| 上传文件 | 零散资料快速接入 | 单个或多个本地文件一键上传。 |
| 上传文件夹 | 整包迁移存量文档 | 保留原有目录结构,批量入库。 |
| 从文件导入 | 从已有文件选择器挑取 | 在系统文件选择器中精确选取需要的文件。 |
| 网页链接 | 网页资料快速接入 | 粘贴网址,OpenHex 自动抓取页面内容。 |
| 手动输入 | 零散信息快速补充 | 直接打字,适合补充少量信息。 |
| 连接飞书文档 | 团队协作内容持续同步 | 飞书云文档更新后自动同步,无需重复上传。 |
| 连接 GitLab 仓库 | 研发 / 技术团队 | 把内部仓库里的文档与代码变成智能体可问答的知识。 |
| 连接 GitHub 仓库 | 开源项目 / 外部协作 | 公开或授权仓库内容一键接入。 |
2.支持的文件格式
📂 支持 PDF · DOCX · XLSX · Markdown · TXT · 常见图片格式,单个文件最大 100 MB。直接把文件拖进虚线框即可上传。
知识库会自动识别每条资料的类型——文档、表格、图片、代码、其他——并在列表中归好类,方便后续筛选。

知识库面板较窄时,先展开更多筛选,再选择类型。
上传与同步状态,全程可见
资料从上传到可被智能体引用,需要经过解析、切片、建立索引等步骤。知识库把每个环节的状态都摊在列表里。

展开更多筛选,按状态查看资料的处理情况。
- 本地文件:处理中 → 已上传;若失败可一眼看到「上传失败」,重新上传即可。
- 外部连接:同步中 → 已同步;若授权过期或源文档变动,会明确提示「同步失败 / 链接已失效」,方便你及时处理。
3.找资料,三秒到位
知识库提供三层筛选 + 全文搜索,任意组合即可定位到目标:
💡 按类型 文档 / 表格 / 图片 / 代码,快速收敛到某一类资料。
🔄 按状态 只看正在处理的、已就绪的,或需要你介入的。
🕒 按时间 今天 / 近 7 天 / 近 30 天,只看最近更新过的内容。

在更多筛选中打开最近更新,选择今天、近 7 天或近 30 天。
顶部搜索框会递归搜索当前文件夹及其所有子目录——资料放得再深,也搜得到。
即传即用,无需重新发布(发布方式为自动发布)
- 知识库的每一次改动,都会直接用于正在运行的agent。新增一份产品手册、修正一句销售话术、同步一个仓库提交,立刻就能引用到最新内容
(同步与索引建立需要短暂时间,完成后即可被检索。)
知识库维护:自动去重,永远用最新版
同一份资料传了多个版本?知识库会自动去重;同一文件有多个版本时,默认智能启用最新版本。被替代的旧版本会列出来,你可以一键恢复。
价值:回复始终基于最新知识;召回时不会把重复内容同时喂给模型,减少上下文干扰和 token 消耗。
知识库 vs 公开资料
OpenHex 把 Agent 可用的资料分成两类,用途完全不同:
| 对比项 | 知识库 | 公开资料 |
|---|---|---|
| 用途 | 喂给 Agent 学习理解,回答时作为参考 | Agent 回答时可原样发给用户 |
| 处理方式 | 先索引、碎片化召回,不会把原始文件外发 | 以文件卡片形式直接发送 |
| 典型内容 | 业务知识、流程、案例 | 报名文件、详细清单、资质认证章、视频等 |
开始使用
- 进入智能体工作台,打开「知识库」。
- 点击「+ 添加知识」,选择本地上传或连接外部仓库。
- 等待状态变为「已上传 / 已同步」,即可在对话中让agent引用这些资料。
- 知识库里放的是原始资料,OpenHex 自动解析后,会把它变成结构化的业务本体数据。你不需要手动整理——知识库是「原材料」,本体是「加工后的成品」。
挂载 Skill 与应用授权
只会聊天不够,你还得让它能干活——生成报价单、收钱、发消息。Skill 是 Agent 的「内功」(生成、计算、处理),应用授权 是 Agent 的「手脚」(对接外部系统)。两者配合,Agent 才能从「会说话」变成「会做事」。
技能
三种方式,快速装上技能

| 方式 | 适合谁 |
|---|---|
| 从技能库导入 | 大多数用户——直接选用平台官方沉淀的现成技能,开箱即用。 |
| 上传 .md / 压缩包 | 有自己的工作规范、SOP、Prompt 模板,想打包成可复用技能的团队。 |
| 上传文件夹 | 把整个目录(含配套脚本、参考资料)作为一个完整技能包上传。 |
**不会写技能?让 AI 先帮你起草。**空态下点「生成初始 Skills」,告诉智能体你的角色(产品经理 / 投资人 / 内容作者 / ……),它会先按你的职位起草一批技能草稿,生成之后还能改、能删,零基础也能上手。
技能库:官方沉淀,一键安装
点开「从技能库导入」,你会看到两类标签:
- 系统技能:平台官方维护、经过打磨的通用专业技能,持续更新。
- 个人技能:你自己上传或让 AI 生成的技能,只属于你。
目前技能库已经覆盖的专业方向(持续新增中):
| 技能 | 它能帮你做什么 |
|---|---|
| 变更日志生成 changelog-automation | 从 Git 历史或 PR 列表,自动生成面向用户的版本发布说明。 |
| 博客写作 blog-post-writer | 撰写结构清晰、信息密度高、适合阅读的博客文章。 |
| 财务报表分析 financial-statement-analysis | 读懂一家公司的三表,给出业务现状与风险判断。 |
| 财务建模 financial-modeling | 搭建可灵活调整假设的三表 / SaaS 模型框架。 |
| 产品策略 product-strategist | 在产品决策点提供框架化的取舍分析与建议。 |
| PRD 撰写 product-requirements | 把一个想法落成为工程团队能动手做的产品需求文档。 |
| 创业指标框架 startup-metrics-framework | 为不同阶段的创业公司挑选与解释关键指标。 |
开始使用
技能入口就在对话工作台右侧边栏,点击图标即可打开技能面板:

在右侧导航选择「技能」,即可打开技能面板。
- 进入agent工作台,打开「技能」面板。
- 点「+ 添加技能」→「从技能库导入」,挑几个和你工作相关的装上。
- 或者点「生成初始 Skills」,让 AI 按你的角色先起草一批。
- 回到对话框,直接交代任务——智能体已经自动用上新装的技能
应用授权
跟外部系统交互
1.三种接入方式
| 接入方式 | 适合谁 | 说明 |
|---|---|---|
| 平台应用 | 所有用户 | 平台官方维护的核心集成,开箱即用、持续更新。 |
| 第三方应用 | 所有用户 | 生态预置的常见业务系统,一键授权即可接入。 |
| 自定义 MCP 服务器 | 有自研 API / 内部系统的团队 | 填一个 HTTPS 地址 + 鉴权,把你自己的内部服务暴露给智能体。 |
2.预置应用市场
点开「添加集成」,即可看到平台已经接好的应用列表,按平台应用 / 第三方应用分组:

打开「应用」里的添加菜单,选择预置应用进入目录。
平台应用
- TikHub 社媒数据:跨 16+ 社交平台的用户与作品数据查询。
- Twenty CRM:开源 CRM,直接管理客户与商机。
- 浏览器沙箱:受控无头浏览器,可打开网页、读取页面结构、点按填表、滚动页面、按截图坐标点击、把文件上传到网页的文件选择框、等待与截图,用于登录第三方站点并完成操作。
- RollingGo 酒店搜索:酒店搜索、酒店详情与静态信息的只读查询;平台统一托管密钥,开通后可用 getHotelSearchTags / searchHotels / getHotelDetail / getHotelStaticInfo 四个工具。
第三方应用
覆盖协作、研发、运维、营销、支付、知识管理等场景:
- 协作通讯:飞书 Bot、企业微信客服、企业微信机器人。
- 研发运维:GitLab、Kubernetes。
- 电商营销:抖音商家号、社媒自动化。
- 支付:支付宝收款(Alipay)、支付宝收款沙箱(Alipay Sandbox)。
- 知识管理:腾讯 IMA 知识库、腾讯乐享知识库。
3.自定义 MCP 服务器:接入你自己的系统
预置应用覆盖不到的内部系统(订单 API、内部工单、私有数据库……),用「添加自定义集成」接入。整个过程只需要填 5 个字段:

填写服务器名称和地址。集成标识带有固定的 custom- 前缀,留空时系统会按名称生成。
| 字段 | 说明 |
|---|---|
| 名称 | 给这个集成起个好认的名字,例如"内部订单 API"。 |
| Slug | SDK 集成标识,留空会按名称自动生成;创建后不可改。 |
| MCP 服务器地址 | 你的 MCP 服务 HTTPS 端点 https:// 开头。 |
| 鉴权方式 | 三选一:无鉴权 / Bearer 令牌 / API Key。 |
| 描述 | 告诉智能体"这个工具能做什么",帮它在合适场景自动调用。 |
填完点「测试连接」确认通了,再点「创建」即可。
4.三种鉴权方式,按你的服务选
- Bearer 令牌

最常见的服务端鉴权方式,选完 Bearer 后还要决定 token 由谁保管:
- API Key

适合那些用自定义请求头传 Key 的内部服务(如 X-API-Key),请求头名称可自定义。API Key 模式:可自定义请求头名称,默认 X-API-Key
5.Token 怎么托管?三种模式对号入座
🔐 不管选 Bearer 还是 API Key,都要决定 token 由谁出、存哪里。三种模式对应三种典型场景:
| 托管模式 | 怎么工作 | 适合场景 |
|---|---|---|
| 由你统一提供 | 你在后台填一个 token,所有使用者共用,安全保存在平台中。 | 团队共用一个服务账号,如内部测试环境、共用的运营后台。 |
| 由用户自带 | 不设统一 token,每位用户首次使用时自己连接自己的 token,用量记在各自账号下。 | 面向外部用户的产品,需要按人计量、数据隔离到个人账号。 |
| 由嵌入网站的 SDK 传入 | 把智能体嵌进你自己的网站;你的网站在每次发消息时传入当前登录用户的 token,平台不存储。 | 白牌 / 嵌入式场景:客户在你的网站里用智能体,无需注册本平台账号。 |
开始使用
- 在工作台打开「集成」面板,点「添加集成」。
- 先在预置市场里搜一下你要用的系统——大概率已经接好,授权即可。
- 没有的话点「添加自定义集成」,填名称、HTTPS 地址和鉴权。
- 选好 token 托管模式,点「测试连接」→「创建」。
- 回到对话框,直接让智能体"查一下今天的订单"或"在企业微信群里发个通知"。
从"会聊天"到"会干活",最后这一步靠集成。
运行资源设置
运行资源分为「沙箱」与「每日积分额度」两张卡片,修改后点击卡片右下角「保存」生效。
沙箱
选择此 Agent 创建沙箱时可以使用的 SKU。选中 SKU 不会创建沙箱。
- 允许使用的 SKU
- general-1c1g · 1 vCPU / 1 GiB:开关开启。
- general-1c4g · 1 vCPU / 4 GiB:开关关闭。
- 默认 SKU:当前下拉值为 general-1c1g · 1 vCPU / 1 GiB。Agent 未指定 SKU 时使用默认值。如需移除当前默认 SKU,请先将其他已选 SKU 设为默认值。
每日积分额度
此 Agent 的全部对话和任务共用一个额度。自然日按北京时间(Asia/Shanghai)00:00 至次日 00:00 计算。卡片上显示当日用量与额度,例如「2026-10-26:已用 38.5940 积分 · 当日额度:5,000」。
输入框当前值为 5,000;留空则使用平台默认额度 5,000 积分/天。修改立即生效:
- 提高额度后,今日用量低于新额度时可发起新任务;
- 降低至今日累计用量或更低时,会停止正在执行的任务,已取消的任务不会自动恢复;
- 留空使用平台默认额度 5,000 积分/天,填写 0 表示停用。
链接子agent
复杂任务不用一个 Agent 从头扛 —— 主 Agent 自动拆解任务,派发给子 Agent 并行处理。

打开智能体协作面板,搜索要关联的子智能体。
💰 贵 所有任务都用最强模型跑,哪怕是"把这段话翻成英文""从会议纪要里抽出待办"这种简单活,token 费用也压不住。
🎭 杂 一个智能体既要写营销文案、又要做财务分析、还要答技术问题——角色切换时容易串味,专业度上不去。
核心玩法:强模型编排,便宜模型执行
⚡ 每个子智能体都可以在自己的训练页里单独选模型。让主智能体用更强的模型做任务拆解和流程编排,让子智能体用更便宜的模型干具体执行——同一份工作,总成本显著下降,效果却不打折。
| 角色 | 干什么 | 用什么模型 |
|---|---|---|
| 主智能体 | 理解用户意图、拆解任务、调度子智能体、汇总结果。 | 更强的模型,负责"想清楚"。 |
| 子智能体 | 专注一类专业任务,比如写营销稿、做客服答疑。 | 更便宜的模型,负责"干得完"。 |

从工作台右侧进入智能体协作,在子智能体面板查看已关联的智能体,或搜索后添加。
每个子智能体卡片包含两个关键信息:
- 角色定位:一段文字说明这个分身是干什么的。
- 所用模型:卡片底部一行小字展示,例如 "DeepSeek V4 Flash"——这就是它在自己训练页里选的模型。
点击右上角「+ 添加」可以继续挂载更多子智能体;不再需要的,点卡片右侧的删除按钮即可移除
开始使用
- 在 Agent 工作台右侧打开「训练 → 智能体协作」,选择「子智能体」。
- 点击「添加」,在「添加子智能体」中搜索并选择已有的 Agent。
- 进入它的训练页,选一个够用但便宜的模型。
- 回到主 Agent,直接交代任务——它会自动判断该派哪个子 Agent 去做。
会话管控
在 Agent 工作台右侧打开「设置 → 对话设置」,按需配置语音回复、对话内收款和全局暂停。要新增购买意向或未回复跟进规则,请到「运营 → 情景触发」。
🔗 这些是"能力开关":能不能语音回复、能不能在对话里收款、要不要全局暂停——它们回答"允不允许"。至于什么时候自动触发(比如识别到"我要买"自动弹收款、用户半天没回话自动挽留),属于自动化规则,见 05 运营与治理·情景触发。
三个开关,管住三件事

在对话设置中调整声音和语速,通过试听检查效果。
| 开关 | 管什么 | 典型场景 |
|---|---|---|
| 语音回复 | 用户听到的声音、方言、语速、朗读风格。 | 客服热线、有声助手、面向中老年用户的产品。 |
| 对话内收款 | 是否允许 Agent 在对话里直接向用户发起收款。 | 付费咨询、订阅续费、在对话中完成商业闭环。 |
| 全局暂停 | Agent 停止自动回复,用户消息仍记录,转人工接管。 | 出故障、敏感时期、需要人工兜底时一键停服。 |
1.语音回复:不只能看,还能听
开启语音回复后,用户播放智能体的最终回复时会听到真实人声。思考过程和工具调用不会被朗读——用户只听到干净的结论。
方言选择
预置 5 种中文方言,覆盖最常见的口音场景:
- 普通话(默认)
- 河南话
- 东北话
- 上海话
- 粤语
需要更多声音?右上角「+ 添加声音」可扩展音色库。
语速与朗读风格
- 语速滑块:从慢到快自由调整,默认 1.0×。
- 朗读指令:用自然语言描述你想要的语气,例如"语气温暖自然,在重点处适当停顿"。
- 试听内容:自定义一段试听文案,改完立刻点「试听」确认效果。
男女声一键切换
默认女声 / 默认男声两套开箱音色,点「使用此声音」即可切换,「试听」按钮随时对比。当前正在用哪一套,会有"使用中"标记。
2.对话内收款:在聊天里完成商业闭环
💳 打开这个开关后,Agent 可以在对话流程中主动向用户发起收款——付费咨询、解锁高级内容、订阅续费,都不必跳出聊天页。
这是把"聊得来"变成"收得到"的关键一环,配合前面的集成 · 支付宝收款,即可完成从对话到付款的全链路。

在设置的对话设置中找到「对话内收款」。开启后才能查看收款配置项。
四个核心参数
| 参数 | 说明 |
|---|---|
| 每次收款金额 | 单次对话解锁的价格,例如 ¥9.9。 |
| 付款后开放时长 | 付完一次钱后,对话可用多久(如 24 小时),到期后再次触发收款。 |
| 支付方式 | 默认「系统自动判断」,平台根据用户环境选最合适的支付通道。 |
| 收款提示语 | 用户看到的付款弹窗文案,例如"继续咨询需支付¥9.9,请扫码完成付款"。 |
- 收款策略:什么时候开口要钱
「收款策略」是一段自然语言规则,告诉 Agent:什么情况下收款、收款前怎么沟通、付款后交付什么。
例如:
当用户要求输出完整报告、方案或代码等交付物时发起收款。
Agent 会严格按这条规则判断时机,不会在闲聊时乱收钱。
- 训练用沙箱,正式用生产
**双环境隔离设计:**训练时接「支付宝收款·沙箱」,随便试、不扣真钱;正式对话接「支付宝收款」,走真实凭据。两条通道完全独立,开发者在沙箱里把收款流程跑顺了,再切生产,绝不误扣用户的钱。
3.全局暂停:出问题时一键兜底
打开全局暂停后,Agent 停止自动回复,但用户消息仍会正常记录——不再"哑巴掉消息",而是安静地把每条咨询都留下来,等人工接管处理。
适合这些时刻:
- 智能体回答出了明显问题,需要立刻停止。
- 涉及敏感舆情或政策风险,临时下线自动应答。
- 大促 / 活动期间,重要客户由真人顾问接手。
开始使用
- 在 Agent 工作台右侧打开「设置 → 对话设置」。
- 在语音回复里挑方言、调语速、试听音色,满意后点「保存」。
- 需要在对话里收钱时,打开「对话内收款」开关。
- 遇到需要人工兜底的时刻,果断打开「全局暂停」。
产品做得再智能,运营的最后一公里,靠这些开关兜底。
暂停期间,给用户一句得体的话
打开全局暂停后,所有进来的消息不会石沉大海——Agent 会自动回复一段预设文案,告诉用户"我们已经收到,稍后人工跟进"。
你可以按品牌语气自定义这句话,让用户在等待时感受到温度,而不是冷冰冰的报错。
开始使用
- 在 Agent 工作台右侧打开「设置 → 对话设置」。
- 在语音回复里挑方言、调语速、试听音色,满意后点「保存」。
- 需要在对话里收钱时,打开「对话内收款」开关。
- 遇到需要人工兜底的时刻,果断打开「全局暂停」。
产品做得再智能,运营的最后一公里,靠这些开关兜底。
试试你的 Agent
试一试功能
「试一试」是训练页的预览 / 测试面板。你在这个面板里扮演客户,给 Agent 发消息,感受它的回复速度、语气和内容质量。这是在发布之前最后一次验证——确保 Agent 在真实对话场景里表现合格。
学习记录:训练时实时看它学了什么
按时间倒序列出 Agent 最近学到的每一样东西。每条记录包含五个信息:
| 字段 | 说明 |
|---|---|
| 类型 | 📄 知识(进知识库)或 🛠️ 技能(写进某个技能)。 |
| 时间 | 什么时候学到的,精确到分钟。 |
| 内容摘要 | 一句话概括它学到了什么——"宠缘 - 哪些步骤必须在 OpenHex 上实现"。 |
| 去向 | 记到哪里去了——"记入 [学习到的知识]"或"写入技能 [openhex-agent-validation]"。 |
| 状态 | 「已收录」= 已经正式进库生效;还在审核中的会显示待审。 |