错误码速查 - MiniMax Agent 文档

miniapp 工具

code	含义与处理
`BUSY`	`busyReason` 为 `capacity_busy`：3 个服务名额已满，停掉一个再重试；`operation_busy`：同一插件有操作在进行，稍后重试一次
`PREPARATION_FAILED`	准备失败，带 `diagnostic.stage`、`reasonCode`、`recovery`、`hint`，按 `recovery` 处理
`PLUGIN_ALREADY_EXISTS`	同名插件已存在；附带 `OFFICIAL_PLUGIN_READ_ONLY` 时表示和官方插件同名，不可重试
`OPEN_UNAVAILABLE`	当前宿主没有提供打开页面的界面
`INTERNAL_ERROR`	宿主内部错误，带 `diagnosticId`，可能带 `lastGoodAvailable`；不要原样重试
`READINESS_TIMEOUT`	启动失败原因：进程没有在时限内就绪，见端口鉴权
`MINIAPP_AGENT_ACCESS_INVALID`	发布时 `agentAccess` 取值不合法

Host Connector

code	含义
`TOOL_REF_STALE`	工具引用过期，重新 `list()`
`SERVICE_RESTARTED`	服务已重启，重新 `list()`
`REQUEST_CANCELLED`	请求被取消
`CONNECTOR_TIMEOUT`	请求超时
`INVALID_ARGUMENTS`	参数不符合 schema，看 `diagnostic.issues`
`CONNECTOR_PROVIDER_ERROR`	第三方服务返回错误
`CONNECTOR_UNAVAILABLE`	连接器不可用
`CONNECTOR_OUTCOME_UNKNOWN`	已发出但结果未知，先核对业务状态

Agent API

code	含义
`NOT_PERMITTED`	manifest 没有声明 `agentAccess`
`BUSY`	`session_busy`：该会话已有回合在运行；`queue_full`：排队已满。可重试
`SESSION_NOT_FOUND`	会话不存在，或不属于这个 Mini App
`INVALID_ARGUMENTS`	参数不合法，比如不可用的模型、续用会话时传了 `agent`
`AGENT_UNAVAILABLE`	什么都没启动；包括调用方进程已被替换、同时进行的请求过多
`REQUEST_CANCELLED`	还没发出就被取消
`AGENT_OUTCOME_UNKNOWN`	回合可能已经跑过，先核对，不要自动重试
`REQUEST_NOT_FOUND`	审批或问卷不存在，或已经处理过

页面侧的部分错误以小写形式返回，比如 not_permitted、invalid_request。

页面 API

API	错误
`message.append`	`user_cancelled`、`invalid_request`、`text_too_large`、`not_allowed`、`target_unavailable`、`result_unknown`
`miniapp.window`	`inline_mode`、`not_permitted`、`busy`、`result_unknown`、`invalid_request`