🔌 业务系统集成指南

🚀 快速开始

业务系统通过 HTTP POST 调用 AI 插件,3 步即可接入

1

获取 API 地址和凭证

API 基地址:http://47.108.236.199:8000,在 模型配置 页面配置 API Key

2

同步用户权限

调用 POST /api/v1/{tenant_id}/sync/permission 同步业务系统的用户角色权限

3

发送消息获取 AI 回复

调用核心接口 POST /api/v1/{tenant_id}/chat/send

📡 核心接口:统一对话

所有 AI 功能通过这一个接口调用,AI 自动识别意图并调度对应智能体

请求

curl -X POST http://47.108.236.199:8000/api/v1/dbdc_rental_001/chat/send \
  -H "Content-Type: application/json" \
  -H "X-Tenant-Id: dbdc_rental_001" \
  -d '{
    "user_id": "operator_zhang",
    "role": "operator",
    "message": {
      "type": "text",
      "content": "帮我查一下今天城东区域待处理的订单"
    }
  }'

响应

{
  "session_id": "abc123...",
  "reply": {
    "type": "text",
    "content": "📋 为您查询到以下待处理订单:\n1. #ORD001 ..."
  },
  "intent": {
    "category": "order_query",
    "confidence": 0.95,
    "entities": {"date": "今天", "location": "城东"}
  },
  "risk_flags": [],
  "confirmation_required": false
}

📋 业务场景调用示例

📋

查订单

业务系统用户输入"今天待处理订单" -> AI 插件返回订单列表

{"message":{"type":"text","content":"帮我查一下今天待处理的订单"}}
🚗

智能调度

业务系统派单 -> AI 推荐最优司机+车辆组合

{"message":{"type":"text","content":"城东需要一台商务车,明天10点接客户去机场"}}
📸

AI 验车

业务系统上传车辆照片 -> AI 识别损伤

{"message":{"type":"image","content":"验车","attachments":[{"url":"https://oss.example.com/photo.jpg"}]}}
📊

数据查询

自然语言查询 -> AI 返回分析结果

{"message":{"type":"text","content":"本月营收情况怎么样,和上个月对比"}}
📄

生成合同

业务系统请求 -> AI 生成合同文档

{"message":{"type":"text","content":"生成一份埃尔法商务车的租车合同,租期30天"}}

🏗 集成架构

┌─────────────────────────┐
│   租车业务系统(前端)    │
│   用户输入/操作界面       │
└──────────┬──────────────┘
           │ HTTP POST /chat/send
           ▼
┌─────────────────────────┐
│   DBDC AI 插件 (8000)    │
│                          │
│  → 意图识别              │
│  → Agent 编排调度         │
│  → MiniMax/通义千问      │
│  → 返回AI回复            │
└──────────┬──────────────┘
           │ JSON Response
           ▼
┌─────────────────────────┐
│   租车业务系统(前端)    │
│   展示 AI 回复给用户      │
│   展示确认按钮(如需审批)  │
└─────────────────────────┘
⚠ 安全机制:涉及生产数据修改的操作(调度/合同/结算),AI 返回 confirmation_required: true,业务系统必须展示确认按钮,用户确认后才调用 POST /confirm/{id} 执行。

📖 全部 API 端点

端点方法说明
/api/v1/{tenant}/chat/sendPOST⭐ 统一对话入口(主要接口)
/api/v1/{tenant}/chat/session/newPOST创建新会话
/api/v1/{tenant}/vehicle/inspectPOSTAI验车
/api/v1/{tenant}/order/dispatchPOST智能调度
/api/v1/{tenant}/document/ocrPOST票据OCR
/api/v1/{tenant}/feedbackPOST用户反馈
/api/v1/{tenant}/confirm/{id}POST确认AI建议的操作
/api/v1/{tenant}/sync/dataPOST数据同步
/api/v1/{tenant}/sync/permissionPOST权限同步

🧠 模型分配说明

基于阿里云百炼 Token Plan 团队版(Credits 统一计量),同一 API Key 调用多模型

功能模型说明
文字对话(主力)MiniMax M2.7意图识别、建议生成、通用对话
文字对话(fallback)qwen3.6-plus推理+视觉理解+文本生成
图片识别/OCR/视觉理解qwen3.6-plus(视觉模式)车损检测、票据识别、证件识别
图片生成qwen-image-2.0图表、海报、示意图生成
语音识别 STT阿里云 NLS实时语音转文字
语音合成 TTS阿里云 NLS文字转语音播报
PDF/Excel 生成本地引擎不消耗模型额度
💡 计费说明:所有模型调用通过阿里云百炼 Token Plan 团队版统一以 Credits 计量。图片相关请求使用 qwen3.6-plus 视觉模式,文字对话优先走 MiniMax,fallback 走 qwen3.6-plus。