构建声明式代理

在 生成或重用期间,实现 在组件计划中选择的声明代理组件。 本文可帮助您选择产品程序并确认组件的准备就绪情况。 最后,您可以使用工作代理、其依赖项和插件集成的测试证据。

不需要每个插件都有代理。 对于你自己的业务流程、模型、托管或运行时,请改为遵循 应用路径 。

在创建现有代理之前检查现有代理

  1. 与其所有者一起查看现有代理的预期用户、受支持的体验、说明、知识、操作、权限和已知限制。

    验证: 其记录的功能与组件计划中的任务和目标体验相匹配。

  2. 选择产品记录的重用或扩展路线。 可以从代理模板开始,也可以在适合该工作流时将代理生成器代理复制到 Copilot Studio。

    验证: 路由支持源和目的地。 不要假定将代理组件添加到插件会导入现有项目。

  3. 就所有权、版本控制、支持和更改管理达成一致,然后测试代表性任务。

    验证: 在决定原封不动地使用代理、配置代理或构建新组件之前,记录结果和未解决的差距。

开始使用 Work IQ 开发工具

对于专业开发,请从 Work IQ Dev Tools 开始,选择 记录的环境,并仅在组件需要其特定项目控制时才添加 Agents Toolkit。

你的起点 产品流程 预期结果
需要代理组件的新插件 使用 Work IQ 开发工具生成插件 wiqd plugin create 创建容器; wiqd plugin add agent 可选代理组件的基架。
现有声明式代理源项目 代理组件生命周期 使用记录的 wiqd agent 命令继续进行特定于代理的创作和迭代。
需要编辑的座席说明、知识或操作 WIQD 中的声明性代理 和 命令参考 为所选组件和环境配置的已保存源。

使用 WIQD 编码助手插件进行引导式工作,或使用直接 CLI 进行可重复的命令。 需要时,安装编码助手插件和 CLI 作为单独的先决条件。 GitHub Copilot 帮助创作文件、说明、配置和测试;它不会取代创作工具、运行时或组件要求。

对于现有代理项目,显式选择脱机验证:

wiqd agent validate --mode source --env dev

验证: 阅读保存源的调查结果并修复报告的错误。 通过的源检查不会建立运行时行为、终结点可访问性、身份验证正确性或最终包接受。 默认 package 模式使用现有 ZIP,将其上传以供验证,并且可能需要登录。

若要向现有 WIQD 代理项目添加技能,请在代理技能命令参考中检查agent-skills功能标志和当前架构要求。 顶级插件技能和附加到声明式代理的技能是不同的注册;两者都不会在每个主机中建立支持。

当它适合组件时使用其他产品路线

要求 产品流程
智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 中的托管创作 代理生成器概述 和 生成代理
低代码逻辑、托管环境或 Power Platform 连接器 Copilot Studio 和 为 Teams 和 Microsoft Copilot 连接和配置代理
较低级别的代理清单和受支持的开发集成 建议将 Work IQ Dev 工具 (用于受支持的专业代码方案)
现有工具包代理中的技能 使用代理工具包添加技能

独立 Copilot Studio 代理显示在代理注册表中,而不是在插件下。 不要假定发布独立代理会将其重新打包为插件。

配置并测试代理

有关详细实现步骤,请遵循声明式代理产品指南:

待完成的工作 权威指导 验证
定义标识、行为、任务边界和对话发起人 生成代理 或 使用 JSON 生成,然后 编写有效的说明 代表性提示生成预期行为并保持在预期任务范围内。
配置知识和功能 知识源 和 添加功能和自定义操作 所需数据可供预期用户使用,但在权限不允许时不可用。
添加支持的 MCP 或 API 操作 用于声明性代理的 MCP 和 API 插件 工具选择、身份验证、同意、确认、错误和不受支持的请求按预期运行。
添加受支持的技能 声明性代理和 所选创作过程的技能 目标代理在该产品的限制内加载技能并完成定义的任务。
管理创作路由的配置 工具包环境和版本 或 WIQD 环境 标识值、依赖项和设置属于预期的测试环境。

记录代理版本、所有者、支持的体验、依赖项、已知限制和测试结果。 需要针对产品进行特定测试;通过源代码或包验证并不证明每个用户都可以运行任务。

有关设计指南,请参阅 声明式代理的最佳做法 和 Copilot 业务流程协调程序如何选择操作。 当所需行为起作用时,可以选择 启用用户反馈 并 优化内容检索。

后续步骤

继续 生成或重复使用任何剩余组件。 准备就绪后,输入 Package & test with Integrate 并测试组件。