声明性智能体的技能

本文介绍附加到声明式代理的技能。 若要在不创建代理的情况下创作技能以直接在 智能 Microsoft 365 Copilot 副驾驶® 对话助手中使用,请参阅为 Copilot 对话助手构建技能。 本文中的支持矩阵适用于代理范围的技能,而不适用于所有技能或插件包。

重要

在使用 Microsoft Purview 信息屏障 (IB) 的租户中,管理员可以部署具有技能的声明式智能体,但最终用户无法将技能添加到他们创建的声明式智能体。

技能是一种模块化功能,您可以将其添加到声明式代理中,以帮助其更可靠、更重复地完成特定任务。 技能是包含所需 SKILL.md 文件以及可选资源文件和脚本的文件目录。 该 SKILL.md 文件包含指导模型完成任务的指令。

技能是声明性智能体的一个独特组成部分。 在早期的指南中, “技能 ”一词是指您在代理的说明中内联编写的任务描述。 技能取代了这种方法:您不是直接在说明中编写任务详细信息,而是将其打包为代理引用的单独组件。 有关指令应如何引用技能的指南,请参阅 编写声明性代理的有效指令。

可以使用 智能体生成器将技能添加到声明式智能体。 对于受支持的专业代码方案,建议使用 Work IQ Dev Tools 。 其 wiqd agent add skill 路由需要 agent-skills 功能标志,该标志默认关闭;请参阅 选择技能实现路径。 基于工具包的演练仍可用于现有工具包项目。

什么是技能

技能是包含以下内容的目录:

  • 必需 SKILL.md 的文件,其中包含:
    • YAML 前事项中的技能名称和说明。
    • 技能说明,必须少于 20,000 个字符。
  • 可选资源文件,如模板、参考数据或定义。
  • 可选脚本和支持文件夹。

例如,财务团队可以构建季度业务审查技能,该技能捆绑了生成审查的说明、转换数据和生成图表的脚本以及财务模型、KPI 定义和品牌幻灯片模板等资产。 当用户要求该任务时,代理将使用该技能。

为什么要在声明式智能体中使用技能

技能可帮助您构建更可靠、可重复的座席工作流:

  • 优化了上下文使用并提高了准确性。 技能使用渐进式披露:只有在任务需要时,模型才将技能的指令和内容加载到上下文中。 即使代理的技能库增长,代理的上下文仍然集中。 提供脚本,而不是依赖模型生成的代码,还为您的工作流程带来了更多的可重复性。
  • 缩放指令而不会造成质量损失。 您可以将复杂的指令分解为模块化、可重用的技能。 此方法允许你提供更长、更具体的指导,而不会降低指令遵循质量,也不会遇到声明性代理指令的 8,000 个字符限制。
  • 打包可重用资产。 您可以将指令、资源和脚本打包为一项技能,并将该功能集成到声明性代理中。
  • 企业就绪。 脚本在安全沙盒中运行,技能文件上的敏感度标签得以保留和遵守,并且管理员管理可用。

支持矩阵

某些限制因您是使用 Agent Builder 还是 Agents Toolkit 添加技能而异。

下表描述了这两种创作路径,而不是 WIQD 限制或功能覆盖范围。 对于建议的专业代码路线,请确认 WIQD 文档中的当前要求。

物品 代理生成器 代理工具包
每个代理的最大技能数 8 8
技能包 压缩, .zip最大 50 MB 技能目录; .zip 不受支持
最大文件大小 每个文件 25 MB 没有技能水平限制;完整的应用包限制为 10 MB
每个包的最大文件数 跨所有技能的 350 个文件 跨所有技能的 350 个文件
从单个上传中培养技能 不支持;上传完整的 .zip 添加或导入完整的技能目录
目录层次结构 最大目录深度为 3 最大目录深度为 3
跨代理重复使用 不支持 不支持

支持的文件和脚本类型

技能可以包括以下文件类型:

类别 文件类型
说明和资源文件 .json, .xml, .yaml, .yml, .ini, .config, .utf8, .docx, .doc, .docm, .pdf, .txt, .rtf, .md, .ppt, .pptx, .ppsm, .xlsx, .xls, .xlsm, .csv, .tsv, .html, .htm, .png, .jpg, .jpeg, .gif, .bmp, .log
脚本和二进制文件 .py, .js, .mjs, .cjs, .ts, .mts, .sh, .bash

脚本执行沙盒

技能脚本在安全沙盒中运行,具有以下限制:

功能 支持
通过脚本访问 Internet 或网络 不支持。 沙盒在运行时没有网络访问权限。
程序包安装 不支持。 技能无法在运行时安装程序包。
通过脚本进行身份验证的网络调用 不支持。
预安装的包 技能可以使用沙盒中已存在的包。 不要依赖包,除非确认其可用性。
连接器、API 插件和 MCP 服务器 代理可以通过业务流程协调程序使用已启用的功能。 脚本无法通过沙盒调用它们。

敏感度和存储

物品 支持
敏感度标签 沙盒将保留敏感度标签并遵循标签策略。 它不支持用户定义的权限或双密钥加密。
存储 系统将上传的技能文件存储在租户范围的 SharePoint Embedded 容器中。