1.1 KiB
1.1 KiB
agent-intent 错误码映射
agent-intent v1 无 HTTP 面，核心包按 Pattern B 接入：错误常量的字符串值即下列规范码，错误类型实现 ErrorCode() / ErrorFields() 鸭子方法供日志系统展开；其仓内 catalogcheck 对齐测试保证两边常量相等，本表是人类可读对照。
| agent-intent 常量 | 规范码 | HTTP | 触发场景 |
|---|---|---|---|
intent.InvalidSpec |
intent.invalid_spec | 400 | spec 定义/校验失败：id 冲突、正则不合法、未知字段、matcher 无正向条件、槽位 group 越界、覆盖版本未递增 |
intent.SpecProtected |
intent.spec_protected | 400 | overlay 试图覆盖或禁用保护域内的 spec |
intent.LoadFailed |
intent.load_failed | 500 | 配置读取/解析失败；此时保留上一生效快照 |
intent.InvalidArgument（复用框架域） |
sys.invalid_argument | 400 | 调用方错误：nil 快照、输入超长 |
「无匹配」（fallback 分支）是正常识别结果，不产生错误码；识别路径的失败语义与重试由宿主决定。