修正 SuperAgent 来源消息 ID 契约
This commit is contained in:
@@ -82,7 +82,7 @@ AI 聚合输出的顶层结构应包含:
|
||||
|
||||
| 字段 | 中文说明 |
|
||||
| --- | --- |
|
||||
| `source_message_id` | 关联的 SourceMessage ID |
|
||||
| `source_message_id` | SuperAgent / Main Agent 原样带回的外部来源消息 ID,对应 AgentBus `source.external_message_id`,不是本系统内部 SourceMessage Inbox 主键 |
|
||||
| `ai_task_results[]` | AI 拆分出的一个或多个任务结果,顺序必须保留 |
|
||||
| `extraction_warnings[]` | 抽取警告,不直接等同于业务任务 |
|
||||
|
||||
@@ -108,7 +108,7 @@ AI 聚合输出的顶层结构应包含:
|
||||
| `additional_operations` | AI 建议的附加动作 |
|
||||
| `idempotency_key` | 幂等键,最终来源和生成规则待确认 |
|
||||
|
||||
待补充的 HTTP 契约包括 URL、Method、Header、鉴权、幂等策略、错误响应格式、是否允许重复推送同一个 `source_message_id`。
|
||||
HTTP 契约已在 `docs/project/requirements/M002-superagent-task-result-api-contract.md` 和 `docs/project/integrations/superagent-api-contract.md` 中补充。正式契约要求任务结果通知携带 `hotel_id + source_message_id`,其中 `source_message_id` 是外部来源消息 ID;后端会反查内部 SourceMessage Inbox ID 后再写入 `workflow_*` 表。
|
||||
|
||||
## 6. AI 过渡层数据要求
|
||||
|
||||
@@ -131,7 +131,7 @@ AI 聚合输出的顶层结构应包含:
|
||||
|
||||
| 物理列 | 中文说明 |
|
||||
| --- | --- |
|
||||
| `source_message_id` | 来源消息 ID |
|
||||
| `source_message_id` | 内部 SourceMessage Inbox ID,来自外部 `source_message_id` 反查后的 `platform_source_message_inbox.id` |
|
||||
| `source_event_index` | AI 事件序号 |
|
||||
| `catalog_code` | Skill 目录代码 |
|
||||
| `skill_id` | Skill 标识 |
|
||||
@@ -484,6 +484,7 @@ Fallback 处理规则:
|
||||
|
||||
- SuperAgent 创建任务接口的 URL、Method、Header、鉴权和错误响应格式。
|
||||
- SuperAgent 查询上下文接口 1、2 已实现最小字段版,并已启用与任务结果接收接口一致的 HMAC;接口 3 文件解析和接口 4 订单及任务查询仍需后续确认与实现,后续梳理未完成事项时必须持续提醒。
|
||||
- SuperAgent 任务结果通知中的 `source_message_id` 已确认是外部来源消息 ID,对应 AgentBus `source.external_message_id`;查询接口中的 `source_message_id` 和 `source_event_index` 第一版接收但忽略。
|
||||
- `source_event_index`、批次 item index、`execution_order` 的最终编号规则是否都从 1 开始。
|
||||
- SuperAgent 查询上下文接口 3、4 的 URL、入参、返回字段和鉴权方式。
|
||||
- `Message Notification` 是否需要在前端订单列表上单独标识为只读提醒。
|
||||
|
||||
Reference in New Issue
Block a user