跳到主要内容

技能管理

技能(Skill)是智能体的"能力模块"。一个技能定义了智能体在特定场景下的行为方式、使用的工具和执行步骤。通过添加技能,你可以快速扩展智能体的能力。

什么是技能

技能本质上是一份结构化的指令文档(SKILL.md),告诉智能体在面对某类任务时应该怎么做。

例如,一个"合同审阅"技能可能包含:

  • 触发条件:当用户提交一份合同文档时
  • 执行步骤:逐条检查条款、识别风险点、给出修改建议
  • 使用的工具:文档解析、法律知识库检索
  • 输出格式:结构化的审阅报告

技能与工具(Tool)的区别:

维度技能(Skill)工具(Tool)
本质高层行为指令底层能力接口
粒度一个完整的任务流程一个具体的操作
示例"合同审阅""PDF 解析"、"文本搜索"
包含可以引用多个工具独立的能力单元

查看智能体的技能

  1. 进入智能体详情页
  2. 点击"技能"标签页
  3. 查看已安装的技能列表

每个技能卡片显示:

  • 技能名称和图标
  • 简短描述
  • 风险等级(低 / 中 / 高)
  • 版本信息

点击技能卡片可以查看详细的技能文档(SKILL.md)。

添加和移除技能

从技能市场安装

  1. 进入智能体的技能管理页面
  2. 点击"添加技能"
  3. 浏览或搜索技能市场
  4. 点击"安装"将技能添加到当前智能体

移除技能

  1. 在技能列表中找到要移除的技能
  2. 点击技能右侧的菜单按钮
  3. 选择"移除"
  4. 确认后技能文件被删除
移除可恢复

由于智能体使用 Git 管理文件,移除技能后你仍然可以通过版本历史恢复。

技能的风险等级

每个技能都标注了风险等级,帮助你了解其涉及的操作类型:

风险等级含义示例
低风险仅读取数据,不修改系统状态信息检索、文本分析
中风险需要网络访问或外部服务连接API 调用、在线搜索
高风险涉及敏感数据操作或系统修改文件写入、命令执行

高风险技能每次执行都需要你的明确确认。

内置技能与自定义技能

内置技能

DesireCore 自带一组全局技能(Global Skills),所有智能体都可以使用。这些技能随客户端版本更新,包含基础能力如:

  • 文档读写
  • 网络搜索
  • 代码执行

自定义技能

高级用户可以手动创建技能。每个技能是一个目录,包含:

<skill_id>/
├── SKILL.md # 必须:技能说明 + 元数据
├── skill.yaml # 可选:依赖声明
├── scripts/ # 可选:可执行脚本
├── references/ # 可选:参考文档
├── assets/ # 可选:模板和资源
└── evals/ # 可选:评测用例
SKILL.md 是核心

技能的所有行为由 SKILL.md 中的指令定义。写好 SKILL.md,就等于教会了智能体一项新能力。

下一步