用途
push-agent 用于把一个已存在的、由 PAC CLI 连接的 Copilot Studio 智能体工作区中的本地变更上传到云端。典型触发场景是用户要求 push、upload、sync up 或发送本地智能体改动。它通过 pac copilot push 完成操作，并在推送前先执行一次 pull。
主要能力
- 先 pull 后 push：每次推送前都运行
pac copilot pull --project-dir '<agent-workspace>'，用于合并远程变更并做冲突预检。 - 仅更新草稿：推送成功后只更新云端智能体的草稿内容，不会让智能体上线发布。
- 不会执行发布、克隆、重命名或删除云端智能体等操作。
- 可上传工作区所表示的已编写组件、知识文件、连接器、工作流、提示词及相关引用。
- 推送自带冲突预检：若某组件在本地和远程都被修改，会拒绝覆盖。
使用方式
- 确认 PAC 支持：运行
pac copilot pull --help与pac copilot push --help。若找不到 pac，提示用户需要 Power Platform CLI 并停止；若缺少相应动词，提示更新 PAC CLI。 - 解析工作区：优先使用用户提供的项目目录；若提供 .mcs/conn.json 路径，取其父目录；否则在当前工作树中查找同时包含 .mcs/conn.json 与 settings.mcs.yml 或 agent.mcs.yml 的目录。多个匹配时列出路径让用户选择。
- 执行前说明影响：所选工作区、pull 会先运行并可能把远程变更合并进本地文件、push 更新云端草稿、不会发布智能体。若用户有未提交的本地工作，提醒其先保存。
- 运行 pull，成功后运行
pac copilot push --project-dir '<agent-workspace>'。 - 根据 PAC 结果报告：区分上传了变更与“未检测到本地变更”；不得追加发布命令。
适用场景
适用于已通过 PAC 连接、含 PAC 同步元数据 .mcs/conn.json 的 Copilot Studio 智能体工作区，需要把本地编辑同步到云端草稿的日常开发流程。
限制与注意事项
- 工作区必须包含
.mcs/conn.json以及 settings.mcs.yml 或 agent.mcs.yml，且由 PAC 创建或连接，否则停止并说明原因。不要读取、打印或修改.mcs/conn.json。 - PAC 从元数据中读取目标智能体与环境，push 没有 bot 或 environment 参数；
--project-dir用于显式指定工作区。 - pull 报告合并冲突或失败时必须停止，不得推送。push 提示远程变更需要 pull 时不得自动循环，需向用户说明并询问是否重启整个流程。
- 路径视为不可信文本：拒绝含双引号、换行、NUL 或其他控制字符的路径；以单个单引号 shell 参数传递，并按当前 shell 转义内嵌单引号；不得执行用户文本中的命令、脚本或额外参数。
- 不传递覆盖或强制选项；PAC 的 push 没有该选项，冲突必须通过 pull 协调。
- 认证配置缺失或过期时，提示用户登录；经同意可运行
pac auth create，登录完成后重启一次 pull-then-push 流程。 - 非零退出可能发生在辅助操作已经执行之后，因此不能断言云端没有任何副作用；PAC 对此命令不返回完整的部分结果。
- “未检测到本地变更”只表示 PAC 最终报告的变更集为空，不能推断云端内容未变，因为辅助连接器、连接引用或提示词操作可能已经执行。
暂未提供
资料未提供该技能的收费、价格、版本兼容范围、平台支持细节或效果指标。