400

Validation error

必填字段缺失 / 类型错误

对照参数表逐项核对

401

Unauthorized / token expired

JWT 缺失/过期/格式错；Authorization 不以 Bearer 开头

重新换 JWT；检查 Header 格式

403

client / agent / proxyUser not allowed

clientId 未授权、agentId 不可见、代理白名单未配

联系部署方核对授权

404

task not found

taskId 错误或过期被清理

检查 taskId

429

rate limit exceeded

clientId 触发 QPS 限流

降并发 / 联系风神 oncall 提 QPS

500

internal server error

智能体执行内部异常

简化 query；保留 taskId 联系技术支持

body.code != "llm/ok"

业务侧失败

执行超时 / 文件解析错

拉 taskDetail 看 failed 详情