可复用的语义特征

把反复使用的语义条件保存为特征，可以统一定义、检查证据，并在兼容的查询中复用评估结果。

定义一个特征#

例如，将“工单是否需要后续处理”保存为布尔特征。向 POST /features 提交：

json

{
  "dataset_id": "tickets",
  "name": "needs_follow_up",
  "column": "body",
  "definition": "工单描述了尚未解决、需要继续处理的问题。",
  "kind": "noul",
  "context_columns": [],
  "maintain": true
}

请替换为目录中实际存在的数据集和字段。context_columns: [] 只提供被评估的字段；null 表示允许使用整行上下文。优先明确指定判断所需的字段。

支持布尔判断（noul）、类别选择（choice）、评分（score）和提取（extract）。定义应说明判断依据和边界，避免使用没有解释的业务缩写。

先预览，再启用#

通过 POST /features/{id}/preview 试评估少量记录，例如设置 max_evaluations: 100。检查符合、不符合和边界情况后，再通过 /review 提交复核结论。

创建、复核、人工纠正和刷新需要 reviewer 权限。人工断言通过主键绑定到具体记录，并保存值与理由。定义和源数据的变化会影响证据能否继续使用。

复用与维护#

特征采用不可变的定义版本。查询只复用与当前定义、输入和评估配置兼容的证据。开启维护后，刷新用于补充或更新相应结果；修改定义不会悄悄覆盖旧版证据。

人工纠正、模型观察和最终决定分别保存，方便追踪一个结果是如何产生的。

用于数据变更#

如果语义特征决定哪些记录会被修改，成员归属必须先确定。仍有不确定或未评估记录时，系统会阻止相应写入。所有写入都需要单独提交变更预览。

本页介绍用法与注意事项。完整参数及详细约定请参阅对应英文文档。