MBE 文档中心

开发者专家管理功能文档

创建日期： 2026-01-26
功能范围： 专家创建、训练、发布流程

📋 功能概览

开发者门户现已支持完整的专家管理流程：

  1. 创建专家 - 基于知识库创建 AI 专家
  2. 训练模型 - 为专家训练专用模型
  3. 发布到市场 - 将专家发布到市场获得收益

🚀 功能详情

1. 专家管理页面

路由： /developer/experts

功能：

  • 显示开发者自己的专家列表
  • 显示专家统计（总数、已启用、已禁用）
  • 创建新专家
  • 训练模型
  • 发布到市场
  • 编辑专家

入口：

  • 导航栏："🤖 专家"
  • 知识库管理页面："🤖 创建专家"按钮
  • 仪表板快速操作（待添加）

2. 创建专家

流程：

  1. 访问 /developer/experts?action=create 或点击"创建专家"按钮
  2. 选择知识库（必须是已创建且状态为 ready 的知识库）
  3. 填写专家信息：
    • 专家名称（必填）
    • 专家描述（必填）
    • 欢迎语（可选）
    • 关键词（可选，系统会自动补充）
    • 领域（可选）
    • 优先级（1-10，默认6）
  4. 提交创建

API： POST /admin/knowledge/expert/publish

特点：

  • 自动补充关键词（从知识库提取 + AI 生成）
  • 自动补充领域信息
  • 创建后自动重载专家路由器

3. 训练模型

流程：

  1. 在专家列表点击"🎓 训练模型"
  2. 选择模型类型：
    • Expert（推荐）
    • TITANS
    • MoE
    • Adapter
  3. 设置训练参数：
    • 训练轮数（默认10）
    • 批次大小（默认4）
  4. 启动训练

API： POST /api/training/v2/start

功能：

  • 异步训练任务
  • 实时查看训练进度
  • 训练完成后自动保存模型

训练页面： /api/training/v2/ui?job_id={job_id}

4. 发布到市场

流程：

  1. 在专家列表点击"📢 发布到市场"
  2. 设置发布信息：
    • 定价（每1000 Token，单位：元）
    • 分类（通用、专业、教育、商业、技术）
    • 市场描述
  3. 提交发布申请

状态：

  • ⚠️ 发布到市场功能正在开发中
  • 当前显示提示信息
  • 后续将添加完整的市场发布流程

📊 专家列表显示

显示信息

  • 名称 - 专家名称
  • 描述 - 专家描述（前50字符）
  • 状态 - 已启用/已禁用
  • 关键词 - 关键词数量
  • 领域 - 领域列表（前3个）

操作按钮

  • 🎓 训练模型 - 启动模型训练
  • 📢 发布到市场 - 发布专家到市场
  • ✏️ 编辑 - 编辑专家信息（待实现）

🔗 相关页面

知识库管理页面

路由： /developer/knowledge

功能：

  • 显示知识库列表
  • 每个知识库都有"🤖 创建专家"按钮
  • 点击后跳转到专家创建页面，自动选择该知识库

📝 API 接口

创建专家

POST /admin/knowledge/expert/publish
Content-Type: application/json

{
  "kb_id": "knowledge_base_id",
  "name": "专家名称",
  "description": "专家描述",
  "greeting": "欢迎语",
  "keywords": ["关键词1", "关键词2"],
  "domains": ["领域1", "领域2"],
  "priority": 6
}

启动训练

POST /api/training/v2/start
Content-Type: application/json

{
  "kb_id": "knowledge_base_id",
  "user_id": "developer_id",
  "model_type": "expert",
  "config": {
    "epochs": 10,
    "batch_size": 4
  }
}

发布到市场（开发中）

POST /api/market/publish
Content-Type: application/json

{
  "expert_id": "expert_id",
  "price_per_1k_tokens": 0.01,
  "category": "general",
  "market_description": "市场描述"
}

🎯 完整业务流程

1. 创建知识库
   ↓
2. 上传文档
   ↓
3. 创建专家（基于知识库）
   ↓
4. 训练模型（可选，提升质量）
   ↓
5. 发布到市场（获得收益）
   ↓
6. 查看收益和结算

✅ 已实现功能

  • ✅ 专家管理页面
  • ✅ 创建专家功能
  • ✅ 训练模型入口
  • ✅ 发布到市场入口（UI已完成，API待实现）
  • ✅ 专家列表显示
  • ✅ 专家统计信息

🔄 待完善功能

  • 编辑专家功能
  • 删除专家功能
  • 发布到市场API实现
  • 训练进度实时显示
  • 专家使用统计
  • 专家评价和反馈

📖 相关文档

  • 开发者业务流程分析： docs/DEVELOPER_WORKFLOW_ANALYSIS.md
  • 开发者门户完整性评估： docs/DEVELOPER_PORTAL_COMPLETENESS_ASSESSMENT.md
  • 训练管理API： src/api/training_v2.py
  • 专家管理API： src/api/knowledge.py

最后更新：2026-01-26
版本：v1.0