用途:Jev Agent 让 AI 编程智能体在需要类型化判断时调用 Jev AI 决策服务。Jev 接收应用状态与明确问题,返回带概率的结构化答案;工作流、权限、人工审批和最终动作仍由智能体或应用负责。
主要能力:支持三种问题类型——choice(从候选项中分类、路由、选择)、score(按有序量表评估风险、优先级、质量)、noul(返回真假概率,用于放行、升级、人工复核)。适合答案空间可预先定义且结果会驱动程序分支的场景,如任务路由、文本分类、风险评分、判断证据是否充分。不适用于长文本生成、代码生成、解释、精确数据库查询、算术、认证授权或可确定性表达的规则。
使用方式:首次使用前检查环境变量 JEV_LANGUAGE(可选,en-US 或 zh-CN,默认 en-US)、JEV_API_KEY(必填,在 https://thejevai.com/settings/apikeys 创建)、JEV_API_BASE_URL(可选,默认 https://thejevai.com)、JEV_MODEL(可选,默认 typesafe/jev-1.13)。缺少密钥时用占位命令配置,切勿在对话中粘贴真实密钥:export JEV_API_KEY="sk_your_key_here"。API 为 REST 接口:POST https://thejevai.com/v1/systemone,请求头 Authorization: Bearer $JEV_API_KEY,请求体含 model、state、questions 三个必填字段。state 可为字符串、对象或数组,只发送决策所需事实并移除敏感数据。每个问题只问一个窄判断,可批量提交共享同一 state 的独立问题,但不要在同一请求中让后续问题依赖前面的答案。响应为标准信封,含 code、message、data.result.answers 等;choice 和 score 需查看选项、概率与置信度,noul 为 0 到 1 的概率值。概率与置信度只是信号,不是证明或授权,阈值应依据实际风险与历史数据设定。
安装:npx skills add jev-ai/jev-agent-skill;手动安装可复制文件到 .agents/skills/jev-agent/SKILL.md。
限制:该技能不创建新工具、不授予权限、不拦截 shell 调用,也不在智能体现有权限之外执行策略。调用本身不执行被判断的动作。需显式处理失败:非 2xx 返回状态与安全错误信息;code 不为 0 不视为有效结果;缺少 data.result.answers 视为无效;401 检查密钥配置;402 提示充值或使用有效账户密钥;超时、429 或上游失败仅在安全时做有界退避重试,绝不因决策请求失败而重复执行有后果的动作。高影响动作仍需确定性策略、权限与人工审批。文档见 https://thejevai.com/docs,密钥管理见 https://thejevai.com/settings/apikeys,试用见 https://thejevai.com/playground。