SuperAPI AI 工具集

jev

智能体与模型

查看项目

更新于 10-17 16:19

技能介绍

Jev 是一个基于 TypeSafe AI 的结构化评估工具,通过 swift-jev 命令行程序提供调用接口,适合需要将一段状态或情境数据转化为明确分类、判断或评分的任务。

用途方面,Jev 用于对用户提供的状态进行三类评估:choice 问题要求在给定选项及描述中做分类选择;score 问题要求在 2 至 10 个有序等级描述中给出评分;noul 问题用于判断某个陈述为真的概率,数值接近 0.5 表示不确定,且不单独提供置信度。choice 和 score 会返回置信度与分布。这些结果属于评估性质,应在用户既定决策规则下使用,不应直接作为后续操作的唯一依据。

使用方式上,需在 PATH 中使用 jev 可执行文件,或从 swift-jev 代码库执行 swift run jev。若命令不可用,需按 swift-jev README 说明安装 CLI。调用时通过标准输入或 --input FILE 发送一个包含 state 和 questions 的 JSON 对象;state 可为任意 JSON 值,每个问题需有唯一名称、类型和非空指令。choice 的 criteria 将选项名映射到描述或 null;score 的 criteria 是 2 至 10 个等级描述组成的有序数组;noul 可选 criteria 描述 true 与 false。相关的问题应放入同一请求。响应以 JSON 输出到标准输出,错误写入标准错误。

认证方面,密钥由用户或其环境提供。CLI 默认读取 TYPESAFE_API_KEY,或使用 --api-key-file 指定 UTF-8 密钥文件。不得将密钥放入命令参数、请求 JSON、技能文件或仓库文件;若两种来源都不可用,应让用户配置。不要自行读取或回显密钥。

适用场景包括对客户咨询进行部门分类、判断是否需要当日处理、评估客户影响严重程度等结构化评估任务。限制方面,调用会将状态数据发送至 TypeSafe AI,因此应避免包含无关私人数据;CLI 本身仅执行评估,不授权或执行后续操作。