ambleloft错误代码与排错
从错误代码判断下一步，从业务真实状态判断是否可以重试。
API 参考
按章节查看契约、签名、字段与示例；未注明的默认值不作推断。
本页内容
01校验与权限
优先修正声明、输入与授权，不通过无限重试掩盖契约错误。
| 字段 / API | 说明 |
|---|---|
| INVALID_ARGUMENT / INVALID_OUTPUT | 输入/返回值不符合契约，检查 schema 与绑定。 |
| NOT_FOUND / UNSUPPORTED | 资源不存在或宿主不支持；核对版本和目标 ID。 |
| UNTRUSTED / DISABLED / FORBIDDEN | 检查安装信任、启用状态和调用范围。 |
| GRANT_REQUIRED / INTERACTION_REQUIRED | 通过宿主页面交互获得授权，不由 Agent 伪造确认。 |
02运行与并发
保留 requestId 和 effectStatus。业务状态不确定时查询恢复，尤其避免重复写入。
| 字段 / API | 说明 |
|---|---|
| CANCELLED / TIMEOUT / OUTCOME_UNKNOWN | 取消或超时不证明业务未执行；查询 submissionId / invocationId。 |
| BUSY / CONFLICT | 处理并发与 revision 冲突，重读状态后决定。 |
| ACTIVATION_FAILED / HOST_UNAVAILABLE | 检查扩展激活日志、宿主及服务状态。 |
| STORAGE_UNAVAILABLE / QUOTA_EXCEEDED | 检查存储可用性或配额，避免循环重试。 |
| INTERNAL | 保留诊断信息；未知处理函数错误可能映射到 INTERNAL。 |
03定位常见现象
按运行链路逐层定位：安装包 → 声明 → 激活 → 工具发现 → 用户确认 → 业务服务 → 返回 schema。
| 字段 / API | 说明 |
|---|---|
| Icon missing | 确认实际归档有 assets，使用静态 PNG 且宿主兼容。 |
| Form missing | 检查 skills 目录、amble-form-ref 相对路径及模型工具调用。 |
| Operation missing | 核对 id、handler 注册、exposeTo、扩展启用与权限。 |
| No message | 检查 UNSUPPORTED、发布返回状态、用户 receive/muted 和服务连接。 |
| Action never completes | handler 返回不等于完成；检查 reportActionResult。 |