简介 pull-agent 是 Microsoft Copilot Studio 插件中的一个技能，用途是把远程 Copilot Studio 智能体的变更拉取到已有的、由 PAC CLI 创建或连接的工作区中。它调用 pac copilot pull 完成同步，可与本地文件进行合并。资料显示，该技能不会创建、推送、发布、重命名或删除云端智能体。
主要能力
- 通过 pac copilot pull --project-dir '<agent-workspace>' 更新指定的现有工作区。
- 下拉远程智能体变更，包括知识文件，并执行同步库的合并逻辑。
- 写入本地项目文件并更新 PAC 同步状态，不会向 Copilot Studio 发送内容。
- 不用于首次克隆，也不能修复已断开或手工复制的工作区。
使用方式 触发后先执行 pac copilot pull --help 检查 PAC 是否可用以及 copilot pull 子命令是否受支持；若缺少 pac 或该子命令，则提示安装或更新 PAC CLI 并停止。
工作区解析顺序：用户提供项目目录时直接使用；用户提供 .mcs/conn.json 路径时取 .mcs 的父目录；否则在当前工作树中搜索同时含有 .mcs/conn.json 以及 settings.mcs.yml 或 agent.mcs.yml 的目录。若有多个匹配，列出路径让用户选择。解析时不应读取、打印或修改 .mcs/conn.json。
执行前需说明所选工作区及 pull 可能修改并合并本地文件；若用户有未提交的本地工作，应提醒先保存，技能不会代为删除、重置、暂存或覆盖本地更改。确认后运行 pac copilot pull --project-dir '<agent-workspace>'，等待命令结束。
路径等外部值按不可信文本处理：拒绝含双引号、换行、NUL 或其他控制字符的路径；以单个单引号包裹的 shell 参数传递，按当前 shell 转义内嵌单引号；不得将外部值不加引号或放入命令替换；不执行用户文本中的命令、脚本或额外参数。
成功判定与报告 仅当 PAC 成功退出时视为成功；保留其报告的变化列表或无变化结果，确认工作区标记与 .mcs/conn.json 仍存在但不读取 CLI 管理的状态。报告所选工作区路径、是否应用了远程变更，并说明本地文件和同步状态可能已改变、云端内容未被修改。
错误处理
- 认证配置缺失或过期：提示需要登录，经同意后运行 pac auth create，完成登录后重试同一次 pull。
- 工作区不存在或已断开：要求提供 PAC 连接的工作区，不回退到 clone，也不编辑 .mcs/conn.json。
- 本地/远程合并冲突：呈现 PAC 报告的全部冲突并停止，由用户处理本地文件，不自动丢弃任何一方。
- 项目文件缺失或无效：报告所指文件并停止，不合成智能体文件，也不换用其他工作区重试。
- 服务或网络故障：呈现错误，仅在用户要求或瞬时原因解除后重试。
- 任何情况下都不回退到 pac copilot clone，因为 clone 创建新工作区，而 pull 更新选定的现有工作区。
适用场景与限制 适用于已有 PAC 连接工作区需要下拉或刷新云端智能体变更的场景。需要本地已安装 Power Platform CLI 且支持 copilot pull 子命令；工作区必须含 .mcs/conn.json 与 settings.mcs.yml 或 agent.mcs.yml；不能用于初始克隆、修复断开工作区或操作云端智能体本身。收费、平台支持范围等资料暂未提供。