本文介绍附加到声明式代理的技能。 若要在不创建代理的情况下创作技能以直接在 智能 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 容器中。 |