agent worker debug
对私有 Worker 运行预检诊断(身份验证、隐私、路由)。
agent worker debug 是一个终端子命令,直接在 shell 中调用。根据参考文档,它会为私有云 worker 执行预检诊断,在 worker 真正运行之前检查身份验证、隐私设置和路由是否正常。加上 --json 参数后,命令会以机器可读的格式输出诊断报告,方便在脚本中进一步处理,或附加到 bug 报告中。
worker 相关功能没有对应的斜杠命令;worker 功能只能通过 agent worker 下的终端子命令访问,比如还有 agent worker start。
agent worker debug 本身不会启动 worker,只是检查启动所需的前提条件是否满足。如果配置已经确认可以正常工作,比如之前成功运行过一次,你可以跳过诊断步骤,直接调用 agent worker start 来连接 worker。
✅ 什么时候用?
首次启动前先排查问题
在新 worker 正式投入使用之前执行 agent worker debug --json
缩小 worker 连接问题的范围
执行 agent worker debug,检查问题出在身份验证、隐私设置还是路由
⛔ 什么时候不该用?
想让 worker 立刻投入使用
agent worker debug 不会启动 worker,它只检查前提条件。
更好的选择: 如果配置已经确认可用,直接使用 agent worker start
来源
- Cursor 官方文档——CLI 参考:参数(Parameters) ↗ cursor.com