# @formio/uag-jev 中文文档

规范地址：https://npmcn.com/package/%40formio/uag-jev/

版本：2\.0\.0
npm 元数据更新时间：2026-11-13T11:24:11.560Z
中文译文更新时间：2026-11-15T10:52:18.260Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40formio/uag-jev
原文对照：https://npmcn.com/package/%40formio/uag-jev/?lang=original
项目主页：https://github.com/formio/uag#readme
源码仓库：https://github.com/formio/uag

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：13.2 kB，4 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.0\.0
- 运行依赖：2 个
- 首次发布：2026-10-29T17:11:54.682Z
- 最新版本发布：2026-11-13T11:24:11.067Z
- 近 30 天下载量：2058（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 13 个）

## 中文简介

Form.io Universal Agent Gateway(UAG)的TypeSafe Jev决定引擎:快速,有信心分数的选择,得分和Agent API的是/否决定.

## 安装

```sh
npm install @formio/uag-jev
```

也可以使用：`pnpm add @formio/uag-jev`、`yarn add @formio/uag-jev`、`bun add @formio/uag-jev`

## README

# 校对:soup

[表格.io UAG](https://ai.form.io/developers) › [发动机](https://ai.form.io/developers/engines) › 此页

类型安全 **杰维** 决策引擎 [UAG 代理 API](https://ai.form.io/developers/agent-api)它在一个请求中回答一个任务的闭合设置字段(收音机,选取,复选框,选取框,勘测和小资源选择),一般为70~500毫秒,每个答案都有置信度.

列入 `formio/uag` 多克图像. 由 npm 安装 UAG 后, 在它旁边安装 :

```bash
npm install @formio/uag-jev
```

通过命名启用它,并设置它的密钥:

```
UAG_ENGINES=jev
TYPESAFE_API_KEY=...
```

决定是代理形式流,所以对于一个自办项目,UAG也需要一个 `LICENSE_KEY` 包括项目终点的 UAG(见 [许可证发放](https://ai.form.io/developers/deployment#licensing)Form.io的托管服务项目不需要.

## 设置

| 设置 | 变量 | 默认 |
| --- | --- | --- |
| `apiKey` | `UAG_ENGINE_<NAME>_API_KEY`, (中文(简体) ), `TYPESAFE_API_KEY` | 要求(秘密) |
| `model` | `UAG_ENGINE_<NAME>_MODEL`, (中文(简体) ), `TYPESAFE_MODEL` | `jev-1.13.0` |
| `baseURL` | `UAG_ENGINE_<NAME>_BASE_URL`, (中文(简体) ), `TYPESAFE_BASE_URL` | sDK的默认值 |

`<NAME>` 是实例名称,大写为 `-` 作为 `_`。一个案例本身的变量胜过共享的变量.

SDK的请求超时 遵循实例的路由超时(`routing.timeouts.<name>`,则 `agentApi.timeout`,否则30秒; 总是在引擎服务器上30秒),所以其对速率限制和超载反应的回覆从未超过. 超时后,UAG回落到下一个引擎.

## 实例

运行第一个旁边的第二个Jev模型,例如,在切换前比较实时流量的新版本:

```
UAG_ENGINES=jev,next:jev
TYPESAFE_API_KEY=...
UAG_ENGINE_NEXT_MODEL=jev-1.14.0
```

运行列表列出实例 : `routing.decision: ["next", "jev"]`。 。 。 .

## 压住模型

Jev版本的行为不同. 保留 `model` 在一个日期的版本中运行 `uag-eval` 在更改其或任何阈值之前,使用自己标注的示例. `uag-eval --engine jev` 从 UAG 寄存器的检出或内部 `formio/uag` 图像 :

```
docker run --rm --entrypoint node -v "$PWD:/data" -e TYPESAFE_API_KEY -e LICENSE_KEY formio/uag \
  --no-node-snapshot bin/uag-eval.js --form /data/claim.json --examples /data/claim-examples.json \
  --engine jev --project <your project URL>
```

`uag-eval` 需要一个 `LICENSE_KEY` 包括该项目终点的UAG.

## 如何运作

UAG 构建问题并解析答案; 此软件包只将问题映射到 `@typesafe-ai/sdk`。所问选项以外的答案被删除,分数被控制在其水平之内。 杰夫的车 [信心](https://docs.typesafe.ai/confidence) 已经向平分状态正常化了,这是UAG的信心阈值所期望的,所以没有改变.

**错误 :** a被拒绝的API密钥(401,403),速率限制(429)和TypeSafe服务器故障(5xx)到达API呼叫器,因为没有响应正文;其他故障只报告为"引擎故障". 检索时间永远不要超过请求的超时 `Retry-After`。 。 。 .

**数据居住:** Jev是一个托管服务。 每个请求发送类型安全 :

-   任务的标准和今天的日期;
-   数值 `uagContext` 路径;
-   输入字段,或者,对于没有输入的任务,除决定的字段外,整个提交.

不能将数据发送到那里的部署不应使该引擎成为可能;然后决策字段又回到代理引擎.

**日志 :** 离开 `TYPESAFE_LOG_LEVEL` 未设置(或 `warn`在生产中。 时 `debug`,TypeSafe SDK将每个请求和响应机构写入控制台,它们持有提交数据.

## 在自己的服务器上使用

将其命名为配置而非 `UAG_ENGINES`,具有优先于环境的选项:

```js
const server = new UAGServer({ engines: [{ name: 'jev', type: 'jev', options: { model: 'jev-1.13.0' } }] });
```

驾照:麻省理工.

## 常见问题

### @formio/uag-jev 是什么？

Form\.io Universal Agent Gateway\(UAG\)的TypeSafe Jev决定引擎:快速,有信心分数的选择,得分和Agent API的是/否决定\.

### 如何安装 @formio/uag-jev？

在项目目录运行 npm install @formio/uag-jev，或使用 pnpm add / yarn add / bun add。

### @formio/uag-jev 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/formio\_\_uag-jev 是否存在。

### @formio/uag-jev 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @formio/uag-jev 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @formio/uag-jev 可以商用吗？

@formio/uag-jev 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @formio/uag-jev 的下载量有多少？

根据 npm 官方下载统计，@formio/uag-jev 在 2026/10/16 – 2026/11/14 这 30 天内被下载 2,058 次，日均约 69 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @formio/uag-jev 还在维护吗？

最新版本 2\.0\.0 发布于 2026/11/13（2 天前）；至今共发布 13 个版本，其中过去 12 个月发布了 13 个；首次发布于 2026/10/30。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。