j.jev4pg使用文档
语义算子
核心概念

语义算子

语义算子把文本判断表达成有明确输入、输出和预算的操作。通过 POST /jev/call 调用,使用数据库访问令牌进行认证。

一个最小调用#

JEV.NOUL 判断给定材料是否支持一个命题:

json
{
  "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 权限。

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