> ## Documentation Index
> Fetch the complete documentation index at: https://agent.minimaxi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 错误码速查

> miniapp 工具、Host Connector、Agent API 和页面 API 的公开错误码。

## 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` | 启动失败原因：进程没有在时限内就绪，见[端口鉴权](/docs/miniapp/authors/node-runtime#auth) |
| `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` |