---
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`。
