83 lines
3.3 KiB
Markdown
83 lines
3.3 KiB
Markdown
---
|
||
name: tycm-callback
|
||
description: TYCM审核结果回推。将AI审核结果状态、原因和Markdown报告通过HTTP POST回推到TYCM车主权益管理系统的/agent-invoke-callback接口；不使用token鉴权，支持dryRun链路验证，并在审核异常时回推failed状态。
|
||
license: MIT
|
||
metadata:
|
||
version: "1.2.0"
|
||
category: integration
|
||
skillType: compute-entry
|
||
tags: ["tycm", "callback", "投保审核"]
|
||
---
|
||
|
||
# TYCM审核结果回推
|
||
|
||
当 AIflow 已得到审核结论，或 OCR、规则审核、报告生成任一步骤失败时，都必须调用本技能给 TYCM 一个最终响应。只允许回调 TYCM 的 `/agent-invoke-callback` 接口，不再使用 `/ai-audit-callback`。
|
||
|
||
优先使用 TYCM 发起请求时传入的 `message.callbackUrl`。如果上游误传了 `/ai-audit-callback`，本技能会在发送前自动改写为 `/agent-invoke-callback`。如果 URL 中带有 `token`，本技能会自动移除。
|
||
|
||
```json
|
||
{
|
||
"name": "tycm-callback",
|
||
"input": {
|
||
"callbackUrl": "http://127.0.0.1:5610/system/order/agent-invoke-callback?orderNo=20260427093006929543",
|
||
"orderNo": "20260427093006929543",
|
||
"status": "manual_review",
|
||
"reason": "购买方名称不一致，需人工复核",
|
||
"reportMarkdown": "# 审核报告\\n..."
|
||
}
|
||
}
|
||
```
|
||
|
||
## 使用规则
|
||
|
||
- 审核成功通过时回调 `status: "approved"`。
|
||
- 审核明确驳回时回调 `status: "rejected"`。
|
||
- 需要人工干预时回调 `status: "manual_review"`。
|
||
- AI、OCR、规则执行、报告生成或其他链路异常时也必须回调，使用 `status: "failed"`，并在 `reason` 中写明失败原因。
|
||
- 不要调用 `/ai-audit-callback`。本技能不会生成 HMAC 签名。
|
||
- 不要传 token。本技能不会写 `X-AiFlow-Token`，也会从 callbackUrl query 中删除 `token`。
|
||
|
||
## 输入
|
||
|
||
- `callbackUrl`: 必填，TYCM回调地址。优先使用 TYCM 传入的 `message.callbackUrl`。
|
||
- `orderNo`: 必填，订单号或理赔单号。
|
||
- `status`: 可选，推荐直接传 `approved`、`rejected`、`manual_review`、`failed`；也兼容 `PASS`、`REJECT`、`MANUAL_REVIEW` 等旧值。缺失或无法识别时会按 `failed` 回调。
|
||
- `reason`: 可选，审核原因或失败原因。
|
||
- `reportMarkdown`: 可选，Markdown报告正文。
|
||
- `auditResult`: 可选，完整审核JSON，会随body回传，并可作为 `orderNo/status/reason/reportMarkdown` 的补充来源。
|
||
- `timeoutMs`: 可选，默认 `15000`。
|
||
- `retries`: 可选，默认 `1`。
|
||
- `dryRun`: 可选，`true` 时只生成请求，不发HTTP请求。
|
||
- `extra`: 可选，会合并到请求body中；合并后仍会强制规范 `orderNo/status/reason/reportMarkdown`。
|
||
|
||
## 环境变量
|
||
|
||
- `TYCM_CALLBACK_TIMEOUT_MS`: HTTP超时，默认 `15000`。
|
||
- `TYCM_CALLBACK_RETRIES`: HTTP失败重试次数，默认 `1`。
|
||
|
||
## 输出
|
||
|
||
成功时返回：
|
||
|
||
```json
|
||
{
|
||
"success": true,
|
||
"dryRun": false,
|
||
"statusCode": 200,
|
||
"response": {},
|
||
"request": {
|
||
"url": ".../agent-invoke-callback?orderNo=...",
|
||
"authMode": "none",
|
||
"headers": { "Content-Type": "application/json" },
|
||
"body": {
|
||
"orderNo": "20260427093006929543",
|
||
"status": "manual_review",
|
||
"reason": "购买方名称不一致，需人工复核",
|
||
"reportMarkdown": "# 审核报告\n..."
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
详细协议见 `references/tycm_callback_contract.md`。
|