# 轮询等待期互动话术参考

在异步任务轮询等待期间，根据当前状态和累计等待时长，选用以下话术与用户互动。
**不要沉默等待，每次轮询后都应输出一条互动消息。**

> **说明**：话术中的 `{progress}` 来自 `submit_and_poll.py` 通过 stderr 输出的 JSON 中的 `progress` 字段（0–100 整数）。`{elapsed}` 为累计等待秒数，`{error_message}` 为 `error_message` 字段。如平台不支持流式响应，上述话术在脚本返回后根据 stderr 记录输出即可。

---

## 分类任务等待话术（classify_fast）

| 累计等待时长 | 话术示例 |
|------------|---------|
| 0–5 秒（首次轮询前）| 🔍 分类任务已提交！AI 正在逐页扫描文档，识别发票、装箱单、提单等单证类型，请稍候... |
| 5–15 秒 | ⏳ 系统正在分析文档结构，将相邻同类型页面合并为「分片」(segment)... |
| 15–25 秒 | 📊 AI 模型正在对每一页计算分类置信度，确保识别结果准确... |
| 25–40 秒 | 💡 **报关知识**：标准出口报关需要三大核心单证——商业发票 (Invoice)、装箱单 (Packing List) 和提运单 (Bill of Lading)。系统正在帮您自动识别这些类型 ✨ |
| 40–60 秒 | 🔄 还在处理中...多页混合 PDF 识别通常需要 30–60 秒，文件越大越久。进度：{progress}% |
| > 60 秒 | ☕ 稍微久了些，但 AI 正在仔细校对每页的置信度，好结果值得等待！进度：{progress}% |

---

## 报关任务等待话术（customs）

| 累计等待时长 | 话术示例 |
|------------|---------|
| 0–5 秒（首次轮询前）| 🏗️ 报关任务已提交！系统正在根据分类结果提取报关数据（商品编码、金额、重量等），请稍候... |
| 5–15 秒 | 📝 正在识别发票中的商品明细——品名、规格型号、数量、单价、总价... |
| 15–25 秒 | 🔢 正在比对商品 HS 编码和法定计量单位，这一步需要对照海关编码体系... |
| 25–40 秒 | 📋 正在汇总报关单表头：申报单位、贸易国别、成交方式、运输方式、总金额... |
| 40–55 秒 | 📑 正在将提取的数据写入标准化报关 Excel 文件，格式符合海关系统要求... |
| > 55 秒 | ☕ 品项较多，AI 在仔细核对每一项数据，确保报关准确性。进度：{progress}% |

---

## 通用状态消息

| 场景 | 消息 |
|------|------|
| 任务进入 `processing` | ⚙️ 任务已开始处理（进度：{progress}%）... |
| 任务仍为 `pending` | 📬 任务排队中，等待处理器分配资源... |
| 任务 `completed` | ✅ 处理完成！共耗时约 {elapsed}秒 |
| 任务 `failed` | ❌ 任务失败：{error_message}。建议检查源文件是否完整，或尝试重试。 |
| 轮询超时（等待超过 300 秒后） | 🕐 已等待超过 5 分钟，任务可能仍在执行。可稍后用以下命令手动查询：<br>`python scripts/submit_and_poll.py --mode poll --result-id <result_id>` |