文档中心

云手机

API 参考

错误码

本文提供调用 Computer Use Agent OpenAPI 可能发生的错误和对应的操作建议。

公共错误码

以下列表中包含火山引擎平台通用的基础错误码，主要涉及 HTTP 通信、网关拦截、系统级异常等。

HTTP 状态码	错误码	错误标识	错误描述	操作建议
500	500100	ErrInternalServer	server internal error	服务内部错误。请稍后重试。
400	400100	ErrParsingParams	parsing params error	解析请求参数失败。请检查传入的请求参数是否正确。
400	400101	ErrParamInvalid	validation fail: params:[%s] , value:[%s] validation fail:%s	参数校验失败。您可以根据实际的报错结果定位报错原因。
409	400102	ErrDBDuplicated	duplicated: %s	资源重复。您可以根据实际的报错结果定位报错原因。
400	400103	ErrDbMissing	record not found :%s	资源未找到。您可以根据实际的报错结果定位报错原因。
400	400105	ErrCanNotBeEmpty	%s can't be empty	参数不能为空。您可以根据实际的报错结果定位报错原因。
400	400201	ErrTaskStillExecuting	The task corresponding to thread_id is still being executed	任务仍在执行流程中。请等待任务执行完成，或更换 thread_id 重试。
400	400202	ErrTaskStatusInvalid	[action] [%s] status err	任务状态不正确。您可以根据实际的报错结果定位报错原因。
401	401100	ErrAssumeRoleFailed	"AssumeRole failed. Please attach ServiceRoleForIPaaS: " + url	跨服务调用未授权。调用 Computer Use Agent OpenAPI 前，必须先访问跨服务访问请求为您的账号授权。

业务特定错误码

以下列表列举 Computer Use Agent 服务在其核心执行链路中所触发的业务级错误码。该模块全面覆盖了从资源调度、环境连通、大模型推理、工具流转到人机协作（Human-in-the-loop，HITL）等各业务子场景的定制化报错及排障指引。

错误码 Code	常量名	错误信息 Message	错误说明及解决方式
1000001	REQUEST_INVALID_ARGS	参数缺失或参数格式非法。	请求参数或参数调用方式问题，建议检查 API 入参是否完整且符合规范。
1000002	REQUEST_DUPLICATE	重复提交任务。	建议检查任务是否重复使用。
1000003	REQUEST_CANCEL_FAILED	取消执行操作失败。	目标任务当前状态不支持取消，建议先检查该任务的最新执行状态（如是否已完成或已失败）。若任务状态正常但仍报错，您可尝试稍后重试或检查业务侧是否存在重复提交。
3000001	ENV_APP_NOT_INSTALLED	应用 App 未安装。	设备/账号/网络环境异常，建议在目标实例中安装对应 App 或检查镜像配置。
3000002	ENV_APP_LAUNCH_FAILED	应用 App 启动失败。	应用运行环境异常，建议检查 App 包名、版本是否兼容，或尝试清理环境后重试。系统会自动进行重试机制，若长时间未恢复，您可尝试手动重试。
4000001	AGENT_MAX_STEP_REACHED	Computer Use Agent 任务执行步数超过限制。	Computer Use Agent 任务执行链路过长，建议拆分任务或简化操作流程。
4000002	AGENT_TOKEN_BUDGET_EXCEEDED	执行 Token 数超过限制。	Token 数消耗超限，建议减少不必要的输入或分段执行任务。
4000003	AGENT_TIMEOUT	执行时长超过限制。	任务运行超时，建议检查任务是否由于复杂环境导致的卡顿，必要时手动介入。
4000004	AGENT_STUCK_LOOP	陷入循环或重复操作。	任务规划陷入死循环，建议终止任务并分析可观测链路，调整提示词或任务目标。
4000005	AGENT_NO_STATE_CHANGE	执行多次操作无状态变化。	操作未生效或 UI 反馈异常，建议检查当前页面布局及操作是否准确。系统会自动进行重试机制，若长时间未恢复，您可尝试手动重试。
5000001	HITL_MORE_INFO	任务需要人工补充信息。	建议进行 HITL 流程，由用户补充必要信息。
5000002	HITL_APPROVE	任务需要人工审批信息。	建议进行 HITL 流程，由管理人员或用户完成审批。
5000003	HITL_HUMAN_HELP	任务需要人工协助操作。	建议进行 HITL 流程，由用户完成手动操作。
6000001	MODEL_CALL_FAILED	模型调用失败。	底层大模型推理服务响应异常。系统会自动进行重试机制，若多次失败建议检查模型额度。
6000002	MODEL_TOKEN_EXCEEDED	Token 超限/上下文超长。	输入内容超过了模型的最大上下文长度，建议精简上下文信息。
6000003	MODEL_SAFETY_BLOCK	模型安全策略拦截。	输入或输出内容触碰了安全合规红线，建议调整任务内容。
7000001	TOOL_CALL_FAILED	工具调用失败。	外部插件或 API 工具响应超时/返回错误，建议检查工具。
7000002	TOOL_SKILL_FAILED	技能执行失败。	建议检查技能文件路径及配置。
7000003	TOOL_SCREENSHOT_FAILED	截图失败。	无法获取当前云桌面的屏幕画面，建议稍后重试。
7000004	TOOL_GUIDE_FETCH_FAILED	应用操作指南读取失败。	建议检查操作指南路径及配置。
8000001	RESULT_NOT_ACHIEVED	任务执行失败。	建议检查任务，并提供更清晰、完整的指令信息。
9000001	SECURITY_BLOCKED	禁止高风险操作。	由权限/风控/安全策略等高风险操作拦截，建议调整任务目标，避免涉及系统级修改或高危敏感操作。
9000002	SECURITY_RISK_CONTROL	触发安全风控策略。	任务内容或执行环节触发了平台的安全风控与合规拦截策略，建议检查输入的指令、数据或操作目标是否包含敏感、违规或高风险特征，调整规范后重新提交。
10000001	PLATFORM_UNKNOWN	未知错误。	建议提交工单，联系技术团队提供支持。
10000002	PLATFORM_UNAVAILABLE	服务暂不可用。	系统会自动进行重试机制，若多次失败建议提交工单，联系技术团队提供支持。
10000003	PLATFORM_INCOMPATIBLE	版本不兼容。	建议将 API 升级至官方发布的最新版本后重新发起请求。

最近更新时间：2026.07.03 18:55:53

这个页面对您有帮助吗？

有用

无用