核心概念

架构概览

开发者应用 → Open API Gateway (/v1/) → 智航云 AI 中台核心引擎
                                        ├── 工具路由器 (toolRouter)
                                        ├── AI Agent (多模型)
                                        ├── 知识库 (RAG)
                                        ├── 知识图谱 (Ontology)
                                        ├── 工作流引擎 (Workflow)
                                        └── 自动化引擎 (L5)

应用 (App)

应用是最顶层的资源单位。每个应用代表一个集成的外部系统。

{
  "app": {
    "id": "my-erp",
    "name": "My ERP Connector",
    "nameZh": "我的ERP连接器",
    "domain": "operations",
    "subsystem": "ERP"
  },
  "serviceConfig": { ... },
  "dashboard": { ... },
  "toolPacks": [ ... ]
}

应用定义与平台内部的 custom-apps/*.json 格式完全一致。

工具 (Tool)

工具是 AI 可以调用的原子操作。每个工具有：

• 名称: 唯一标识符 (如 erp_get_inventory)
• 描述: AI 用来理解工具用途
• 输入参数: JSON Schema 定义
• 执行方式: HTTP 调用 / 桌面代理 / 自定义 Handler

{
  "name": "erp_get_inventory",
  "description": "查询 ERP 系统的库存数据",
  "input_schema": {
    "type": "object",
    "properties": {
      "warehouse_id": { "type": "string" }
    }
  },
  "execution": {
    "type": "http",
    "method": "GET",
    "url": "{erp_url}/api/inventory?warehouse={warehouse_id}"
  }
}

工具包 (Tool Pack)

工具包是一组相关工具的集合，包含：

• 多个工具定义
• 共享的 AI 知识提示 (knowledge)
• 所属应用

知识库 (Knowledge Base)

知识库用于存储私有数据，支持 RAG (检索增强生成)：

1. 上传文档: PDF、Word、TXT → 自动分块 + 向量化
2. 语义搜索: 用自然语言查询相关内容
3. AI 增强: AI 对话时自动引用知识库内容

知识图谱 (Knowledge Graph)

知识图谱用于存储实体间的关系网络：

• 节点: 业务实体 (设备、建筑、员工、技能...)
• 边: 实体间关系 (contains, reports_to, has_skill...)
• 遍历: 沿关系路径发现关联实体

工作流 (Workflow)

工作流是多步骤自动化任务，支持：

• 节点类型: AI 生成、HTTP 请求、工具调用、条件分支、审批...
• 触发方式: 手动、定时 (cron)、事件驱动
• DAG 执行: 基于有向无环图的并行/串行执行

AI 能力等级

级别	能力	说明
L1 查询	读取数据	AI 调用工具获取数据
L2 分析	多步推理	AI 串联多个工具分析
L3 建议	操作建议	AI 给出可操作建议 + 按钮
L4 审批执行	写操作	AI 执行操作但需用户确认
L5 自主执行	自动化	事件触发 → AI 评估 → 自动执行