技能管理
技能(Skill)是智能体的"能力模块"。一个技能定义了智能体在特定场景下的行为方式、使用的工具和执行步骤。通过添加技能,你可以快速扩展智能体的能力。
什么是技能
技能本质上是一份结构化的指令文档(SKILL.md),告诉智能体在面对某类任务时应该怎么做。
例如,一个"合同审阅"技能可能包含:
- 触发条件:当用户提交一份合同文档时
- 执行步骤:逐条检查条款、识别风险点、给出修改建议
- 使用的工具:文档解析、法律知识库检索
- 输出格式:结构化的审阅报告
技能与工具(Tool)的区别:
| 维度 | 技能(Skill) | 工具(Tool) |
|---|---|---|
| 本质 | 高层行为指令 | 底层能力接口 |
| 粒度 | 一个完整的任务流程 | 一个具体的操作 |
| 示例 | "合同审阅" | "PDF 解析"、"文本搜索" |
| 包含 | 可以引用多个工具 | 独立的能力单元 |
查看智能体的技能
- 进入智能体详情页
- 点击"技能"标签页
- 查看已安装的技能列表
每个技能卡片显示:
- 技能名称和图标
- 简短描述
- 风险等级(低 / 中 / 高)
- 版本信息
点击技能卡片可以查看详细的技能文档(SKILL.md)。
添加和移除技能
从技能市场安装
- 进入智能体的技能管理页面
- 点击"添加技能"
- 浏览或搜索技能市场
- 点击"安装"将技能添加到当前智能体
移除技能
- 在技能列表中找到要移除的技能
- 点击技能右侧的菜单按钮
- 选择"移除"
- 确认后技能文件被删除
移除可恢复
由于智能体使用 Git 管理文件,移除技能后你仍然可以通过版本历史恢复。
技能的风险等级
每个技能都标注了风险等级,帮助你了解其涉及的操作类型:
| 风险等级 | 含义 | 示例 |
|---|---|---|
| 低风险 | 仅读取数据,不修改系统状态 | 信息检索、文本分析 |
| 中风险 | 需要网络访问或外部服务连接 | API 调用、在线搜索 |
| 高风险 | 涉及敏感数据操作或系统修改 | 文件写入、命令执行 |
高风险技能每次执行都需要你的明确确认。
内置技能与自定义技能
内置技能
DesireCore 自带一组全局技能(Global Skills),所有智能体都可以使用。这些技能随客户端版本更新,包含基础能力如:
- 文档读写
- 网络搜索
- 代码执行
自定义技能
高级用户可以手动创建技能。每个技能是一个目录,包含:
<skill_id>/
├── SKILL.md # 必须:技能说明 + 元数据
├── skill.yaml # 可选:依赖声明
├── scripts/ # 可选:可执行脚本
├── references/ # 可选:参考文档
├── assets/ # 可选:模板和资源
└── evals/ # 可选:评测用例
SKILL.md 是核心
技能的所有行为由 SKILL.md 中的指令定义。写好 SKILL.md,就等于教会了智能体一项新能力。