用途:对某个状态(state)提出一个或多个结构化问题,通过 POST /openrouter/v1/decisions 获取分类、类布尔判断或有序评分结果。模型固定为 ~typesafe/jev-latest。
主要能力:支持三类问题。choice 需 instructions 与 criteria 对象(选项名到指引的映射);noul 需 instructions,可选 criteria 必须同时含 true 与 false 指引,其答案是连续类布尔分数,除非用户要求阈值,否则不要改写为严格布尔;score 需 instructions 与有序 criteria 数组。问题名需保持稳定,因为响应 answers 使用相同键。
使用方式:调用 scripts/create_decision.sh。必填输入包括 state(--state 或 --state-file)、questions(--questions 或 --questions-file)、认证(环境变量 FREVANA_TOKEN 或 --token)。可用 --raw-payload-file 提供完整请求体,但不能与 state、questions、provider、trace、session、user 标志同时使用;脚本仍会固定并校验模型。默认返回校验后的完整响应 JSON,用户只要 answers 对象时用 --answers-only。可选参数有 --session-id、--user、--provider/--provider-file、--trace/--trace-file、--agent-app-instance-id、--output。使用 provider 路由、trace 元数据、原始载荷或需精确字段时,参阅 references/api.md。
限制:不要臆造 provider 路由、trace 元数据、session ID 或 user ID;不要自动重试请求,超时请求可能已完成并产生费用。服务端使用 OpenRouter SDK 的 camelCase 输入形状,脚本也接受官方 snake_case 名称并在发送前归一化。