错误、权限与环境

HTTP / code

已核分支

400 / 2

参数/候选不合法;不满足同工作区绑定资格的ErrAgentReadOnly当前也经skill错误默认分支映射400,不能机械写成403。

404 / 3

原任务、owner、manifest、native候选或技能引用不可用的部分分支;消息使用skill not found,不公开内部缺失层次。

409 / 4

同预留ID存在但内容摘要或创建者不匹配等重复冲突。

409 / 9并带绑定失败reason

技能已保存、后续绑定失败;reason/domain/saved_skill_id用于恢复。code9本身不够区分所有冲突。

403 / 5

skill只读或授权拒绝分支;绑定阶段拒绝还可能包为409保存后绑定失败。

503 / 15

授权或技能依赖不可用分支;不是所有绑定失败都透传503。

500 / 1

绑定错误本地化异常等显式分支;不保证此时附saved_skill_id。

成功数字code0/data;普通skill错误为code/message,绑定失败增加details。身份校验发生在handler之前,可用字符串code/msg,不统一成数字错误。未知错误当前还可能由skill错误默认分支映射400并带错误文本,不能替它写统一500。

{
  "code": 9,
  "message": "The skill was saved, but could not be added to this agent. Retry to finish adding it.",
  "details": {
    "reason": "SKILL_CREATOR_BINDING_FAILED",
    "domain": "moi-core.catalog.agent-resource",
    "saved_skill_id": "skill-example"
  }
}

message按服务端语言返回,上例为en-US目录值;用details.reason判别绑定失败,不硬匹配本地化消息。无论何种错误或超时,保存状态不明时均先回查原候选。

最后更新于