# 广东升航物流 · AI 智能体平台架构文档

> 版本：v1.0.0　　项目代号：client-shenghang　　文档类型：总体设计

---

## 目录

1. [项目概述](#1-项目概述)
2. [整体架构图](#2-整体架构图)
3. [技术原理图](#3-技术原理图)
4. [业务域划分](#4-业务域划分)
5. [技能规划总图](#5-技能规划总图)
6. [各域详细技能说明](#6-各域详细技能说明)
7. [数据流转图](#7-数据流转图)
8. [RPA 集成说明](#8-rpa-集成说明)
9. [部署与运行说明](#9-部署与运行说明)

---

## 1. 项目概述

### 1.1 背景

广东升航物流有限公司日常运营涉及订单接收、运力调度、货物追踪、财务管理、人事管理等多个环节，大量工作依赖人工重复操作，效率低、易出错。

### 1.2 目标

通过 **AI 智能体 + RPA 自动化** 的组合方案，将 15 项日常业务流程转化为可自动运行的 Skill（技能），部署至智能体平台，实现：

- ✅ 减少人工重复劳动
- ✅ 降低操作失误率
- ✅ 提升客户响应速度
- ✅ 实现 7×24 小时无人值守运行

### 1.3 技术栈

| 层级 | 技术 |
|------|------|
| AI 大模型 | Claude / GPT（意图理解、内容生成、决策推理） |
| RPA 引擎 | 浏览器 / 桌面 / 手机三端自动化 |
| 智能体平台 | 匠厂（Skill 调度与编排） |
| 代码仓库 | Gitea（git.jc2009.com/client-shenghang） |
| 开发语言 | Python 3.x |
| 触达渠道 | 企业微信 / 短信 / 邮件 |

---

## 2. 整体架构图

```
┌─────────────────────────────────────────────────────────────────┐
│                        客户触点层                                 │
│          微信群消息        电话（人工）        邮件                │
└───────────────┬─────────────────────────┬───────────────────────┘
                │                         │
                ▼                         ▼
┌─────────────────────────────────────────────────────────────────┐
│                      智能体平台（调度层）                          │
│                                                                 │
│   意图识别  →  Skill 路由  →  任务编排  →  结果回传               │
│                                                                 │
└──────┬──────────┬──────────┬──────────┬──────────┬─────────────┘
       │          │          │          │          │
       ▼          ▼          ▼          ▼          ▼
  ┌─────────┐ ┌──────────┐ ┌────────┐ ┌────────┐ ┌────────────┐
  │订单中心  │ │运力调度   │ │货物追踪│ │财务中心│ │人事/市场   │
  │ 3 Skills│ │ 4 Skills │ │3 Skills│ │4 Skills│ │ 6 Skills   │
  └────┬────┘ └────┬─────┘ └───┬────┘ └───┬────┘ └─────┬──────┘
       │           │           │           │             │
       └───────────┴───────────┴───────────┴─────────────┘
                               │
                               ▼
┌─────────────────────────────────────────────────────────────────┐
│                         RPA 执行层                               │
│                                                                 │
│  货拉拉    运满满    顺丰    京东物流    税务系统    招聘平台       │
│  (手机端)  (手机端) (网页端) (网页端)   (桌面端)   (网页端)       │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘
                               │
                               ▼
┌─────────────────────────────────────────────────────────────────┐
│                         数据存储层                               │
│                                                                 │
│        订单库        运单库        财务库        员工库           │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘
```

---

## 3. 技术原理图

```
                     ┌──────────────────────┐
                     │    输入触发源          │
                     │  微信群 / 邮件 / 定时  │
                     └──────────┬───────────┘
                                │
                                ▼
                     ┌──────────────────────┐
                     │    AI 大模型          │
                     │  · 意图识别           │
                     │  · 信息提取           │
                     │  · 内容生成           │
                     │  · 异常判断           │
                     └──────────┬───────────┘
                                │
               ┌────────────────┼────────────────┐
               │                │                │
               ▼                ▼                ▼
    ┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐
    │   直接执行        │ │  RPA 执行     │ │   人工介入        │
    │ · 发送通知        │ │ · 操作第三方  │ │ · 异常审批        │
    │ · 写入数据库      │ │   平台界面    │ │ · 关键决策        │
    │ · 生成报表        │ │ · 浏览器/桌面 │ │ · 回执确认        │
    │ · 推送消息        │ │   /手机三端   │ └──────────────────┘
    └─────────────────┘ └──────────────┘
               │                │
               └────────┬───────┘
                        │
                        ▼
             ┌─────────────────────┐
             │      输出结果        │
             │ · 通知客户/司机      │
             │ · 更新系统状态       │
             │ · 生成报表文件       │
             │ · 推送异常工单       │
             └─────────────────────┘
```

---

## 4. 业务域划分

```
client-shenghang/
│
├── 📦 域一：订单中心          (3 Skills)
│   接收、录入、分配订单
│
├── 🚛 域二：运力调度中心      (4 Skills)
│   通知司机、对接货拉拉/运满满/顺丰/京东
│
├── 📍 域三：货物追踪中心      (3 Skills)
│   查询进度、推送状态、处理异常
│
├── 💰 域四：财务中心          (4 Skills)
│   报销审核、财务对账、开票、催款
│
├── 👥 域五：人事管理中心      (4 Skills)
│   招聘、绩效收集、绩效督促、优秀评比
│
└── 📈 域六：市场助手中心      (2 Skills)
    线索收集、客户档案
```

**合计：6 大业务域 / 20 个 Skill**

---

## 5. 技能规划总图

```
┌─────────────────────────────────────────────────────────────────────────┐
│                        20 个 Skill 全景图                                │
├──────────────────┬──────────────────────────────────────────────────────┤
│  域              │  Skill 列表                                           │
├──────────────────┼──────────────────────────────────────────────────────┤
│                  │  receive-order      ← 监听微信群/邮件，提取订单信息    │
│  📦 订单中心      │  record-order       ← 订单结构化录入内部系统           │
│                  │  assign-transport   ← 智能判断运力渠道分配             │
├──────────────────┼──────────────────────────────────────────────────────┤
│                  │  notify-driver      ← 向司机发送派车通知               │
│  🚛 运力调度      │  dispatch-huolala   ← RPA 操作货拉拉自动下单           │
│                  │  dispatch-yunmanman ← RPA 操作运满满自动下单           │
│                  │  dispatch-shunfeng  ← RPA 操作顺丰自动下单            │
│                  │  dispatch-jingdong  ← RPA 操作京东物流自动下单         │
├──────────────────┼──────────────────────────────────────────────────────┤
│                  │  track-shipment     ← 定时查询各平台运单状态           │
│  📍 货物追踪      │  push-progress      ← 主动推送货物状态给客户           │
│                  │  handle-exception   ← 识别异常，生成工单推送负责人      │
├──────────────────┼──────────────────────────────────────────────────────┤
│                  │  review-reimbursement ← 核对报销单据，生成审核意见     │
│  💰 财务中心      │  reconcile-finance  ← 收付款与订单数据自动对账         │
│                  │  issue-invoice      ← RPA 操作税务系统自动开票         │
│                  │  urge-payment       ← 监控账期，到期自动催款提醒        │
├──────────────────┼──────────────────────────────────────────────────────┤
│                  │  publish-recruitment  ← 发布招聘，筛简历，发通知       │
│  👥 人事管理      │  collect-performance  ← 抓取员工数据，生成绩效报表     │
│                  │  evaluate-performance ← 绩效排名，督促落后员工         │
│                  │  reward-employee      ← 生成优秀员工评比结果并公告     │
├──────────────────┼──────────────────────────────────────────────────────┤
│  📈 市场助手      │  collect-leads      ← 抓取潜在客户信息，归档线索库     │
│                  │  build-customer-profile ← 汇总客户订单/偏好/账期画像  │
└──────────────────┴──────────────────────────────────────────────────────┘
```

---

## 6. 各域详细技能说明

### 6.1 📦 订单中心

#### `receive-order` · 接收订单

| 项目 | 内容 |
|------|------|
| **触发方式** | 企业微信群新消息 / 邮件到达 |
| **输入** | 微信消息文本 / 邮件正文 |
| **处理逻辑** | AI 提取：客户名、货物信息、起止地址、要求时间、联系人 |
| **输出** | 结构化订单 JSON，传递给 `record-order` |
| **异常处理** | 信息不完整时，自动回复客户补充缺失字段 |

#### `record-order` · 录入订单

| 项目 | 内容 |
|------|------|
| **触发方式** | 由 `receive-order` 传入结构化数据后触发 |
| **输入** | 结构化订单 JSON |
| **处理逻辑** | 写入内部订单管理系统，生成订单编号 |
| **输出** | 订单编号，传递给 `assign-transport` |
| **异常处理** | 写入失败时告警，推送人工处理 |

#### `assign-transport` · 分配运力

| 项目 | 内容 |
|------|------|
| **触发方式** | 由 `record-order` 传入订单编号后触发 |
| **输入** | 订单详情（重量、线路、时效要求） |
| **处理逻辑** | 按规则判断：同城→货拉拉/自有司机；省内→运满满；全国→顺丰/京东 |
| **输出** | 分配结果，触发对应 dispatch-xxx Skill |

---

### 6.2 🚛 运力调度中心

#### `notify-driver` · 通知司机

| 项目 | 内容 |
|------|------|
| **触发方式** | `assign-transport` 判定走自有司机时触发 |
| **输入** | 司机信息、订单详情 |
| **处理逻辑** | 发送派车通知（企业微信/短信），等待司机回执确认 |
| **输出** | 司机确认状态；超时未回复自动切换备用方案 |

#### `dispatch-huolala` · 货拉拉派单

| 项目 | 内容 |
|------|------|
| **触发方式** | `assign-transport` 判定走货拉拉时触发 |
| **输入** | 取货/送货地址、货物类型、时间要求 |
| **处理逻辑** | **RPA 手机端**自动打开货拉拉App，填写信息，确认下单 |
| **输出** | 货拉拉订单号，写入系统 |

#### `dispatch-yunmanman` · 运满满派单

| 项目 | 内容 |
|------|------|
| **触发方式** | `assign-transport` 判定走运满满时触发 |
| **输入** | 起止城市、货物重量/体积、时效 |
| **处理逻辑** | **RPA 手机/网页端**自动操作运满满，发布货源，匹配司机 |
| **输出** | 运满满订单号，写入系统 |

#### `dispatch-shunfeng` · 顺丰下单

| 项目 | 内容 |
|------|------|
| **触发方式** | `assign-transport` 判定走顺丰时触发 |
| **输入** | 寄件/收件信息、货物参数、服务类型 |
| **处理逻辑** | **RPA 浏览器端**登录顺丰官网，填写寄件信息，完成下单 |
| **输出** | 顺丰运单号，写入系统 |

#### `dispatch-jingdong` · 京东物流下单

| 项目 | 内容 |
|------|------|
| **触发方式** | `assign-transport` 判定走京东物流时触发 |
| **输入** | 寄件/收件信息、货物参数 |
| **处理逻辑** | **RPA 浏览器端**登录京东物流平台，完成下单 |
| **输出** | 京东运单号，写入系统 |

---

### 6.3 📍 货物追踪中心

#### `track-shipment` · 追踪货物

| 项目 | 内容 |
|------|------|
| **触发方式** | 定时触发（每 30 分钟） |
| **输入** | 系统内所有进行中的运单号 |
| **处理逻辑** | RPA 登录各平台查询最新状态，汇总写入系统 |
| **输出** | 更新后的运单状态，触发 `push-progress` 或 `handle-exception` |

#### `push-progress` · 推送进度

| 项目 | 内容 |
|------|------|
| **触发方式** | `track-shipment` 检测到状态变更时触发 |
| **输入** | 最新货物状态、客户联系方式 |
| **处理逻辑** | AI 生成友好通知文案，通过企业微信/短信发送给客户 |
| **输出** | 消息发送成功/失败记录 |

#### `handle-exception` · 处理异常

| 项目 | 内容 |
|------|------|
| **触发方式** | `track-shipment` 检测到异常状态时触发（超时/拒收/丢货等） |
| **输入** | 异常类型、订单信息 |
| **处理逻辑** | AI 判断异常类型，生成异常工单，推送对应负责人处理 |
| **输出** | 异常工单，人工确认处理结果 |

---

### 6.4 💰 财务中心

#### `review-reimbursement` · 审核报销

| 项目 | 内容 |
|------|------|
| **触发方式** | 员工提交报销申请时触发 |
| **输入** | 报销单据（金额、类别、票据图片） |
| **处理逻辑** | AI 核对金额、类别合规性，OCR 识别票据，生成审核意见 |
| **输出** | 审核意见推送给负责人，待人工批复 |

#### `reconcile-finance` · 财务对账

| 项目 | 内容 |
|------|------|
| **触发方式** | 定时触发（每日/每月） |
| **输入** | 收付款流水、订单数据 |
| **处理逻辑** | 自动匹配收付款与订单，标记未匹配差异项 |
| **输出** | 对账报表，差异项推送财务人员 |

#### `issue-invoice` · 开具发票

| 项目 | 内容 |
|------|------|
| **触发方式** | 客户申请开票时触发 |
| **输入** | 客户税务信息、开票金额、订单号 |
| **处理逻辑** | **RPA 桌面端**操作税务系统，自动填写并开具发票 |
| **输出** | 发票文件，自动发送给客户邮箱 |

#### `urge-payment` · 催款提醒

| 项目 | 内容 |
|------|------|
| **触发方式** | 定时触发（每日检查账期） |
| **输入** | 客户账期信息、未付款订单 |
| **处理逻辑** | 到期前 7 天、3 天、当天分别发送不同等级提醒 |
| **输出** | 提醒消息发送给客户（微信/短信/邮件） |

---

### 6.5 👥 人事管理中心

#### `publish-recruitment` · 发布招聘

| 项目 | 内容 |
|------|------|
| **触发方式** | 人事提交招聘需求时触发 |
| **输入** | 职位信息、要求、薪资范围 |
| **处理逻辑** | AI 生成 JD 文案，RPA 发布至各招聘平台，自动筛选符合简历，发送面试通知 |
| **输出** | 候选人名单推送给人事负责人 |

#### `collect-performance` · 收集绩效

| 项目 | 内容 |
|------|------|
| **触发方式** | 定时触发（每日/每周） |
| **输入** | 各系统员工操作数据 |
| **处理逻辑** | 自动抓取：订单处理量、响应时长、异常率等指标，汇总生成报表 |
| **输出** | 绩效数据报表，存入员工档案 |

#### `evaluate-performance` · 绩效督促

| 项目 | 内容 |
|------|------|
| **触发方式** | `collect-performance` 完成后触发 |
| **输入** | 绩效数据报表 |
| **处理逻辑** | AI 识别指标落后员工，生成排名，对落后员工发送督促提醒 |
| **输出** | 绩效排名报表，督促通知 |

#### `reward-employee` · 优秀评比

| 项目 | 内容 |
|------|------|
| **触发方式** | 定时触发（每月） |
| **输入** | 月度绩效汇总数据 |
| **处理逻辑** | AI 根据多维度指标综合评分，生成优秀员工排名与评语 |
| **输出** | 优秀员工公告，推送全员企业微信 |

---

### 6.6 📈 市场助手中心

#### `collect-leads` · 收集线索

| 项目 | 内容 |
|------|------|
| **触发方式** | 定时触发 / 手动触发 |
| **输入** | 目标渠道（行业网站/平台/地图） |
| **处理逻辑** | RPA 抓取潜在客户信息，AI 去重、分类、评分 |
| **输出** | 线索列表推送给业务员 |

#### `build-customer-profile` · 客户画像

| 项目 | 内容 |
|------|------|
| **触发方式** | 定时触发（每月更新） |
| **输入** | 客户历史订单、付款记录、沟通记录 |
| **处理逻辑** | AI 汇总分析，生成客户偏好、货量趋势、信用等级等画像 |
| **输出** | 客户画像报告，存入客户档案 |

---

## 7. 数据流转图

```
客户下单
   │
   ▼
receive-order ──→ record-order ──→ assign-transport
                                         │
                   ┌─────────────────────┼──────────────────────┐
                   │                     │                      │
                   ▼                     ▼                      ▼
            notify-driver        dispatch-huolala/       dispatch-shunfeng/
            （自有司机）          dispatch-yunmanman       dispatch-jingdong
                   │                     │                      │
                   └─────────────────────┼──────────────────────┘
                                         │
                                         ▼
                                  track-shipment（定时轮询）
                                         │
                          ┌──────────────┴──────────────┐
                          │                             │
                          ▼                             ▼
                   push-progress                handle-exception
                  （正常推进）                    （异常处理）
                          │
                          ▼
                   urge-payment（到期催款）
                          │
                          ▼
                   issue-invoice（开票）
                          │
                          ▼
                   reconcile-finance（对账）
```

---

## 8. RPA 集成说明

### 8.1 三端覆盖

| 端 | 覆盖场景 |
|----|---------|
| 🌐 浏览器端 | 顺丰官网、京东物流、税务系统、招聘平台 |
| 🖥️ 桌面端 | 税务开票软件、内部 ERP 系统 |
| 📱 手机端 | 货拉拉 App、运满满 App |

### 8.2 无需 API，RPA 直接操作

```
无 API 接口的第三方平台
         │
         ▼
   RPA 模拟人工操作
   · 识别界面元素
   · 填写表单字段
   · 点击确认按钮
   · 截图记录结果
         │
         ▼
   返回操作结果给智能体
```

### 8.3 异常容错机制

- 界面变更导致元素识别失败 → 推送人工介入
- 平台登录失效 → 自动重新登录，失败则告警
- 操作超时 → 重试 3 次，仍失败则生成异常工单

---

## 9. 部署与运行说明

### 9.1 仓库结构

```
client-shenghang/
├── commons/                    # 公共模块
│   └── references/
│       ├── ADAPTER.md          # 平台适配说明
│       ├── CLI.md              # 命令行使用
│       ├── CONFIG.md           # 配置说明
│       ├── RPA.md              # RPA 操作规范
│       ├── SCHEMA.md           # 数据结构定义
│       └── RUNTIME.md          # 运行环境要求
├── receive-order/
├── record-order/
├── assign-transport/
├── notify-driver/
├── dispatch-huolala/
├── dispatch-yunmanman/
├── dispatch-shunfeng/
├── dispatch-jingdong/
├── track-shipment/
├── push-progress/
├── handle-exception/
├── review-reimbursement/
├── reconcile-finance/
├── issue-invoice/
├── urge-payment/
├── publish-recruitment/
├── collect-performance/
├── evaluate-performance/
├── reward-employee/
├── collect-leads/
└── build-customer-profile/
```

### 9.2 上线计划

| 阶段 | 时间 | 内容 | 目标 |
|------|------|------|------|
| **第一期** | Week 1-3 | 订单中心 + 运力调度 + 催款提醒 | 核心业务自动化，直接减少人工 |
| **第二期** | Week 4-6 | 货物追踪 + 财务对账 + 开票 | 降低出错率，提升客户体验 |
| **第三期** | Week 7-9 | 人事管理 + 市场助手 | 管理效率全面提升 |

### 9.3 各角色关注点速查

| 角色 | 重点阅读章节 |
|------|------------|
| **客户/决策层** | 第 1、4、5 章（概述、业务域、技能总图） |
| **产品/需求** | 第 6 章（各域详细技能说明） |
| **技术开发** | 第 2、3、7、8、9 章（架构、原理、数据流、RPA、部署） |
| **测试** | 第 6 章（输入/输出/异常处理）+ 第 8.3 节（容错机制） |

---

*文档由 AI 辅助生成，如有调整请在 Gitea 仓库提交 MR 更新*