546 lines
25 KiB
Markdown
546 lines
25 KiB
Markdown
# 广东升航物流 · 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 更新* |