技能 - 帆倍 - 帮助文档

1. 概述

1.1 功能简介

「技能」是给「智能体」配备的操作说明书，把具体工作拆解为可执行的步骤。

在帆倍中，技能是面向具体销售场景的专项能力，例如客户洞察、访前准备、跟进总结、可视化报告。

1.2 管理员关注点

本节列出日常维护技能时需逐项检查的五个点。

关注点	检查方式
技能是否启用	在「技能」列表确认目标技能已存在且可用
技能描述是否清晰	智能体依据描述决定是否触发技能，描述模糊会导致不触发或误触发
技能是否已关联智能体	在技能基本信息中查看被哪些智能体挂载调用
数据上下文是否完整	确认技能所需的字段与参考文件已齐备
产出格式是否符合习惯	用真实业务案例试跑一次，比对输出与团队使用习惯

1.3 配置建议

1）优先保证高频场景的技能可用，例如访前准备和跟进记录整理。

2）根据销售团队反馈，持续优化输出格式和业务重点。

3）当某项能力效果不稳定时，用真实业务案例进行测试和调整。

4）先查看公共技能能否满足需求，再考虑新建自定义技能，避免能力重复导致智能体触发混乱。

2. 使用前提

前提项	说明
账号权限	需为企业创建者、系统管理员，或有「智能体管理」权限的帆倍普通管理员普通管理员若未开启「智能体管理」，在应用后台不可见「技能」入口，需在「权限中心>管理组」中调整管理范围。
技能内容	手动创建前需已想清技能的执行步骤，可先在本地写好 SKILL.md 内容
技能包	导入前需备好 .zip 格式技能包，且包内含 SKILL.md
智能体	技能需被智能体挂载后才能实际生效

3. 进入功能入口

本节操作的目的是进入「技能」配置界面。

1）管理员登录帆倍，单击左上角头像，单击「应用后台」。

2）在左侧导航单击「技能」，进入技能界面。

4. 系统技能

系统技能，是帆倍默认提供给各个企业的技能，仅支持调用与修改，不支持替换和删除。

技能	适用场景
销售教练	围绕具体商机或客户开发早期，咨询打单策略、推进打法、异议处理、竞品应对、谈判思路、销售话术草稿
负责人变更	领取、分配、退回、回收、更换负责人，支持「把 A 名下客户转给 B」式批量转交
销售跟进记录	把一段沟通整理进 CRM：短口述直接拆成多条笔记与任务；长会议转录额外生成一份会议报告
客户复盘	围绕单个客户或单条商机，基于已发生的 CRM 事实梃理当前状态、推进到哪里、风险与下一步
客户洞察	点名一家公司或 CRM 客户，结合外部信息与 CRM 回答这家公司是谁、有何信号、有无风险、关键人是谁、有何销售机会，覆盖轻量、深度与单点信息洞察
数据导入	将上传的 CSV 或 Excel 批量导入 CRM，每份文件对应单一对象，可一次传多份
Widget 可视化设计	show_widget 工具的通用可视化设计参考。用户未提供明确设计要求时用作兜底
Markdown 报告写作	用户明确要求详细、完整、深度、带图表的报告，如拜访攻略、客户洞察、竞品分析、销售战报。不用于普通 .md、README、简单笔记、会议纪要
前端视觉设计·单页报告	邀请函、海报、贺卡、菜单、简历、个人主页、时间轴、落地页等单页静态产出，内置 12 套可套用主题
HTML 翻页演示	方案演示、产品介绍、商务提案、项目汇报、年度复盘、路演、培训分享。不用于生成或编辑 .pptx
PPT 制作	用户要求制作幻灯片、演示文稿或 PPT，或编辑现有 .pptx 文件
数据分析与可视化工坊	数据分析报告、数据看板、驾驶舱、BI 自助分析、月报周报年报、白皮书、行业研究。不用于对话内的简单看数
introduce-finesales	用户泛问「你能做什么」「介绍一下自己」「有哪些能力」「怎么开始」时，按当前用户角色展示产品介绍卡片。不用于执行具体任务

5. 新建自定义技能

自定义技能即各个企业根据企业特性自行创建或导入的技能。本节提供两种方式：已有现成技能包时用导入，从零编写时用手动创建。

5.1 手动创建自定义技能

本组操作的预期结果为技能列表中出现一个新的自定义技能。

1）在「技能」界面，单击「添加技能」，新建技能。

2）录入基本信息，三项均为必填，具体要求见下表。

字段	说明与填写要求
技能目录名	用于保存技能相关配置文件，作为文件系统路径标识仅支持小写字母、数字、下划线、连字符
技能名称	展示用名称，建议简洁易懂
技能描述	智能体依据此描述决定是否触发技能。建议同时写清适用场景与不适用场景，参考公共技能的描述写法技能描述直接影响智能体是否触发该技能。描述过于笼统会导致该触发时不触发、不该触发时误触发，请务必写明适用与不适用场景。

3）写入文件内容。直接输入 SKILL.md 内容，也可单击左侧文件区新建或上传文件。

关于 SKILL.md：SKILL.md 是一个文本文件，是定义技能的说明书，用于向智能体提供完成某项任务所需的具体步骤和参考信息，相当于一份标准化的任务操作指南。

4）单击「保存」生效。

5.2 导入自定义技能

本组操作的预期结果为技能包导入成功并出现在技能列表中。请先逐项校验技能包，再执行上传。

1）准备技能包，逐项校验下表四项要求，全部确认完毕后将技能包压缩为 .zip 格式文件。

校验项	要求
必需文件	技能包中必须包含 SKILL.md 文件
名称一致性	SKILL.md 中定义的技能名称，与技能包文件夹的名称完全一致
命名规则	技能名称必须由小写字母、数字、连字符组成，1–64 字符
唯一性	不支持与已有技能重名

2）在「技能」界面单击「上传」，上传准备好的 .zip 格式技能包。

3）单击「导入」即可。

6. 挂载技能

技能创建完毕后，需被智能体挂载才能实际使用。挂载操作在智能体配置中完成，详情请参见「智能体」文档。

在技能基本信息中，管理员可查看当前技能包的更新日期、以及被哪些智能体挂载调用。该信息也是删除技能前的必查项。

7. 维护自定义技能

对于已创建的自定义技能，支持编辑、替换与删除。

7.1 编辑技能

1）单击具体技能的「编辑」按钮。

2）编辑技能名称、描述、文件内容。

3）单击「保存」。

7.2 替换技能

1）单击具体技能。

2）单击「替换」，上传最新版技能 .zip 文件。

警告：替换属于覆盖式更新，会直接覆盖现有技能内容。请务必先备份当前版本的技能包，否则无法回退到替换前的版本。

7.3 删除技能

1）先确认该技能未被任何智能体挂载，否则无法删除。可在技能基本信息中查看挂载情况。

2）单击具体技能，单击「删除」。

3）在二次确认框输入技能名称，单击「删除」。

警告：删除技能前请务必先备份技能包，否则后续需要时需从零重建。

8. 常见问题

问：技能已创建，但智能体不触发，原因是什么？

答：优先排查两个原因：

1）技能未被智能体挂载，请在技能基本信息中确认挂载情况；

2）技能描述过于笼统，智能体无法判断何时使用，请补充适用与不适用场景。

问：导入技能包失败，如何排查？

答：按「5.2 导入自定义技能」的校验表逐项比对，最常见原因是 SKILL.md 中的技能名称与文件夹名不一致，其次是名称含大写字母或中文、与已有技能重名。

问：为何删除技能时提示无法删除？

答：该技能仍被智能体挂载。请先在技能基本信息中查看挂载它的智能体，逐个解除挂载后再删除。

问：技能目录名与技能名称有什么区别？

答：技能目录名是文件系统路径标识，仅支持小写字母、数字、下划线、连字符；技能名称是展示用名称，建议简洁易懂。

问：替换技能后可以回退到旧版本吗？

答：替换为覆盖式更新，请在替换前自行备份当前版本的技能包，不支持回退。

问：多个技能适用场景重叠时，智能体如何选择？

答：智能体依据技能描述判断，描述重叠会增加误触发风险。建议在描述中明确写出不适用场景并指向更合适的技能，参考公共技能中的写法。