主题
技能配置
本章回答：技能是什么、平台有哪些技能、每种怎么配、怎么加/改/删。
技能是赋予智能体特定能力的模块化单元。一个智能体可挂载多个技能，平台的主意图（路由智能体） 会根据用户输入自动把请求路由到对应技能执行。
入口：产品管理 → 点击目标产品卡片 → 配置详情 → 编辑智能体 → 技能区域
1. 能力说明
技能是赋予智能体特定能力的模块化单元。一个智能体可以同时挂载多个技能，平台的主意图（路由智能体）会根据用户输入自动将请求路由到对应技能执行。
配置入口： 产品管理 → 点击目标产品卡片 → 配置详情 → 编辑智能体 → 技能区域
操作方式：
- 点击「+ 添加技能」从技能列表中选择并启用
- 点击已添加技能卡片右侧的编辑图标进入技能编辑页
2. 技能总览
按可配置程度，平台系统技能分为三类：
| 配置类型 | 技能 | 可编辑项 |
|---|---|---|
| 开箱即用型 | 有声书点播、查天气、歌曲点播、音色切换、方言、健康问答 | 无，添加即可使用 |
| 提示词可编辑型 | 闲聊、知识问答、查时间、联网搜索、视觉问答 | 自定义提示词 / 关联知识库 / 垫句等 |
此外还支持自定义技能——企业通过 API 注册并接入自建服务，详见 技能库。
⚠ lite 版技能限制：lite 版仅提供 新闻、音乐、知识问答、查天气 四项技能，其中：
- 仅「知识问答」可编辑（自定义提示词 / 关联知识库），其余三项为开箱即用、不可编辑；
- 「音乐」（歌曲点播）资源范围仅为视觉中国，且不支持播控（无播放 / 暂停 / 上下曲等控制）；
- lite 版无 AIoT 指令控制技能，设备控制由端侧暴露 tool list 交由大模型直接调用。
以下第 2～3 节的完整技能能力仅适用于标准版。
全部技能一览：
| 技能 | 备注 |
|---|---|
| 查天气 | - |
| 方言 | - |
| AIoT 指令控制 | 需要设备支持 |
| 查时间 | - |
| 歌曲点播 | - |
| 有声书点播 | 需要设备配置 |
| 联网搜索 | - |
| 知识问答 | - |
| 音色切换 | - |
| 闲聊 | 默认技能，无法删除 |
| 视觉问答 | 使用此功能需向 JoyInside 团队 zhaoyingxue11 沟通（可请对接人帮忙联系），配置白名单权限 |
| 健康问答 | - |
| 自定义技能 | 需要企业 API 注册 |
3. 各技能简介
3.1 开箱即用型技能
添加到智能体后直接生效，无需任何配置。
| 技能 | 功能说明 |
|---|---|
| 有声书点播 | 用户通过对话点播有声书，支持播放 / 暂停 / 上下集 / 跳集等播控 |
| 查天气 | 用户询问天气时，返回所在地或指定地点的天气信息 |
| 歌曲点播 | 用户通过对话点播歌曲，支持播放控制 |
| 音色切换 | 用户通过对话切换智能体的语音音色（音色规则见 全局人设与音色） |
| 方言 | 支持智能体使用方言进行对话回复 |
| 健康问答 | 提供健康相关的问答能力 |
3.2 提示词可编辑型技能
闲聊
智能体的日常对话能力，承担大部分非特定意图的交互，必须配置、无法取消。
| 配置项 | 说明 |
|---|---|
| 提示词模式 | 「系统内置」或「自定义提示词」二选一 |
| 自动拼接全局人设 | 勾选后，全局人设自动拼接到该技能 prompt 头部 |
| 自定义提示词 | 支持 Markdown，编写回复逻辑、核心任务、环境感知等 |
| 插入系统变量 | 支持 ${systemTime}、${location}、${memoBaseContent} |
| 关联知识库 | 选择已创建的知识库，配置返回结果数量和匹配阈值 |
知识库配置参数：
- 返回结果数量：命中知识库时返回的参考条数（如 3 条）
- 匹配阈值：语义匹配的最低得分（如 0.3），低于阈值的结果不返回
知识问答
基于企业知识库的专业问答能力。当用户问题命中知识库内容时，优先基于知识库回复。
可配置项： 与闲聊一致（自定义提示词 + 自动拼接全局人设 + 关联知识库）。
查时间
用户询问时间相关问题时触发（如「现在几点了」）。
| 配置项 | 说明 |
|---|---|
| 提示词模式 | 「系统内置」或「自定义提示词」 |
| 自动拼接全局人设 | 勾选后拼接全局人设 |
| 自定义提示词 | 可定义回复时间时的表达风格和附加行为 |
| 插入系统变量 | 支持 ${systemTime}、${location} 等 |
联网搜索
当用户提出需要实时信息的问题时触发，智能体联网检索后组织回复。
| 配置项 | 说明 |
|---|---|
| 提示词模式 | 「系统内置」或「自定义提示词」 |
| 自动拼接全局人设 | 勾选后拼接全局人设 |
| 自定义提示词 | 定义联网搜索后的回复逻辑和表达风格 |
| 搜索提示语 | 在搜索等待期间下发给用户的即时反馈文本（类似垫句） |
搜索提示语的作用：联网搜索有等待延迟，配置提示语后可先给用户一句即时回复（如「让东东搜一下」），避免长时间静默。
⚠ 未配置提示语时，系统会采用默认搜索提示语「正在为您联网搜索」。
视觉问答
具备视觉感知能力，能理解用户拍摄 / 上传的画面，结合语音提问给出回复。
| 配置项 | 说明 |
|---|---|
| 提示词模式 | 「系统内置」或「自定义提示词」 |
| 自动拼接全局人设 | 勾选后拼接全局人设 |
| 自定义提示词 | 定义视觉识别后的回复逻辑、语言风格、场景适配策略 |
⚠ 使用视觉问答需向 JoyInside 团队 zhaoyingxue11 沟通配置白名单权限。
4. 配置流程
4.1 添加技能
- 进入「产品管理」，点击目标产品卡片进入配置详情，编辑默认智能体
- 在技能区域点击「+ 添加技能」
- 从弹出的技能列表中勾选需要的技能
- 点击确定，技能出现在技能列表中
4.2 编辑技能
- 在技能列表中点击目标技能卡片右侧的编辑图标
- 进入技能编辑页，按需配置（提示词 / 知识库 / 垫句等）
- 配置完成后保存
4.3 移除技能
在技能列表中可移除不需要的技能。移除后该技能不再参与意图路由。
5. Q&A
Q1：技能之间的优先级是怎样的？多个技能都可能命中时谁先执行？ A：由平台的主意图（路由智能体）根据用户输入和对话上下文自动判断最匹配的技能，无需手动配置优先级。badcase 可通过对接人 / 对接群反馈。
Q2：自定义提示词和「系统内置」有什么区别？ A：系统内置——使用平台默认优化的 prompt，用户不可见也不可修改；自定义提示词——平台提供基础模板作参考，用户可自由编写 prompt 定义回复逻辑。
Q3：勾选「自动拼接全局人设」后，人设内容拼在 prompt 的什么位置？ A：拼在该技能 prompt 的头部，确保模型执行技能时始终感知角色设定。
Q4：知识库的「匹配阈值」设多少合适？ A：建议从 0.3 开始调试。阈值越低召回越多但可能引入不相关内容；阈值越高精度越高但可能漏掉相关答案。