将 Work IQ Dev Tools 与现有声明式代理的本地源结合使用,以验证、预配、打包并将其作为插件共享。 本快速入门从现有源项目开始,而不是新代理基架。
本演练不会创建新代理或从已安装的代理重建源。 如果要启动新插件,请按照使用 Work IQ Dev Tools 生成插件进行操作。
提示
在 交互式演示中,观看 Work IQ Dev Tools 根据提示生成 Copilot 插件并将其发布到代理商店。
先决条件
- 具有活动 Copilot 订阅的 GitHub Copilot CLI
- 适用于 GitHub Copilot CLI 的 WIQD 编码助手插件 (请参阅本部分中的安装命令)
- Node.js 24.15 或更高版本和 npm,可在你的
PATH上获得,用于 WIQD CLI 和安装脚本 - PowerShell 7 或更高版本 (仅适用于 Windows)
- 有权访问 Copilot 的 Microsoft 365 帐户
- 租户中启用了自定义应用上传
- 受支持的声明式代理源项目
安装 GitHub Copilot CLI 后,安装 WIQD 编码助手插件:
copilot plugin install wiqd@awesome-copilot
或者,添加 WIQD 市场并从那里安装插件:
copilot plugin marketplace add microsoft/wiqd
copilot plugin install wiqd@wiqd
使用 安装脚本安装 WIQD CLI。
安装后启动新的 GitHub Copilot CLI 会话。
编码助手插件提供创作指导;它不安装 wiqd CLI。 在运行验证和生命周期命令之前,请单独安装 CLI。 使用 wiqd --version 确认 CLI 安装,并使用 wiqd doctor检查其先决条件。
确认你有一个受支持的起始项目
从本地声明式代理源项目的根文件夹开始。 文件夹必须至少包含:
contoso-support-agent/
|-- appPackage/
| |-- manifest.json
| |-- declarativeAgent.json
| `-- <the instruction and action files referenced by the manifests>
`-- <a supported lifecycle file>
生命周期文件可以是 m365agents.yml、 m365agents.local.yml、 teamsapp.yml或 teamsapp.local.yml。 项目可以包含其他文件夹和环境文件。
本快速入门在以下情况不适用:
- 你只有已发布的代理或已安装的包,而没有本地源项目。 Work IQ Dev Tools 不支持从已部署的游戏重建源项目。 恢复原始源代码存储库或使用原始创作工具。
- 代理仅存在于托管创作体验中,例如代理生成器或 Copilot Studio。 使用该工具的发布和共享过程。
- 你有一个自定义引擎代理。 此 Work IQ Dev Tools 路由支持声明式代理。
- 你只有代理程序包
.zip. 生命周期命令需要源项目及其生命周期文件。
如果没有现有项目,请从 WIQD 快速入门 开始创建插件并添加声明式代理。 对于支持的方案,WIQD 是推荐的专业代码起点。
注意
wiqd plugin import支持导入 Open Plugin、Claude 插件或 Cursor 插件格式。 它不会导入现有的 Microsoft 365 声明式代理项目或包。 有关详细信息,请参阅 导入/导出 (互操作) 。
创建插件
如果尚未安装,请 安装 Work IQ Dev Tools。
在要在其中创建插件的目录中打开 CLI,然后使用以下命令登录:
wiqd auth login --interactive在 CLI 中,使用以下
copilot命令启动 GitHub Copilot。要求 GitHub Copilot 使用现有声明性代理、技能或 MCP 服务器创建插件。 例如:
Create a plugin named My Plugin by using the agent in "..\My Agent"
验证插件项目
在预配或打包插件之前,显式选择脱机源验证。 在 GitHub Copilot CLI 中,询问:
Validate the plugin source offline in the dev environment
预配插件
重要
此示例使用标准共享 dev 环境。 在预配共享之前 (检查默认 env) AGENT_SCOPE=shared 下的environmentFolderPath有效生命周期配置和所选环境文件。 单独命名 dev 的环境不会建立共享范围。 为预配、打包、验证和共享保留同一环境。
请求 GitHub Copilot 预配插件。
Provision the plugin using the dev environment
等待预配完成。 预配并不能确定每个插件功能在 Copilot 对话助手中都可用;支持取决于组件和目标 Microsoft 365 体验。
打包插件
请求 GitHub Copilot 打包插件。
Package the plugin using the dev environment
重要
必须先预配插件,然后再打包插件。 如果在预配之前进行打包,则生成的包无效。
验证包
打包后,找到生成的 ZIP 并确认文件存在。 在 GitHub Copilot CLI 中,提供其实际路径并询问:
Validate this existing plugin ZIP in package mode using the dev environment
程序包验证使用 --mode package 通过 --package-file提供,而不是自动生成提供的现有 ZIP。 查看返回的判定和结果。 退出代码 0 表示所选检查已通过;仍可以报告警告。 阻止发现或不完整的结果无法通过,并且包验证不会证明运行时行为。
当前验证模式为 source、 和 packagemarketplace。
source是显式脱机检查。 默认格式要求 package现有 ZIP,将捕获的副本上传到 Microsoft 365 验证服务,并且可能需要身份验证。
marketplace 增加了政策和证据检查;这不是官方 Microsoft Store 批准。 验证不会自动生成 ZIP、登录或预配插件。 有关详细信息,请参阅 验证和 MVL。
共享插件
现在,可以要求 GitHub Copilot 与组织内的特定用户或整个组织共享插件部署。 共享前请在所选环境中进行确认 AGENT_SCOPE=shared 。 共享受众 (--scope users 或 --scope tenant) 不会更改部署范围。
Share the plugin with AmberR@contoso.com using the dev environment
或者:
Share the plugin with my organization using the dev environment
重要
共享自定义插件取决于组织允许或阻止共享插件的设置。 如果在此步骤中遇到任何错误,请与管理员检查。 有关详细信息,请参阅 代理共享和发布设置。
将插件发布到组织的插件注册表
可以请求将插件发布到组织的插件注册表,而不是共享插件。 组织管理员可以查看插件并批准或拒绝请求。
Submit my plugin to the organization catalog for admin approval using the dev environment
共享允许直接访问;目录提交是一个单独的操作,不是管理员批准或完成的用户安装。
删除包 (可选)
如果此插件只是测试插件,请让 GitHub Copilot 删除该插件。 此操作将删除任何预配的云资源。
Delete the plugin using the dev environment