用途：在 Netlify 基础设施上远程运行 AI 编码代理（Claude、Codex、Gemini），对站点连接的仓库执行开发任务，例如代码审查、安全审计、性能优化、SEO 与无障碍检查、补测试、写文档等。
主要能力：通过 netlify agents:* 命令创建、查看、列出和停止代理任务；支持指定代理类型、提示词、基础分支、模型和项目；任务异步执行，结果推送到新分支并生成 Deploy Preview，不覆盖原分支。
使用方式：需先安装并认证 Netlify CLI，站点需通过 netlify link 或 netlify init 关联项目，也可用 --project <name> 直接指定项目。创建任务示例：netlify agents:create "Add a contact form"；指定代理：netlify agents:create -p "Add dark mode" -a claude；指定分支：-b feature-branch；输出 JSON：--json。查看状态：netlify agents:show <task-id>；列出任务：netlify agents:list；停止任务：netlify agents:stop <task-id>。
限制：任务运行在远程，只能看到已提交并推送的代码，看不到本地未提交改动；默认基于生产分支，可用 -b 指定其他已推送分支；任务异步且无回调，需轮询状态，状态为 new、running、done、error、cancelled；所有 agents:* 命令按项目作用域，无团队级列表；运行消耗套餐额度，额度不足或达到 AI 使用上限时创建会被阻止；仅使用文档化的 CLI 接口，不要用 curl 或 netlify api 绕过。作为代理使用时，运行前必须获得用户明确许可。