进出口商品报关

何时使用：

当用户提到下列意图时，使用本技能：

需要做商品报关操作，或需要生成报关单，或报关单AI制单
出口货物报关
进口货物报关

支持的文件格式：

.doc .docx .xls .xlsx .pdf .png .jpg .jpeg .zip .rar .7z

若用户上传的文件不在上述格式中，提醒用户转换为支持的格式后重新上传。

数据隐私提醒：

在调用脚本前，需告知用户：上传的报关资料文档将通过网络传输至小麦云服务端进行处理，请确认文档中不包含非报关所需的敏感信息。

处理流程：

如果用户没有上传任何文件，提醒用户：请上传需要报关的商品信息，比如发票、装箱单、合同、报关单等文档（表格、PDF、图片、压缩包都可以）；

如果用户上传了文件，从对话上下文中定位用户上传文件的绝对路径（host 以 <local_files>/<active_document> 形式；这个路径将作为运行 python 脚本的 --file_path 参数。

若有多个文件，提醒用户：请压缩成一个 .zip 文件后再上传。
分析用户的意图是出口还是进口报关。

如果是要做进口商品报关，则运行 python 脚本的 --ie_type 参数需要传递 I，表示 import 进口的报关单。

如果是出口报关或没有提到是进口还是出口，则默认是出口报关，不用传递 --ie_type 参数。

如果用户表达错误或想同时做出口和进口报关，则提醒用户一次只能选一种报关模式。
调用 python 脚本，建议通过 --output 参数指定输出 PDF 的保存路径（保存到当前工作目录下即可），例如：

python scripts/declare.py --file_path=D:\Downloads\发票.pdf --output=.\报关单.pdf

可以像黑盒一样调用这个 python 脚本，不用展开读取 python 脚本内容。
脚本大概需要 20 秒~5 分钟完成，完成后会生成一张报关单 PDF 文件，呈现这个 PDF 文件给用户。

脚本运行期间，可以向用户说明：正在处理报关单，通常需要 30秒~5 分钟，请耐心等待。

异常处理：

| 场景 | 处理方式 | | --- | --- | | 脚本输出 ERROR: 找不到输入文件 | 检查文件路径是否正确，重新定位文件绝对路径后重试 | | 脚本输出 ERROR: 不支持的文件类型 | 提醒用户支持的文件格式，请用户转换格式后重新上传 | | 脚本输出 ERROR: 免费次数超限 | 提醒用户如下内容：<br/>尊敬的用户，您好，您使用该技能已达免费上限，如需要更加全面的AI报关智能制单等服务，请注册并登陆“小麦云跨境智能综服平台”（https://ai.szxmytech.com），您将得到更加优质全面的服务，谢谢！ | | 脚本输出 ERROR: 请求超时 或 ERROR: 无法连接服务器 | 告知用户网络异常，建议检查网络后稍后重试 | | 脚本输出 ERROR: 服务繁忙 | 告知用户服务端繁忙，建议稍后重试 | | 脚本输出 ERROR: 报关单生成超时 | 告知用户处理超时，可能因文档内容复杂或服务排队，建议稍后重试 | | 脚本输出 ERROR: 服务器返回错误 或 ``ERROR: 报关处理失败` | 告知用户服务端异常，建议稍后重试或联系客服 | | 脚本发生其他未知错误 | 将脚本的 ERROR 输出转述给用户，建议稍后重试 |

脚本用法示例：

# 出口报关（默认）
python scripts/declare.py --file_path=D:\Downloads\发票.pdf --output=.\报关单.pdf

# 进口报关
python scripts/declare.py --file_path=D:\Downloads\进口发票.pdf --ie_type=I --output=.\进口报关单.pdf

输入参数

| 参数名称 | 是否必需 | 参数描述 | 样例 | | --------- | -------- | ------------------------------------------------------------ | ---- | | file_path | 是 | 用户上传的报关资料绝对路径。 | | | ie_type | 否 | 进出口标识。取值只有两个："E" 或 "I"，"E" 代表 export 出口，"I" 代表 import 进口，默认为 "E" | "E" | | output | 否 | 输出 PDF 文件的保存路径。未指定时保存到当前目录，文件名格式为 报关单_{job_id}.pdf | .\报关单.pdf |