Add the intent seed domain for the agent-intent module.
ci / vet-and-test (push) Successful in 2s
ci / docker-checkout-hostgateway (push) Successful in 3s

This commit is contained in:
weichen
2026-09-29 15:18:32 +00:00
parent 95a03b7578
commit 28fa06eaa5
9 changed files with 68 additions and 6 deletions
+12
View File
@@ -0,0 +1,12 @@
# 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 分支)是正常识别结果,不产生错误码;识别路径的失败语义与重试由宿主决定。