跳转至

货代智能 Agent 平台

本文档集介绍货代行业智能 Agent 平台的专用模块设计与实现。

概述

货代智能 Agent 平台基于 Chameleon 通用 Agent Runtime 构建，针对海运、空运、陆运、多式联运等场景提供专用能力：

  • 单证智能处理：HBL、MBL、AWB、发票、装箱单等自动识别与字段提取
  • 货物跟踪聚合：多源跟踪数据整合（船公司、港口、海关、GPS）
  • 客服协同：AI 主答、人工接管、协作建议
  • 业务记忆：跨会话历史沉淀与经验建议

文档目录

文档 说明
领域模型 货运单、单证、跟踪事件、贸易参与方等数据模型
单证处理 OCR、分类、字段提取、验证的完整流程
货物跟踪 多源跟踪数据聚合与状态机
MCP 工具 船公司 API、海关接口、通知服务等工具定义
实现路线图 Phase 0/1/2 的具体任务与验收标准

与核心平台的关系

flowchart TB
    subgraph Core[Chameleon 核心平台]
        Agent[Agent Runtime]
        MCP[MCP 协议]
        RAG[RAG 检索]
        Memory[记忆系统]
    end

    subgraph Freight[货代专用扩展]
        DocProc[单证处理服务]
        Tracking[跟踪聚合服务]
        Validation[规则验证引擎]
        Notification[通知服务]
    end

    Agent -->|调用| DocProc
    Agent -->|调用| Tracking
    MCP -->|连接| CarrierAPI[船公司 API]
    Memory -->|存储| FreightMemory[货代业务记忆]

货代扩展层通过标准接口与核心平台集成：

  • 复用 ChameleonOrchestrator 的状态机与编排能力
  • 复用 MCP 协议的挂载、策略、审计机制
  • 复用 RAG 的向量检索与知识召回能力
  • 扩展货代专用的领域模型与服务

快速开始

1. 配置货代专用 MCP Server

# config.toml
[[mcp.servers]]
name = "maersk-tracking"
transport = "sse"
url = "https://api.maersk.com/v1/sse"
allowed_tools = ["track_shipment", "query_schedule"]

2. 创建货代 Agent

POST /agents
{
  "name": "货代客服助手",
  "system_prompt": "你是一个专业的货代客服助手...",
  "mcp_mounts": ["maersk-tracking"]
}

3. 上传单证处理

POST /knowledge-sources/{id}/upload
Content-Type: multipart/form-data
file: @hbl.pdf

相关文档