SuperAPI AI 工具集

jev-curl

智能体与模型

查看项目

更新于 10-15 23:43

技能介绍

用途:仅用 curl 访问 TypeSafe 官方 Jev HTTP API,完成候选选择、是非判断和评分。适合材料充分、判断标准明确的语义任务,如分类分流、从已有候选中选择、判断内容是否符合要求、按给定等级评分。能通过确定条件、计算或数据库查询得到结果时,优先用代码或查询,不额外调用模型;需要检索、多步推理或方案设计时,先完成这些工作,再把局部判断交给 Jev。

用法:认证直接读取当前执行进程的 TYPESAFE_API_KEY,无需 SDK、MCP 或独立配置文件。将待判断内容放入 state,问题放入 instructions,候选或等级放入 criteria;选项用 choice,是否成立用 noul,程度评分用 score。问题 ID 只用于匹配返回结果。相同状态下互不依赖的问题可放入同一次请求,问题之间不能引用尚未返回的答案。用 JSON 文件或带引号的 heredoc 传递请求体,通过 curl 执行;密钥只进入认证头,不写入请求体、日志或仓库,执行时关闭 shell 跟踪,避免 curl -v 或 trace 输出认证头。仅要求示例时输出命令;要求执行时检查 curl 可用且环境变量非空,只报告是否存在,不打印密钥。

返回与失败:同时检查 curl 退出码、HTTP 状态及 answers 中每个问题的类型和结果。choice 必须落在提交的候选内;noul 是“是”的概率,不是布尔值;score 按返回的 legend 解读。confidence 不等于事实正确率。401/403 停止并报告认证或权限问题;422 修正字段错误再调用;429/529 按服务端提示或指数退避最多重试两次;超时或连接中断说明结果未知,重试可能重复计费。

限制:候选可能不覆盖实际情况时,增加“以上皆非”或“信息不足”选项;不要在证据不足时强制选出业务选项。接入自动执行前,用实际任务样本验证效果和错误后果,不单凭模型置信度决定自动执行。浏览器操作交给浏览器专用 skill。本 skill 是个人维护的 curl 专用版本,接口核对日期 2026-09-21。