智能体技能开发

智能体，AI助理，负责对接前端应用与后端大模型服务平台，为个人用户或者企业用户提供业务处理或者任务处理，其中，智能体支持可扩展的专业技能，智能体处理业务流程或者执行任务时，可使用这些专业技能，指导如何有序、合理或高效地调用工具以及获取外部资源。

智能体任务，支持不同的任务类型，其中，包括系统任务、用户自定义任务或者定时任务，在任务中定义业务需求对应的处理流程，在每个任务中可使用多个技能，在每个技能中可调用多个工具。

智能体技能，以项目工程的方式定义、以项目工程版本的方式管理与发布，其描述文件是SKILL.md，其内容编写是以提示词的方式组织，在内容中定义指导的方法与规则，用于调用MCP Server服务、本地工具集以及业务系统，或者执行技能自定义的代码以及访问技能自身提供的资源文件。

MCP Server，理论上，大模型是只读数据库，只提供推理服务，不存储用户的会话数据，需要在应用层提供存储用户会话数据的服务，因此，需要在上下文中提供与用户相关的数据，用于推理与用户相关的业务，MCP Server可以提供通用的服务，用于执行外部的与用户相关的业务流程或者获取与用户相关的业务数据。

本地工具或业务系统，智能体在执行任务时，按照技能的定义以及指导或者任务自身的需求，调用本地操作系统的命令行、执行业务流程或者读取业务相关的缓存，将返回的数据提供大模型继续执行任务。

大模型平台，大模型厂商提供的大模型服务，其中，包括大语言模型服务、多模态大模型服务以及支持不同业务应用场景的大模型服务。在智能体集成平台中，创建新的智能体时，可以按照不同的业务需求，对接不同的大模型服务。

skill-name，智能体技能的名称，作为智能体技能的项目工程的目录名称，可在配置仓库中以版本的方式管理与发布。

SKILL.md，定义智能体技能的描述文件，即智能体技能提示词文件，其内容语法是使用markdown文本类型的标记性语言，详细定义技能的相关内容，其中，包括描述技能的属性参数与运行技能的指导说明，智能体执行对应的任务时，加载到大模型的上下文中。

scripts，智能体技能自定义的可执行文件或者代码文件，按照智能体技能定义的业务流程，作为工具调用，运行这些可执行文件处理相关业务或者获取外部资源数据。

references，智能体技能的引用参考文档，其中，包括其他智能体技能文件或者与专业领域知识相关的智能体技能文件（finance.md, legal.md），REFERENCE.md中定义了详细的技术引用参考，FORMS.md中定义数据表格模版或者结构化的数据格式。

assets，智能体技能自定义的静态资源，其中，包括模板（文档模板或者配置文件模板），图片（图表或者图片样例），数据文件（数据表格或者数据库数据表）。

按照实际的业务需求，可扩展增加其他文件或者目录。

name, 智能体技能的名称，必填项，与智能体技能项目工程的目录名称相同。

description，智能体技能的描述，必填项，描述技能的功能作用与在什么场景中应用，指定关键字，智能体用于识别相关的任务。

license，声明智能体技能的授权协议，选填项。

compatibility，智能体技能的兼容性描述，选填项，提供技能运行环境的要求、目标产品的说明、系统需要的依赖包、网络访问的条件。

metadata，智能体技能的元数据，选填项，其中，包括创作者的署名、版本的声明或者其他自定义的属性参数。

allowed-tools，允许智能体技能调用的工具列表，选填项。

智能体技能的正文内容，没有固定的格式与约束，用于指导智能体有效地执行任务。推荐的编写方式，按照步骤定义业务流程、提供输入输出的样例以及提供验证的测试用例。

为大模型平台提供项目工程的相关材料，自动生成一个初始版本的智能体技能，再按照实际的业务需求增加专业领域的知识，优化初始版本，输出专业版本。

按照已运行完成的手动执行任务，抽取任务的关键步骤，构建成智能体技能。在实践中优化迭代智能体技能的版本。

扩展智能体技能的专业领域知识面，为上下文提供更强大、更全面以及更专业的信息。

当任务依赖多个技能时，应避免技能之间发生冲突，应为任务提供适当的技能，太多的综合技能反而会影响任务的准确执行。

智能体技能文件的大小应保持在500行，约5000个tokens，大智能体技能文件可拆分为多个小智能体技能文件，作为引用参考文件。