云端代理故障排查

先区分代理没有获得任务、任务正在执行、执行失败，还是验证工作流尚未批准。PR 时间线和会话日志通常比页面是否出现新提交更能说明实际状态。

找不到 Copilot Assignee

检查是否有付费 Copilot 套餐，以及 cloud agent 是否在个人账号、组织或企业和目标仓库启用。可在 Copilot features 设置查看自己的启用状态。

Enterprise Managed User 的个人仓库不支持 cloud agent，需要改用组织仓库。目标仓库能在下拉框中出现也不等于可选：选择还要求写权限并启用 cloud agent。

分配后没有动静

稍等并刷新 Issue，查看是否出现 👀 和关联 draft PR。PR 时间线出现 Copilot started work 后，点击 View session 查看实时日志。

分配后新增的 Issue 评论不会进入代理上下文。应在它创建的 PR 中提出补充要求，或在运行会话中 steering，见分配 Issue。

不响应 PR 评论

确认你有仓库写权限，在仍打开的 PR 中提及了 @copilot。已合并或关闭的 PR 不响应新请求。排障页还要求检查 Copilot 是否被取消分配；当前操作指南明确也支持在其他人创建的 PR 上提及 Copilot，因此不要把“最初不是它创建的 PR”当成不支持的原因。

有效请求会出现 👀，随后可从 PR 时间线进入新会话。

日志长时间停住

短暂无更新不一定已经卡死。若持续卡住，排障页称约一小时后超时，当前概览明确最大 59 分钟，以该明确上限规划任务。

Issue 任务可以取消分配后重新分配；评论触发的任务可以再次提交请求。重试前先阅读已推送改动并缩小任务，避免再次触及相同环境问题或时间限制。

CI 没启动或未通过

默认情况下，Copilot 推送不会自动启动 PR 的 Actions 工作流，需要点击 Approve and run workflows；管理员可能已调整此要求，见仓库设置。

工作流已运行但失败时，查看实际错误，并检查 .github/copilot-instructions.md 是否明确了构建和测试方法。代理内部验证与完整仓库 CI 不一定相同。

防火墙警告

cloud agent 默认通过防火墙限制互联网访问。某个请求被阻止时，Issue 分配任务的 PR 正文或评论触发任务的回复中会出现警告，列出受阻地址及发起请求的命令。

先检查受阻资源是否确为任务所需，再按官方防火墙专题调整允许访问范围。不要仅因下载失败就假定应该全面关闭网络限制。

截图没有被读取

单张图片上限为 3.00 MiB，超出时会从请求移除。检查大小，并使用支持的 PNG、JPEG、GIF、WebP 类型后重新提供。

Chat 声称不能创建 PR

先检查 cloud agent 可用性。官方排障页给出的 IDE Chat 路径要求 VS Code、Visual Studio、JetBrains 提示中包含 @github；GitHub.com Chat 无需这一 participant。该说明针对相应 Chat 路径，不是所有 IDE 委派入口的通用语法，其他入口见IDE 云端委派。