偏好信号

概览

preference 从示例与分类器设置推断响应风格偏好。在 routing.signals.preferences 下定义偏好规则。

该族为学习型：使用 global.model_catalog.modules.classifier.preference 下的偏好分类路径。

带有显式示例的规则默认使用 embedding 相似度；只有描述的规则使用默认决策 deployment。 显式设置 embedding_model 也会选择 embedding 相似度。已配置的外部 preference-role 后端 会继续使用自己的路径，除非你显式选择其他模式。

主要优势

• 个性化路由，而不把用户状态硬编码进决策。
• 偏好检测与路由结果分离。
• 支持示例驱动的风格检测，例如简短 vs 详尽回答。
• 同一偏好策略可被多条决策复用。

解决什么问题？

用户即使问同一主题，也常常想要不同响应风格。若这些偏好只在下游处理，路由就无法选择最合适的模型或插件栈。

preference 将推断出的风格偏好暴露为命名路由输入。

何时使用

在以下情况使用 preference：

• 部分用户偏好简短回答，另一些想要高细节
• 路由行为应适应稳定的风格偏好
• 希望偏好检测在多条决策间保持可复用
• 用户风格信号应影响模型选择、插件选择，或两者

配置

routing:
  signals:
    preferences:
      - name: terse_answers
        description: Users who prefer short, direct responses.
        examples:
          - keep it concise
          - bullet points only
          - answer in one paragraph
        threshold: 0.7

示例描述你希望识别的风格，按语义比较，而不是逐字匹配关键词。这里的 threshold 对应 embedding 相似度分数，不是决策模型的概率。

若要显式使用这种比较，包括规则只有描述时，请设置 use_contrastive: true：

global:
  model_catalog:
    modules:
      classifier:
        preference:
          use_contrastive: true
          prototype_scoring:
            enabled: true
            cluster_similarity_threshold: 0.9
            max_prototypes: 8
            best_weight: 0.75
            top_m: 2
            margin_threshold: 0.05

对比模式下，Router 嵌入每条偏好规则的描述与示例，在启用 prototype_scoring 时将它们压缩成代表性原型，再把传入请求与这些原型比较。margin_threshold 让你可以拒绝模糊胜者，而不是强迫弱偏好匹配。

显式设置 use_contrastive: false 会关闭 embedding 比较：已配置外部偏好后端时使用该后端， 否则使用默认决策 deployment。仅设置 prototype 参数不会选择对比模式。

若要显式选择原生决策任务，在 routing.model_bindings 或 global.model_catalog.bindings 下为 preference 配置 contract: decision.v1。该绑定优先于示例和 use_contrastive， 规则阈值对应原生 choice 概率。cosine 阈值和 prototype margin 属于 embedding 路径； 切换到原生判断后，请重新检查示例的匹配结果。

依赖与限制

偏好规则使用共享嵌入/分类器路径，仅从可用请求上下文推断风格。不应把它们当作持久用户同意或身份。完整示例见： config/fragments/signal/preference/power-user.yaml。