企业官网建设流程全解析

ego-lite 报 user is controlling 错误？为什么 Agent 绝不能自动重试

【免费下载链接】ego-liteThe fastest browser for AI agents to run browser automation, built for sharing your logged-in browser state with your AI agents, like Codex or Claude Code, without disturbing you. Zero cost, zero config.项目地址: https://gitcode.com/GitHub_Trending/eg/ego-lite

ego-lite 是一款专为 AI Agent 打造的浏览器：你的 Agent（如 Codex、Claude Code）在自己的隔离 Space 里执行浏览器自动化，复用你已登录的浏览器状态，而不会打扰你正在浏览的标签页。零成本、零配置。当 Agent 操作浏览器时，如果突然报出user is controlling错误，很多新手会本能地让 Agent 重试——但这恰恰是最危险的做法。本文讲清楚这个错误到底是什么、为什么它是"硬停止"，以及正确的恢复姿势。

这个错误到底意味着什么？

user is controlling（即错误码EGO_TASK_SPACE_USER_IN_CONTROL）表示：你正在手动接管这个任务 Space 的控制权。用户可以在浏览器 GUI 里随时接管，效果等同于 Agent 主动调用了handOffTaskSpace。此时浏览器端会暂停所有 Agent 发起的指令，任何点击、填写、截图等操作都会直接失败。

关键点在于语义：这不是网络抖动、不是元素没加载出来，而是人主动把浏览器拿了回去。它通常出现在两种场景：

• Agent 的操作走向偏离预期，你手动介入纠正；
• 任务需要人工干预（登录、验证码、手动确认），Agent 已把控制权交还给你。

在 SKILL.md 的 Control handoff 章节中，官方措辞非常直白：

A "user is controlling" error is a hard stop on the whole task — not an obstacle to route around.

翻译过来就是：这是整个任务的硬停止，不是一个可以绕过去的障碍。

为什么 Agent 绝不能自动重试？

1. 重试等于违背用户的明确意图

错误产生的瞬间，浏览器控制权已经在用户手上。此刻 Agent 每多试一次，都是在"抢回"用户刚拿走的控制权——这在语义上就是把人推开、继续干自己的事。官方文档明确说：

The only thing you may do isask the user and wait.（唯一允许做的，就是询问用户并等待。）

Agent 硬推任务目标，才是这里真正的"失败"。

2. 自动夺回控制权会打断用户的操作

takeOverTaskSpace没有任何所有权检查，调用就会立刻把浏览器从用户手里夺走。如果 Agent 在报错后自动调用它，用户可能正在 Space 里手动修正页面状态，结果被 Agent 一把"抢走"——这正是这个错误想避免的事故。

3. 错误码是稳定契约，重试策略是内置的

ego-lite 的运行时把错误分成两类：可重试的瞬时错误（如元素引用失效）和硬停止错误。user is controlling与task space inactive一起被归类为hard stop，源码中的判断逻辑在 ego-errors.ts：

function isEgoHardStopCode(code: string | undefined): boolean { return ( code === "EGO_TASK_SPACE_USER_IN_CONTROL" || code === "EGO_TASK_SPACE_INACTIVE" ); }

而且错误信息本身就是给 Agent 的行动指南（ego-errors.ts），里面写着：do not retry and do not take control back on your own（不要重试，也不要自行夺回控制权），等用户明确说"continue"后再takeOver恢复。

4. 运行时会替你"降噪"：重试只会产生噪音

一个容易被忽略的细节：如果 Agent 用循环 + try/catch 不断重试，每次迭代都会打出同样的报错，日志被刷屏。ego-lite 的输出管道专门为此设计——在 output-sink.ts 中，硬停止错误只会被记录一次，运行时结束时丢弃整个输出缓冲，只留下这一条干净的指导信息。换句话说，框架层面也在帮你把"重试风暴"压缩成一句话：停下来，问用户。

正确的恢复姿势：三步握手

✅Agent 交出控制权：任务遇到登录、验证码、需要人工确认时，Agent 应主动调用handOffTaskSpace，并告诉用户具体要做什么。

✅用户操作并确认：你完成人工操作后，通过"Continue / Finish task"选项或一句 "continue" 明确确认。

✅Agent 夺回控制权：只有收到明确确认后，Agent 才在新的一轮脚本里调用takeOverTaskSpace继续任务；若用户选择结束，则用completeTaskSpace(nameOrId, { keep })收尾。

相关的完整规则可参考 skills/ego-browser/SKILL.md，错误处理实现位于 package/ego-browser/src/ego-errors.ts。

新手常见问题

Q：报了这个错，Agent 换个方式继续干行不行？

不行。"绕开"和"重试"一样，都属于硬停止被违背的情形。等待用户明确确认是唯一合法路径。

Q：Agent 交还控制权后一直等，会不会卡死？

不会。waitForAgentControl是只读的阻塞轮询（绝不夺取控制权），只在当前脚本内等待"自己发起的交还"；跨轮次的恢复靠用户确认后的一轮新脚本。

Q：user is controlling 和任务 Space inactive 有什么区别？

inactive表示用户已接管并结束了任务，该 Space 不再分配给 Agent；两者同为硬停止，都需要用户明确说"继续"才能恢复（inactive 场景用claimTaskSpace接管）。

总结

• user is controlling是用户主动接管的信号，不是技术故障；
• Agent 的正确反应只有三个字：停、问、等；
• 自动重试或自动夺回控制权 = 违背用户意图，是真正的失败；
• 恢复的唯一路径：用户明确确认 →takeOverTaskSpace→ 继续任务。

把这个错误理解成"用户在举手示意"，而不是"系统抛出的异常"，你和 Agent 的协作就会顺畅得多。

【免费下载链接】ego-liteThe fastest browser for AI agents to run browser automation, built for sharing your logged-in browser state with your AI agents, like Codex or Claude Code, without disturbing you. Zero cost, zero config.项目地址: https://gitcode.com/GitHub_Trending/eg/ego-lite