语义算子
语义算子把文本判断表达成有明确输入、输出和预算的操作。通过 POST /jev/call 调用,使用数据库访问令牌进行认证。
一个最小调用#
JEV.NOUL 判断给定材料是否支持一个命题:
{
"operator": "JEV.NOUL",
"arguments": {
"state": "这项工作已经完成。",
"proposition": "材料说明工作已完成。"
},
"limits": {"max_judgments": 1, "max_requests": 1}
}limits 与 operator、arguments 同级,用于约束整个调用。不要把外层预算放进算子参数。
选择合适的算子#
| 需求 | 常用算子 |
|---|---|
| 判断命题、选择类别、按标准评分 | NOUL、CHOICE、SCORE |
| 筛选、标注和分类 | FILTER、TAG、CLASSIFY |
| 比较与排序 | COMPARE、RANK、RERANK |
| 提取原文、日期或表格 | EXTRACT、EXTRACT_DATE、EXTRACT_TABLE |
| 判断记录之间的关系 | JOIN、MATCH、EVIDENCE_JOIN |
| 管理可复用定义 | DISCOVER、REVIEW、PROMOTE、REFRESH |
部分算子接受直接提供的文本,另一些需要数据集、特征或前序运行的 ID。精确参数请查阅函数参考。
读取结果#
先检查 output_state,再读取 value。未完成结果可能提供 partial_value,但不代表整个任务已完成。各条观察记录保留各自的输出状态和运行状态。
调用会保留运行记录和证据。使用 GET /jev/operators 查看算子目录,GET /jev/operators/examples 查看完整请求示例,通过 /jev/runs 检查运行记录。
预算与权限#
并发、评估次数和请求次数共同限制工作量。预算不足时应保留未完成状态,而不是填入否定答案。复核、发布、物化和刷新等管理操作需要相应的 reviewer 权限。
本页介绍用法与注意事项。完整参数及详细约定请参阅对应英文文档。