MBE API 指南

版本: 3.1.0 | 更新日期: 2026-02-09

概述

MBE API 提供 RESTful 接口，支持专家问答、知识库管理、用户认证等功能。

基础信息

基础 URL

统一知识图谱 API（生产环境）：

• 图谱状态: GET https://mbe.hi-maker.com/api/graph/status
• 图谱查询: POST https://mbe.hi-maker.com/api/graph/query
• 用户上下文: GET https://mbe.hi-maker.com/api/graph/user-context/{user_id}

认证

所有 API 请求需要在 Header 中包含认证信息:

Authorization: Bearer YOUR_API_KEY

响应格式

所有响应均为 JSON 格式:

{
  "success": true,
  "data": { ... },
  "message": "操作成功"
}

错误响应:

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "错误描述"
  }
}

专家 API

获取专家列表

GET /api/expert/list

响应:

{
  "experts": [
    {
      "id": "civil_lawyer",
      "name": "中国民事律师",
      "description": "专注民事法律咨询，350,000+案例",
      "category": "法律",
      "enabled": true
    }
  ]
}

向专家提问

POST /api/expert/ask
Content-Type: application/json

{
  "query": "什么是合同违约？",
  "expert_id": "civil_lawyer",
  "user_id": "user_123",
  "context": []
}

响应:

{
  "answer": "合同违约是指...",
  "confidence": 0.92,
  "expert_id": "civil_lawyer",
  "expert_name": "中国民事律师",
  "sources": [
    {
      "title": "《合同法》第107条",
      "relevance": 0.95
    }
  ],
  "response_time_ms": 1250
}

获取专家详情

GET /api/expert/{expert_id}

知识库 API

获取知识库列表

GET /api/knowledge/list

搜索知识库

POST /api/knowledge/search
Content-Type: application/json

{
  "query": "合同违约赔偿",
  "kb_id": "legal_kb",
  "top_k": 5
}

上传文档

POST /api/knowledge/{kb_id}/upload
Content-Type: multipart/form-data

file: <PDF文件>

用户 API

获取用户信息

GET /api/user/profile

更新用户信息

PUT /api/user/profile
Content-Type: application/json

{
  "name": "张三",
  "preferences": {
    "language": "zh-CN"
  }
}

MCP 工具 API

米塞斯分析

POST /mcp/analyze
Content-Type: application/json

{
  "user_input": "最近工作压力很大",
  "device_id": "device_123",
  "user_id": "user_123"
}

获取 MCP 工具列表

GET /mcp/tools

健康检查

GET /health

响应:

{
  "status": "healthy",
  "version": "3.0.0",
  "timestamp": "2026-02-01T10:00:00Z"
}

错误码

SDK

Python

from mbe import MBEClient

client = MBEClient(api_key="YOUR_API_KEY")
response = client.experts.ask("什么是合同违约？")

JavaScript

import { MBEClient } from '@mbe/sdk';

const client = new MBEClient({ apiKey: 'YOUR_API_KEY' });
const response = await client.experts.ask('什么是合同违约？');

更多文档

• 开发者 README
• API 完整参考
• SDK 示例

API 指南 | MBE v3.0.0 | 2026-02-01