MBE 文档中心

Cookbook #4: 配置 HOPE 个性化

启用 HOPE 偏好学习，让专家自动适应不同用户的沟通风格偏好。

⏱ 预计用时：5 分钟

前置条件

  • 已创建并发布专家
  • 订阅计划为专业版或以上（免费版不支持 HOPE）

步骤 1: 启用 HOPE

curl -X PUT https://your-domain.com/api/experts/exp_abc123/hope \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "learning_rate": "moderate",
    "preference_dimensions": [
      "response_length",
      "formality_level",
      "detail_depth",
      "example_usage"
    ]
  }'

学习速率选项

选项 说明 适用场景
conservative 慢速学习，需要更多信号 高风险行业（金融/医疗）
moderate 默认速率 通用场景
aggressive 快速适应 内部工具、低风险场景

偏好维度说明

维度 说明 调整范围
response_length 回答长度偏好 简短 ↔ 详细
formality_level 语言正式程度 口语化 ↔ 书面化
detail_depth 细节深度 概要 ↔ 深入
example_usage 是否使用举例 少 ↔ 多

步骤 2: 模拟用户交互

HOPE 通过隐式信号学习偏好。让不同"用户"进行对话：

# 用户 A: 偏好简短专业回答
curl -X POST https://your-domain.com/api/chat \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "expert_id": "exp_abc123",
    "user_id": "user_a",
    "message": "劳动合同解除的经济补偿标准？",
    "feedback": {
      "satisfaction": 4,
      "preferred_style": "concise"
    }
  }'

# 用户 B: 偏好详细通俗回答
curl -X POST https://your-domain.com/api/chat \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "expert_id": "exp_abc123",
    "user_id": "user_b",
    "message": "劳动合同解除的经济补偿标准？",
    "feedback": {
      "satisfaction": 5,
      "preferred_style": "detailed"
    }
  }'

步骤 3: 查看偏好学习状态

curl -X GET https://your-domain.com/api/experts/exp_abc123/hope/status \
  -H "X-API-Key: your-api-key"

预期响应：

{
  "expert_id": "exp_abc123",
  "hope_enabled": true,
  "learning_rate": "moderate",
  "user_profiles": {
    "user_a": {
      "interactions": 15,
      "learned_preferences": {
        "response_length": "short",
        "formality_level": "formal",
        "detail_depth": "summary",
        "example_usage": "minimal"
      },
      "confidence": 0.72
    },
    "user_b": {
      "interactions": 12,
      "learned_preferences": {
        "response_length": "long",
        "formality_level": "casual",
        "detail_depth": "deep",
        "example_usage": "frequent"
      },
      "confidence": 0.65
    }
  }
}

HOPE 最佳实践

实践 说明
充分交互 至少 10 轮对话后偏好才开始稳定
反馈引导 提供满意度评分可加速学习
行业匹配 金融/医疗用 conservative，通用用 moderate
监控偏移 定期检查偏好是否偏离预期范围
重置选项 如学习方向错误，可重置单个用户偏好

注意事项

  • 零数据保留模式下：HOPE 不可用（不存储偏好数据）
  • 隐私保护：偏好数据不包含对话内容，仅存储统计信号
  • 跨专家隔离：用户偏好在不同专家之间不共享

下一步