docs/README.md

# 港口物流业务智能体综合解决方案

## 一、项目背景

随着港口件杂货、船舶代理及“集装箱走散货船”等业务量持续增加，企业在业务执行过程中需要处理大量订舱资料、船舶单证、装箱资料、报关相关资料、货物明细及客户往来文件。

目前，这类工作通常高度依赖业务人员人工完成，主要面临以下问题：

- 客户资料来源分散，涉及微信、邮件、Excel、Word、PDF、图片等多种渠道和格式；
- 同一业务信息需要在多份单证和系统中反复录入；
- 船名、航次、提单号、箱号、封号、件数、重量、体积、港口等字段容易录错或漏填；
- 不同单证之间缺少自动交叉校验；
- 不同客户、船公司、港口和航线存在不同的单证要求；
- 件杂货及“集装箱走散货船”等业务规则较为复杂；
- 业务量集中到来时，人工处理效率难以快速提升；
- 新员工需要较长时间熟悉业务规则和操作流程；
- 业务经验主要掌握在个人手中，难以形成企业统一的数字化资产；
- ERP、船公司、港口等系统之间缺少有效协同。

基于以上情况，建议依托我方“匠厂智能体平台”，为企业建设一套面向港口物流业务的综合智能体系统。

该系统不是简单的聊天机器人，也不是单一的单证生成工具，而是一套能够读取业务资料、理解企业规则、调用专业技能、生成业务单证、检查数据差异、协同ERP及外部平台，并由业务人员审核确认的企业级AI业务系统。

---

## 二、项目建设目标

本项目围绕“资料自动处理、业务自动建档、单证自动生成、数据智能校验、系统协同操作、企业知识沉淀”六个方向展开。

### 2.1 提高资料处理效率

让AI自动读取客户提交的Excel、Word、PDF、图片及其他业务文件，识别并整理其中的关键业务信息，减少人工查找、复制、粘贴和重复录入。

### 2.2 提高单证制作效率

基于统一业务档案和企业现有模板，自动生成装箱单、货物清单、提单补料、订舱资料、箱号封号清单及其他业务单证。

### 2.3 降低业务差错率

自动检查不同资料及单证中的船名、航次、提单号、件数、重量、体积、箱号、封号、收发货人、港口等信息是否一致，并对异常数据进行提示。

### 2.4 建立标准业务流程

将企业现有操作经验、单证模板、字段规则、审核标准和异常处理方式转化为智能体可以调用的业务Skill，降低企业对个人经验的依赖。

### 2.5 实现系统协同

根据客户现有ERP及外部平台的实际条件，实现数据导入、接口对接、辅助录入、船期查询、进度跟踪和业务提醒。

### 2.6 沉淀企业知识资产

逐步建立企业自己的客户档案、港口规则、船公司要求、单证规范、报价规则、异常案例及标准作业流程知识库。

---

## 三、总体建设思路

本项目采用“一个港口物流业务智能体 + 一套企业知识库 + 多个业务Skill”的总体架构。

```mermaid
flowchart LR
    A["客户业务资料<br/>微信、邮件、Excel、PDF、图片"] --> B["港口物流业务智能体"]
    K["企业知识库<br/>客户、港口、船公司、单证和报价规则"] --> B
    B --> C["资料识别与业务建档"]
    B --> D["业务单证自动生成"]
    B --> E["跨单证一致性校验"]
    B --> F["ERP系统协同"]
    B --> G["船期与业务进度查询"]
    B --> H["报价测算与异常预警"]
    C --> I["业务人员审核确认"]
    D --> I
    E --> I
    F --> I
    G --> I
    H --> I
    I --> J["导出、录入、发送或提交"]
```

每一项业务能力均建设为独立Skill，并由港口物流业务智能体统一调度。

这种架构具有以下特点：

- 可以根据不同业务流程组合多个Skill；
- 可以持续增加新的业务能力；
- 可以扩展新的单证模板；
- 可以增加不同客户、船公司和港口的业务规则；
- 可以对接ERP、邮件、船期查询及其他外部系统；
- 当业务规则发生变化时，只需更新对应知识库或Skill；
- 避免每增加一项需求就重新开发整套系统。

---

## 四、总体业务流程

项目建成后的标准工作流程如下：

```mermaid
flowchart TD
    A["接收客户资料"] --> B["自动识别文件类型"]
    B --> C["提取关键业务字段"]
    C --> D["建立统一业务档案"]
    D --> E["检查资料完整性"]
    E --> F{"资料是否完整"}
    F -- "否" --> G["生成缺失资料清单"]
    G --> H["业务人员补充或确认"]
    H --> D
    F -- "是" --> I["生成相关业务单证"]
    I --> J["执行跨单证一致性校验"]
    J --> K{"是否存在异常"}
    K -- "是" --> L["生成异常清单及处理建议"]
    L --> M["业务人员审核修改"]
    M --> J
    K -- "否" --> N["业务人员最终确认"]
    N --> O["导出单证或写入ERP"]
    O --> P["跟踪船期和业务节点"]
    P --> Q["归档业务资料和操作日志"]
```

---

## 五、核心功能规划

### 5.1 客户资料智能接收与分类

智能体读取客户提供的业务资料，并自动判断文件类型，包括但不限于：

- 订舱委托书；
- 装箱单；
- 商业发票；
- 报关相关资料；
- 提单补料；
- 舱单或船舶资料；
- 箱号、封号清单；
- 件杂货货物明细；
- 集装箱走散货船业务资料；
- 客户自定义Excel；
- Word、PDF及图片附件；
- 企业其他业务文件。

系统完成资料分类、文件命名、业务归档，并判断资料是否齐全。

### 5.2 关键业务字段智能提取

智能体从不同文件中提取并结构化整理关键字段，包括但不限于：

- 委托单位；
- 发货人、收货人、通知人；
- 船名、航次及船公司；
- 起运港、目的港及中转港；
- 提单号、订舱号及业务编号；
- 品名、件数及包装方式；
- 毛重、净重及体积；
- 箱型、箱量、箱号及封号；
- 唛头及货物描述；
- 报关、截单、装船及到港时间；
- 企业其他自定义字段。

对于无法识别、存在冲突或有歧义的内容，系统不自行猜测，而是进行标记并交由业务人员确认。

### 5.3 统一业务档案自动建立

智能体根据识别结果自动生成统一业务档案，作为后续单证制作、数据校验和ERP协同的数据源。

业务档案可包含：

- 项目及客户信息；
- 船舶及航次信息；
- 港口及航线信息；
- 货物明细；
- 集装箱明细；
- 单证处理状态；
- 已收到资料；
- 缺失资料；
- 异常提示；
- 经办人员；
- 审核人员；
- 操作及修改记录。

通过“一次识别、统一建档、多处使用”，减少相同信息在不同单证和系统中的反复填写。

### 5.4 业务资料完整性检查

系统根据业务类型和企业规则，检查资料是否完整，例如：

- 是否已提供订舱资料；
- 是否缺少货物明细；
- 是否缺少箱号或封号；
- 是否缺少收发货人信息；
- 是否缺少船名或航次；
- 是否缺少港口信息；
- 是否缺少件数、重量或体积；
- 是否缺少特定客户或船公司要求的资料。

检查完成后，自动生成缺失资料清单，供业务人员补充或向客户索取。

### 5.5 业务单证自动生成

系统根据企业现有模板，自动生成或辅助填写相应业务单证，包括但不限于：

- 装箱单；
- 货物清单；
- 提单补料；
- 订舱申请；
- 舱单基础资料；
- 装船明细；
- 箱号、封号清单；
- 件杂货理货明细；
- 客户确认单；
- 内部业务流转单；
- ERP导入数据；
- 企业其他自定义单证。

具体支持的单证类型及模板数量，以双方确认的《功能交付清单》为准。

### 5.6 跨单证一致性校验

智能体对同一票业务中的多份文件进行交叉检查，重点识别：

- 船名、航次不一致；
- 提单号、订舱号不一致；
- 起运港、目的港不一致；
- 件数、重量、体积不一致；
- 箱号或封号重复、缺失；
- 箱型、箱量与明细不匹配；
- 收发货人信息不一致；
- 品名、货描及包装方式不一致；
- 合计数据与明细数据不一致；
- 必填字段缺失；
- 日期及时间节点冲突；
- 数据格式不符合企业规则；
- 客户资料与ERP数据不一致。

检查完成后，系统生成异常清单，显示异常字段、对应文件、原始数据及建议处理方式。

### 5.7 件杂货业务支持

针对客户目前重点开展的件杂货业务，建立专门的业务规则和处理流程，包括：

- 件数及包装方式识别；
- 重量、体积及货物明细汇总；
- 唛头及货物描述处理；
- 货物批次及装船明细管理；
- 件杂货理货资料生成；
- 不同港口和船公司的资料要求；
- 特殊货物及异常数据提示；
- 件杂货业务单证之间的一致性校验。

### 5.8 “集装箱走散货船”业务支持

针对“集装箱走散货船”业务模式，建立专项业务规则，包括：

- 集装箱作为货物单元时的数据管理；
- 箱型、箱量、箱号及封号管理；
- 箱内货物与集装箱之间的对应关系；
- 箱货关系及装箱明细；
- 集装箱合计与货物明细校验；
- 件数、重量及体积统计规则；
- 装船、理货及交接资料生成；
- 不同船公司、港口及航线的特殊要求；
- 特殊业务异常审核项目。

这部分将根据客户真实业务样本配置，不采用脱离实际业务的通用模板。

### 5.9 ERP系统协同

根据客户现有ERP系统的开放条件，选择合适的技术方式完成协同。

对接优先级如下：

1. ERP开放API接口时，优先通过API读取和写入业务数据；
2. ERP支持Excel导入时，按照ERP模板生成标准导入文件；
3. ERP支持数据库或中间表时，在获得客户及软件服务商授权后进行数据交换；
4. ERP不具备接口和导入能力时，通过桌面自动化辅助录入。

系统可实现的ERP协同能力包括：

- 从ERP读取客户及历史业务资料；
- 将智能体识别结果写入ERP；
- 生成ERP标准导入文件；
- 检查ERP数据与业务单证是否一致；
- 回写单证状态及业务进度；
- 记录数据写入及修改日志。

桌面自动化可能受到页面变化、网络状态、验证码和弹窗影响，因此需要设置人工确认、失败重试和异常记录机制。

### 5.10 船期与业务进度查询

在相关船公司、港口或第三方平台具备合法查询入口或开放接口的情况下，系统可扩展：

- 船期查询；
- 船舶动态查询；
- 截单、截港节点查询；
- 装船及到港状态跟踪；
- 业务进度自动更新；
- 延误及异常提醒；
- 查询结果自动回填业务档案；
- 定时生成待办事项。

外部平台能否实现完全自动查询，需要根据登录方式、验证码、接口权限和平台规则进行评估。

### 5.11 报价辅助与费用测算

在客户提供明确费用规则、历史报价和审批制度的基础上，建设报价辅助Skill，包括：

- 根据航线、港口和业务类型匹配费用；
- 根据件数、重量、体积及箱量进行费用计算；
- 匹配客户等级及历史报价；
- 识别基础费用和附加费用；
- 输出费用构成及报价明细；
- 对缺少的报价条件进行提醒；
- 对低于成本或超出权限的报价进行预警；
- 生成标准报价单；
- 保留报价修改和审批记录。

涉及对外报价时，由智能体完成测算和报价单初稿，业务人员进行最终确认。

### 5.12 业务提醒与异常预警

系统根据业务节点和企业规则提供：

- 截单时间提醒；
- 截港时间提醒；
- 装船时间提醒；
- 预计到港提醒；
- 资料未齐提醒；
- 单证未确认提醒；
- 异常数据未处理提醒；
- ERP未录入提醒；
- 客户待回复事项提醒；
- 超时业务提醒。

### 5.13 业务查询与智能问答

业务人员可以直接向智能体提问，例如：

- 这票业务还缺哪些资料？
- 哪些单证中的重量不一致？
- 这个客户历史上使用过哪些收货人？
- 今天有哪些业务即将截单？
- 这批货物一共有多少件、多少重量？
- 哪些箱号还没有封号？
- 某票业务目前处理到哪个环节？
- 某类业务应该准备哪些单证？
- 当前有哪些未处理异常？

智能体基于企业授权数据回答问题，并提供相应的数据来源和业务记录。

---

## 六、企业知识库建设

智能体能否准确工作，核心取决于企业知识库和业务规则的完整程度。

### 6.1 企业基础资料库

包括：

- 企业标准名称及开票信息；
- 部门、人员和岗位信息；
- 常用联系人；
- 常用港口、航线和船公司；
- 企业标准术语；
- 企业业务字段字典。

### 6.2 客户档案库

包括：

- 客户基础资料；
- 客户常用联系人；
- 常用发货人、收货人及通知人；
- 常用港口和航线；
- 单证格式偏好；
- 特殊操作要求；
- 历史业务；
- 常见异常及处理方式。

### 6.3 单证模板库

包括：

- 企业现有Excel、Word及PDF模板；
- 不同业务类型的单证模板；
- 不同客户、港口和船公司的模板；
- 字段映射关系；
- 必填字段规则；
- 模板版本及启用时间；
- 作废模板及历史版本。

### 6.4 业务规则库

包括：

- 件杂货操作规则；
- 集装箱走散货船操作规则；
- 数据计算和汇总规则；
- 单证审核规则；
- ERP字段对应关系；
- 异常处理流程；
- 报价及审批规则；
- 业务节点和提醒规则。

### 6.5 历史案例库

选取已经正确完成的历史业务作为样本，形成：

- 正确单证样本；
- 常见错误案例；
- 异常处理方案；
- 特殊客户案例；
- 特殊船舶及港口案例；
- 不同业务类型的标准案例。

知识库归客户所有，并由授权人员持续维护和更新。

---

## 七、基于匠厂智能体平台的实现方式

本项目基于我方“匠厂智能体平台”实施，采用模块化、可扩展的Skill架构。

平台可提供：

- 企业智能体统一工作入口；
- 多业务Skill组合及调度；
- 企业私有知识库挂载；
- 文件、表格及业务数据管理；
- 同步和异步任务执行；
- 长任务后台运行；
- 任务进度及执行结果查看；
- 定时任务及业务提醒；
- 任务日志及操作记录；
- 不同用户的数据及权限隔离；
- ERP、API及桌面自动化扩展能力；
- 后续Skill持续增加和升级能力。

项目完成后，客户获得的不是只能处理固定问题的封闭程序，而是一套能够随着企业业务变化持续增加能力的智能体平台。

---

## 八、人机协同与权限控制

港口物流单证及业务数据涉及实际经营活动，系统采用分级人机协同机制。

### 8.1 AI提供处理建议

适用于：

- 复杂异常判断；
- 特殊业务处理；
- 报价建议；
- 外部申报内容；
- 规则尚未稳定的业务。

### 8.2 AI执行，人工确认

适用于：

- 字段提取；
- 业务建档；
- 单证生成；
- 单证修改；
- 跨单证校验；
- ERP数据导入；
- 对外发送或提交。

### 8.3 低风险任务自动执行

适用于：

- 文件分类；
- 资料归档；
- 文件命名；
- 数据格式转换；
- 定时提醒；
- 日志生成；
- 已确认规则下的内部报表。

### 8.4 用户及数据权限

系统可按照岗位和职责设置权限，例如：

- 普通业务人员；
- 单证人员；
- 操作主管；
- 财务人员；
- 管理人员；
- 系统管理员。

不同用户仅能查看和处理其权限范围内的数据。关键操作保留数据来源、修改内容、操作人员、操作时间和执行结果，便于审计追溯。

---

## 九、项目实施计划

本项目采用“整体规划、一次签约、分阶段实施、统一交付”的方式。

各阶段共同构成一套完整的港口物流业务智能体，不作为多个独立方案让客户选择。

### 第一阶段：业务调研与需求确认

预计周期：1—2周。

主要工作：

- 梳理现有业务流程；
- 确定需要智能体解决的问题；
- 收集单证模板和历史样本；
- 确定业务类型和功能范围；
- 梳理关键字段及审核规则；
- 调研ERP及外部平台；
- 明确用户角色和权限；
- 确定测试样本及验收标准；
- 形成《项目需求规格说明书》和《功能交付清单》。

### 第二阶段：总体架构与知识库建设

预计周期：2—3周。

主要工作：

- 完成系统总体架构设计；
- 建立企业基础知识库；
- 建立客户档案库；
- 建立业务字段字典；
- 整理单证模板；
- 配置字段映射；
- 建立校验规则；
- 建立异常处理规则；
- 建立件杂货及特殊业务规则。

### 第三阶段：核心业务Skill开发

预计周期：4—7周。

主要工作：

- 资料分类Skill；
- 字段提取Skill；
- 业务建档Skill；
- 资料完整性检查Skill；
- 单证生成Skill；
- 跨单证一致性校验Skill；
- 件杂货业务处理Skill；
- 集装箱走散货船业务Skill；
- 异常提示及人工确认流程；
- 操作日志及任务记录。

### 第四阶段：ERP及外部系统协同

预计周期：2—5周。

主要工作：

- ERP字段映射；
- ERP导入文件生成；
- ERP接口或辅助录入开发；
- 船期及船舶动态查询；
- 业务节点跟踪；
- 定时提醒；
- 邮件或其他业务渠道协同；
- 外部系统异常处理机制。

该阶段周期受ERP及第三方平台开放条件影响。

### 第五阶段：报价与管理功能建设

预计周期：2—3周。

主要工作：

- 报价规则整理；
- 费用测算Skill；
- 报价单生成；
- 价格异常预警；
- 审核及确认流程；
- 管理查询和业务统计；
- 用户及权限完善。

### 第六阶段：真实业务试运行与优化

预计周期：2—4周。

主要工作：

- 使用真实业务进行试运行；
- 记录识别错误及规则遗漏；
- 调整字段映射和业务规则；
- 优化异常处理流程；
- 完善知识库和模板；
- 提高高频场景处理准确率；
- 完成业务人员反馈整改。

### 第七阶段：上线、培训与统一验收

预计周期：1—2周。

主要工作：

- 部署正式版本；
- 配置用户及权限；
- 完成历史数据初始化；
- 培训业务人员；
- 培训系统管理员；
- 提供操作说明；
- 完成项目整体测试；
- 根据约定标准统一验收。

项目整体建设周期初步预计为 **3—5个月**。实际周期取决于业务范围、模板数量、资料完整度、ERP开放条件及第三方平台配合情况。

---

## 十、预期项目效果

在客户提供足够业务样本、模板和规则的前提下，项目预期实现：

- 常规资料自动分类准确率达到90%左右；
- 标准字段提取准确率达到85%—95%；
- 标准单证初稿自动生成率达到80%以上；
- 常规跨单证差异自动识别率达到80%以上；
- 重复录入工作量减少50%—80%；
- 常规单证制作时间缩短40%—70%；
- 业务资料缺失和字段冲突能够提前发现；
- 业务人员能够快速查询业务进度和异常情况；
- 新员工对常规业务的学习周期明显缩短；
- 客户要求、业务规则及历史经验形成企业数字资产；
- 为后续增加财务、客服、结算及管理分析智能体建立基础。

以上为项目目标值，不作为脱离实际资料质量和业务条件的绝对承诺。最终验收指标由双方在完成业务调研和真实样本测试后共同确认。

---

## 十一、项目验收标准

本项目按照双方确认的完整功能清单进行统一验收。

每个实施阶段可以进行阶段测试和成果确认，但阶段确认不代表整个项目已经完成。所有约定功能完成并通过真实业务试运行后，再进行项目整体验收。

验收内容包括：

- 约定的业务流程是否能够完整运行；
- 约定的文件类型是否能够识别和分类；
- 约定的核心字段是否能够提取；
- 约定的单证是否能够生成；
- 关键字段及跨单证差异是否能够检查；
- 缺失资料和异常数据是否能够提示；
- 件杂货及特殊业务规则是否正确执行；
- ERP协同功能是否达到约定要求；
- 外部查询及提醒功能是否正常运行；
- 企业知识库是否完成建设；
- 人工审核和异常处理机制是否有效；
- 用户权限及数据隔离是否符合要求；
- 任务日志及操作记录是否完整；
- 业务人员是否能够独立使用系统；
- 项目文档、培训和部署是否完成。

建议双方共同确定：

- 验收业务样本数量；
- 验收文件和单证类型；
- 核心字段范围；
- 允许误差；
- 外部系统测试条件；
- 验收通过标准。

---

## 十二、项目交付内容

项目预计交付：

1. 港口物流业务智能体一套；
2. 企业级智能体运行环境；
3. 资料分类与识别Skill；
4. 关键字段提取Skill；
5. 统一业务建档Skill；
6. 资料完整性检查Skill；
7. 业务单证生成Skill；
8. 跨单证一致性校验Skill；
9. 件杂货业务处理Skill；
10. 集装箱走散货船业务Skill；
11. ERP协同Skill；
12. 船期及业务进度查询Skill；
13. 业务提醒及异常预警Skill；
14. 报价辅助及费用测算Skill；
15. 企业基础知识库；
16. 客户档案库；
17. 单证模板库；
18. 业务规则及校验规则库；
19. 历史正确案例库；
20. ERP字段映射及导入模板；
21. 用户账号及权限配置；
22. 任务日志及操作记录功能；
23. 系统部署及环境配置；
24. 业务人员培训；
25. 系统管理员培训；
26. 操作使用说明；
27. 真实业务试运行及优化；
28. 项目验收报告；
29. 后续能力扩展建议。

最终交付内容以双方确认的《功能交付清单》为准。

---

## 十三、项目合作方式与费用说明

### 13.1 合作方式

本项目采用：

> **整体规划、一次签约、分阶段实施、统一交付、整体验收。**

我方将根据客户确认的完整业务需求，基于匠厂智能体平台，统一完成港口物流业务智能体、企业知识库、业务Skill、单证处理、ERP协同、外部系统协同、报价辅助及相关自动化能力建设。

项目按照技术和业务依赖关系分阶段开发、测试和上线，但所有阶段共同组成一个完整项目，不需要客户在多个建设方案中进行选择。

### 13.2 需求确认

在正式开发前，我方将与客户共同完成业务调研，并形成以下文件：

- 现有业务流程清单；
- 智能体建设需求清单；
- 业务场景清单；
- 单证及资料类型清单；
- 单证模板清单；
- 字段提取和校验规则；
- 件杂货及特殊业务规则；
- ERP系统对接方式；
- 外部平台及查询渠道清单；
- 企业知识库资料清单；
- 用户角色及权限清单；
- 测试样本及验收标准；
- 项目功能交付清单；
- 项目实施排期。

需求确认的目的不是缩减客户需求，而是将全部需求转化为明确、可开发、可测试和可验收的功能。

### 13.3 项目费用核定

本项目采用整体项目报价，不拆分为多个可选方案。

整体项目费用包含：

- 业务需求调研；
- 总体架构及业务流程设计；
- 港口物流业务智能体建设；
- 企业知识库建设；
- 业务Skill开发；
- 单证模板适配；
- 字段提取及校验规则配置；
- 件杂货和特殊业务规则开发；
- ERP系统协同开发；
- 外部平台协同开发；
- 报价辅助能力建设；
- 用户及权限配置；
- 测试环境和正式环境部署；
- 真实业务试运行；
- 系统使用和管理培训；
- 项目统一验收；
- 约定期限内的运行支持及优化。

在客户提供必要资料、系统信息和业务样本后，我方将根据双方确认的《项目需求规格说明书》和《功能交付清单》核定项目总价，并提交正式报价。

### 13.4 第三方费用说明

以下费用如果实际发生，应在正式合同或报价中单独列明：

- 大模型调用费用；
- OCR识别服务费用；
- 云服务器、存储及网络费用；
- 短信、邮件及消息渠道费用；
- ERP厂商收取的接口或技术配合费用；
- 船公司、港口及第三方平台接口费用；
- 商业数据查询费用；
- 客户要求新增的硬件或专用软件费用；
- 第三方系统升级或改造费用。

### 13.5 需求变更原则

双方确认《项目需求规格说明书》和《功能交付清单》后，清单内需求均属于本项目建设范围。

项目实施过程中：

- 原有需求的完善和合理优化，由我方在项目范围内完成；
- 因规则理解偏差产生的调整，由双方协商后纳入项目优化；
- 新增业务类型、新增第三方系统或新增大量模板，需要评估工作量；
- 对已经确认的业务流程进行重大改变，需要重新评估周期；
- 超出原功能清单的新增需求，由双方另行确认开发周期及费用。

---

## 十四、数据安全与项目边界

### 14.1 数据安全

项目将根据客户实际部署环境落实以下措施：

- 用户身份验证；
- 岗位及数据权限控制；
- 不同用户的数据隔离；
- 关键操作日志记录；
- 敏感信息访问限制；
- 数据备份及恢复机制；
- 模型及外部服务调用范围控制；
- 客户业务资料未经授权不对外共享。

如客户对数据安全要求较高，可进一步评估本地化或私有化部署。

### 14.2 项目边界

本方案的核心价值是提高资料处理、业务建档、单证制作、数据检查和系统协同效率，但以下情况需要特别说明：

- AI识别效果需要通过真实样本持续测试和优化；
- 模糊图片、手写资料及严重不规范文件可能需要人工确认；
- 报关、放货、付款、正式报价等高风险操作应保留人工审核；
- 外部平台能否自动操作取决于接口、账号、验证码及平台规则；
- ERP深度对接需要客户或ERP供应商提供接口文档和技术配合；
- 系统不绕过第三方平台安全机制；
- 系统不进行未经授权的数据抓取或自动操作；
- 第三方平台页面或接口发生变化后，相关Skill可能需要适配升级；
- 客户业务规则发生重大变化时，需要同步更新知识库和对应Skill；
- 因客户原始资料错误导致的结果，需要由业务人员最终审核确认。

---

## 十五、等待客户解答的问题

以下问题用于进一步明确技术实现方式、项目周期、最终报价和验收标准。

### 15.1 业务范围与工作量

1. 公司目前具体包含哪些港口物流业务？
2. 件杂货业务和集装箱走散货船业务分别占多大比例？
3. 每月大约处理多少票业务？
4. 每票业务平均涉及多少份资料和单证？
5. 业务量高峰期每天大约处理多少票？
6. 当前最耗费人工时间的三个工作环节是什么？
7. 当前最容易出现错误的三个工作环节是什么？
8. 希望智能体优先解决哪些具体问题？
9. 是否还有报关、结算、船代、理货或其他相关业务需要纳入系统？

### 15.2 资料与单证

1. 客户资料主要通过微信、邮件还是业务系统接收？
2. 常见资料格式有哪些？
3. 目前使用哪些业务单证？
4. 不同客户是否使用不同模板？
5. 同一种单证是否存在多个版本？
6. 是否可以提供空白模板？
7. 是否可以提供脱敏后的历史正确业务样本？
8. 哪些单证需要智能体自动生成？
9. 哪些单证只需要识别和检查？
10. 是否需要支持中英文双语单证？
11. 是否包含扫描件、照片或手写资料？

### 15.3 字段与审核规则

1. 每一种单证中的必填字段有哪些？
2. 船名、航次、港口、件数、重量、体积等数据分别以哪份资料为准？
3. 不同资料中的数据冲突时，目前如何处理？
4. 哪些字段必须进行跨单证校验？
5. 是否有现成的单证审核表或标准作业流程？
6. 箱号、封号、件数、重量、体积分别采用什么格式？
7. 是否存在客户、船公司或港口的特殊字段要求？
8. 哪些异常可以由AI给出处理建议？
9. 哪些异常必须由主管确认？

### 15.4 件杂货及特殊业务

1. 件杂货业务主要涉及哪些货物类型？
2. 常见包装方式有哪些？
3. 件数、重量和体积如何统计？
4. 是否涉及多批次、多货主或多收货人？
5. 集装箱走散货船业务的具体操作流程是什么？
6. 集装箱在该业务中如何计件和统计？
7. 箱内货物与集装箱之间如何建立对应关系？
8. 该业务需要制作哪些特殊单证？
9. 不同船公司、港口和航线分别有哪些特殊要求？
10. 当前有哪些高频异常或风险点？

### 15.5 ERP系统

1. 当前使用的ERP系统名称是什么？
2. ERP具体版本是什么？
3. ERP由哪家公司开发和维护？
4. ERP是否支持API接口？
5. ERP是否支持Excel导入和导出？
6. 是否可以提供ERP接口文档？
7. 是否可以提供ERP导入模板？
8. 智能体需要读取ERP中的哪些数据？
9. 智能体需要向ERP写入哪些数据？
10. ERP录入前是否需要人工确认？
11. ERP是否部署在企业内网？
12. ERP厂商是否可以配合接口开发？

### 15.6 船公司、港口及外部平台

1. 目前主要合作的船公司有哪些？
2. 主要涉及哪些港口和航线？
3. 日常需要登录哪些船公司或港口平台？
4. 需要查询哪些信息？
5. 是否存在统一船期查询平台？
6. 外部平台是否需要账号登录？
7. 是否涉及短信验证、扫码或验证码？
8. 是否拥有相关平台的API或数据接口权限？
9. 哪些操作希望由智能体自动完成？
10. 哪些操作必须由业务人员最终确认？

### 15.7 报价与费用规则

1. 当前报价由哪个岗位负责？
2. 报价主要包含哪些费用项目？
3. 费用按照件数、重量、体积、箱量还是其他方式计算？
4. 不同客户是否执行不同价格？
5. 是否存在客户等级和折扣规则？
6. 是否存在最低报价或最低利润要求？
7. 是否有历史报价数据可以提供？
8. 报价是否需要主管审批？
9. 是否需要生成标准报价单？
10. 是否需要记录报价历史和修改过程？

### 15.8 用户、权限与部署

1. 预计有多少名员工使用系统？
2. 涉及哪些部门和岗位？
3. 不同岗位分别可以查看哪些数据？
4. 哪些操作需要主管审批？
5. 是否要求保留完整操作日志？
6. 是否需要本地或私有化部署？
7. 是否允许使用云端模型服务？
8. 是否存在客户数据保密或合规要求？
9. 是否需要接入企业微信、邮箱或其他工作渠道？
10. 是否需要在公司外部网络使用系统？

### 15.9 验收与上线

1. 客户最关注哪些项目效果？
2. 希望将哪些指标作为验收依据？
3. 可以提供多少票真实业务用于测试？
4. 哪些业务人员可以参与项目测试？
5. 谁负责确认业务规则和单证模板？
6. 谁负责最终验收？
7. 是否需要历史业务数据导入？
8. 希望项目在什么时间正式上线？
9. 是否存在必须配合的业务旺季或关键时间节点？

---

## 十六、项目推进建议

建议客户指定以下项目成员：

- 一名项目负责人；
- 一名熟悉整体业务流程的业务主管；
- 一至两名单证或操作人员；
- 一名ERP或信息系统联系人；
- 一名负责项目验收的管理人员。

项目启动后，双方首先完成业务调研、样本收集和功能确认，然后按照以下完整业务闭环推进建设：

> 客户资料进入 → AI识别和分类 → 自动建立业务档案 → 检查资料完整性 → 自动生成业务单证 → 跨单证一致性校验 → 业务人员确认 → ERP及外部系统协同 → 船期和节点跟踪 → 业务资料归档。

通过整体规划和分阶段实施，可以在控制开发风险的同时，逐步将客户现有业务流程、单证经验和操作规则沉淀到智能体系统中。

项目完成后，客户将获得一套适合自身业务、可以持续扩展、能够长期沉淀企业知识和提高业务处理效率的港口物流业务智能体系统。