智能体技能为智能体提供处理任务的专业能力本文主要描述智能体技能的业务架构以及开发方法智能体技能业务架构智能体AI助理负责对接前端应用与后端大模型服务平台为个人用户或者企业用户提供业务处理或者任务处理其中智能体支持可扩展的专业技能智能体处理业务流程或者执行任务时可使用这些专业技能指导如何有序、合理或高效地调用工具以及获取外部资源。智能体任务支持不同的任务类型其中包括系统任务、用户自定义任务或者定时任务在任务中定义业务需求对应的处理流程在每个任务中可使用多个技能在每个技能中可调用多个工具。智能体技能以项目工程的方式定义、以项目工程版本的方式管理与发布其描述文件是SKILL.md其内容编写是以提示词的方式组织在内容中定义指导的方法与规则用于调用MCP Server服务、本地工具集以及业务系统或者执行技能自定义的代码以及访问技能自身提供的资源文件。MCP Server理论上大模型是只读数据库只提供推理服务不存储用户的会话数据需要在应用层提供存储用户会话数据的服务因此需要在上下文中提供与用户相关的数据用于推理与用户相关的业务MCP Server可以提供通用的服务用于执行外部的与用户相关的业务流程或者获取与用户相关的业务数据。本地工具或业务系统智能体在执行任务时按照技能的定义以及指导或者任务自身的需求调用本地操作系统的命令行、执行业务流程或者读取业务相关的缓存将返回的数据提供大模型继续执行任务。大模型平台大模型厂商提供的大模型服务其中包括大语言模型服务、多模态大模型服务以及支持不同业务应用场景的大模型服务。在智能体集成平台中创建新的智能体时可以按照不同的业务需求对接不同的大模型服务。智能体技能业务流程智能体技能标准规范智能体技能定义的目录结构skill-name智能体技能的名称作为智能体技能的项目工程的目录名称可在配置仓库中以版本的方式管理与发布。SKILL.md定义智能体技能的描述文件即智能体技能提示词文件其内容语法是使用markdown文本类型的标记性语言详细定义技能的相关内容其中包括描述技能的属性参数与运行技能的指导说明智能体执行对应的任务时加载到大模型的上下文中。scripts智能体技能自定义的可执行文件或者代码文件按照智能体技能定义的业务流程作为工具调用运行这些可执行文件处理相关业务或者获取外部资源数据。references智能体技能的引用参考文档其中包括其他智能体技能文件或者与专业领域知识相关的智能体技能文件finance.md, legal.mdREFERENCE.md中定义了详细的技术引用参考FORMS.md中定义数据表格模版或者结构化的数据格式。assets智能体技能自定义的静态资源其中包括模板文档模板或者配置文件模板图片图表或者图片样例数据文件数据表格或者数据库数据表。按照实际的业务需求可扩展增加其他文件或者目录。定义智能体技能描述文件SKILL.md的属性参数name, 智能体技能的名称必填项与智能体技能项目工程的目录名称相同。description智能体技能的描述必填项描述技能的功能作用与在什么场景中应用指定关键字智能体用于识别相关的任务。license声明智能体技能的授权协议选填项。compatibility智能体技能的兼容性描述选填项提供技能运行环境的要求、目标产品的说明、系统需要的依赖包、网络访问的条件。metadata智能体技能的元数据选填项其中包括创作者的署名、版本的声明或者其他自定义的属性参数。allowed-tools允许智能体技能调用的工具列表选填项。定义智能体技能描述文件SKILL.md的指导说明智能体技能的正文内容没有固定的格式与约束用于指导智能体有效地执行任务。推荐的编写方式按照步骤定义业务流程、提供输入输出的样例以及提供验证的测试用例。智能体技能最佳实践为大模型平台提供项目工程的相关材料自动生成一个初始版本的智能体技能再按照实际的业务需求增加专业领域的知识优化初始版本输出专业版本。按照已运行完成的手动执行任务抽取任务的关键步骤构建成智能体技能。在实践中优化迭代智能体技能的版本。扩展智能体技能的专业领域知识面为上下文提供更强大、更全面以及更专业的信息。当任务依赖多个技能时应避免技能之间发生冲突应为任务提供适当的技能太多的综合技能反而会影响任务的准确执行。智能体技能文件的大小应保持在500行约5000个tokens大智能体技能文件可拆分为多个小智能体技能文件作为引用参考文件。为智能体技能提供更多其所缺乏的知识减少其所已掌握的知识明确定义技能的功能与作用让任务在执行的过程中做出明确的决定数据库操作中注意保持事务的一致性必须按照指定的顺序执行当存在多个符合条件的方法时为任务的执行提供默认的选择技能应明确定义解决某一类的问题而不是为某个问题提供解决办法技能定义应考虑系统级别的可重用性在SKILL.md文件全局定义在其他文件中声明引用为输出的格式提供模版的定义在SKILL.md定义简单模版在静态资源目录中定义长模版为多步骤的工作流提供检查清单避免出现疏漏指导智能体在执行任务时自动执行检查清单出现问题自动修复定义计划验证执行的工作流程从pdf中抽取文本验证字段的合法性输出合法的字段值