aardio 文档

web.rest.aiDecision 库模块帮助文档

接口说明

AI 结构化决策客户端

web.rest.aiDecision 用于实现 OpenRouter Decisions 协议，不限定模型厂商； 目标模型与服务必须支持该协议。

questions 的各项可直接写为 {type="noul";instructions="是否紧急？"}， 也可简写为 ["noul","是否紧急？"] 或 [type,instructions,criteria]。 evaluate 调用前统一将数组简写转换为协议对象，不改变调用者的数据；原生对象保留所有字段。 声明问题不会发送请求，只有调用 evaluate 才会请求模型。

所有决策模型在 OpenRouter 上使用相同的 state / questions / model 请求结构； 本库保留完整请求和原生问题对象的扩展字段，不硬编码模型清单、上下文长度或判定阈值。 这不表示各厂商的直连接口均兼容；更换模型后应重新评估中文样本与业务阈值。

web.rest.aiDecision 默认使用 mercury-decide 。 Jev（~typesafe/jev-latest）仅作为兼容选择（中文支持较差，不推荐用于中文任务）。 其他可用模型请参考 https://openrouter.ai/rankings/decisions?view=day#top-models

» 使用指南 » 范例

web.rest 成员列表 #

web.rest.aiDecision #

AI 结构化决策客户端。
优先使用 mercury-decide，兼容 OpenRouter Decisions 协议。
输入 state 与类型化 questions，返回结构化 answers；不绑定单一模型厂商。
Jev 仅兼容，中文支持较差。

web.rest.aiDecision() #

返回对象:webRestAiDecisionObject

web.rest.aiDecision(cfg) #

创建 AI Decisions 客户端。
配置表可指定 key,model,url,extraHeaders,extraParameters 等字段。
默认 url 为 https://openrouter.ai/api/alpha/decisions。
OpenRouter 默认 model 为 inception/mercury-decide，构造参数与 AI_DECISION_API_MODEL 可覆盖。
自定义服务需使用与之匹配的模型 ID 和 Decisions 协议。

webRestAiDecisionObject 成员列表 #

webRestAiDecisionObject._http #

inet.http客户端，用于执行 http 请求

返回对象:inetHttpObject

webRestAiDecisionObject.answer(response,questionId) #

从响应中安全读取指定问题的答案。

webRestAiDecisionObject.ask(state,questions,model) #

evaluate 的别名。

webRestAiDecisionObject.buildPayload(request) #

完整请求表补充默认模型并转换问题数组简写；保留其他协议字段。

webRestAiDecisionObject.buildPayload(state,questions,model) #

构造请求体但不发送请求。
将 questions 中的数组简写转换为协议对象，不改变调用者数据；简写格式错误返回 null,err。

webRestAiDecisionObject.close() #

关闭对象释放资源

webRestAiDecisionObject.config #

API 配置表。
由构造参数浅拷贝并补充环境变量与默认值；model、url 记录客户端选用的模型与端点。

webRestAiDecisionObject.decisions(state,questions,model) #

evaluate 的别名。

webRestAiDecisionObject.defaultHeaders #

替换所有请求默认添加的HTTP头
请求结束时不会清空此属性
该值可以是一个字符串,也可以是键值对组成的table对象

webRestAiDecisionObject.evaluate(request) #

传入完整请求表调用 Decisions 接口。

webRestAiDecisionObject.evaluate(state,questions,model) #

调用 Decisions 接口。
questions 为问题 ID 到问题声明的表，各项支持原生对象或 [type,instructions[,criteria]] 数组简写，可混用。
model 可省略；成功返回原始响应，失败返回 null,err[,errCode]。

webRestAiDecisionObject.extraHeaders #

设置每次请求都附加的 HTTP 请求头，可在构造参数表中指定初始值。
此属性值可以是 web.joinHeaders 函数支持的字符串、表（数组、键值对）

webRestAiDecisionObject.extraParameters #

指定附加到所有请求参数中的默认参数，值为表。
由底层 REST 客户端补充；模型应使用 model 配置，问题应放在 evaluate 的 questions 中。

webRestAiDecisionObject.extraUrlParameters #

指定附加到所有请求 URL 的默认参数。
该值可以是一个表或字符串。
表参数使用 inet.url.stringifyParameters 转换为字符串。
表中的值如果是函数则每次请求都调用该函数取值

webRestAiDecisionObject.get(网址,参数表) #

使用该GET方法提交请求,获取资源
请求参数将会自动转换为URL附加参数,
请求参数可以指定表或字符串,如果是表请求前会转换为字符串
成功返回数据,失败返回空值,错误信息,错误代码

webRestAiDecisionObject.lastRequestUrl #

获取最后一次请求的 URL。
允许的 beforeRequestHeaders 事件中修改此属性以改变请求地址。

webRestAiDecisionObject.lastResponse() #

获取最后一次服务器返回的数据，流式调用时此函数返回值无意义。
如果控制台已打开或在开发环境中导入 console 库则在控制台输出数据
下载文件时该值为空

webRestAiDecisionObject.lastResponseError() #

返回服务器最后一次返回的错误响应，并转换为错误对象。
与调用 API 时转换响应数据一样，支持相同的服务器响应格式 。
如果错误来自本地（lastStatusCode 属性为 null）则此函数返回 null 。
如果最后一次发生请求成功，则此函数返回 null 。

如果在参数 @1 中指定返回字段，且错误对象包含该字段则使用直接下标获取并返回字段值。
获取字段失败返回 null 而非抛出异常

webRestAiDecisionObject.lastResponseObject() #

获取最后一次服务器返回的 JSON 对象。
请求失败或下载文件时为空。

webRestAiDecisionObject.lastResponseString() #

获取最后一次服务器返回的原始数据，流式调用时此函数返回值无意义。
请求失败，或者下载文件时此属性值为空

webRestAiDecisionObject.lastStatusCode #

获取最近一次请求返回的HTTP状态码
100 ~ 101 为信息提示
200 ~ 206 表示请求成功
300 ~ 305 表示重定向
400 ~ 415 表求客户端请求出错
500 ~ 505 表示服务端错误

webRestAiDecisionObject.lastStatusMessage() #

获取最近返回的HTTP状态码文本描述
第二个返回值为状态码

webRestAiDecisionObject.noulValue(response,questionId) #

读取 Noul 答案的 yes 概率。

webRestAiDecisionObject.ok() #

最后一次请求是否成功
服务器应答并且状态码为2XX该函数返回真

webRestAiDecisionObject.post(网址,参数表) #

使用该POST方法提交请求,新增或修改资源
请求参数可以指定表或字符串,如果是表请求前会转换为字符串
成功返回数据,失败返回空值,错误信息,错误代码

webRestAiDecisionObject.referer #

引用页地址。
如果此属性指定了一个值，则每次请求都会使用该引用页。
如果不指定，每次请求都会自动设置上次请求的网址为引用页。
这个属性不像 inet.http 对象的 referer 属性那样每次请求结束都会清空。

webRestAiDecisionObject.setHeaders #

设置所有请求默认添加的HTTP头

webRestAiDecisionObject.setHeaders(headers) #

参数 @headers 必须指定一个表中,
用该表中的键值对更新 defaultHeaders 属性中的键值
如果addHeaders的原属性值不是一个表,则先清空该属性

webRestAiDecisionObject.setTimeouts(连接超时,请求超时,接收超时) #

设置 HTTP 超时，单位为毫秒。
本库 evaluate 使用非流式 JSON 请求。

webRestAiDecisionObject.systemOne(state,questions,model) #

evaluate 的别名。

Markdown 格式