@evo-hq/evo-agent

中文文档
0.8.0发布于 2026/07/18Apache-2.0ES Module零依赖近 30 天下载 6044

轻量级报告SDK用于evo实验. 零从属.

中文使用文档
文档目录5 节
  1. 安装
  2. 使用量
  3. 基准(运行)
  4. 门
  5. 环境

evo- agent (节点 SDK)

轻量级报告 SDK 埃沃语name 实验 零依赖性,仅限无害环境管理,节点18+.

镜像 evo-agent Python SDK 表面 : Run 每个任务记录+分数, Gate 安全检查和出口密码.

安装

npm install @evo-hq/evo-agent

使用量

基准(运行)

import { Run } from '@evo-hq/evo-agent';

const run = new Run();
for (const task of tasks) {
  run.log(task.id, 'starting task');
  const result = await evaluate(task);
  run.log(task.id, { output: result.output });
  run.report(task.id, {
    score: result.score,
    summary: `reward=${result.score.toFixed(2)}`,
    failureReason: result.passed ? undefined : 'task_failed',
  });
}
await run.finish();

打开 finish()数字 :

  • 打印分数 JSON 到 stdout (合同 evo 读取 ).
  • 每个任务跟踪文件被写入到 $EVO_TRACES_DIR 分别 report() 名为.

门

import { Gate } from '@evo-hq/evo-agent';

const gate = new Gate();
for (const task of criticalTasks) {
  const result = await evaluate(task);
  gate.check(task.id, { score: result.score, detail: `reward=${result.score.toFixed(2)}` });
}
gate.finish();  // exits 0 if all passed, 1 otherwise

环境

  • EVO_TRACES_DIR 目录 task_<id>.json 文件被写入( 设置于 evo run(中文(简体) )
  • EVO_EXPERIMENT_ID 每个跟踪中嵌入的实验标签

两者在Evo CLI生成基准时自动设定. 失踪的瓦尔斯是被容忍的 -- -- 痕迹只是被忽略了.

版本与发布记录

@evo-hq/evo-agent 共发布 65 个版本,首次发布于 2026/04/12;过去 12 个月发布了 65 个版本。

版本发布日期距今
0.8.0latest2026/07/183 个月前
0.7.1-alpha.1alpha2026/07/173 个月前
0.7.02026/07/014 个月前
0.7.0-alpha.32026/07/014 个月前
0.7.0-alpha.22026/07/014 个月前
0.7.0-alpha.12026/07/014 个月前

关于 @evo-hq/evo-agent 的常见问题

@evo-hq/evo-agent 是什么?

轻量级报告SDK用于evo实验. 零从属.

如何安装 @evo-hq/evo-agent?

在项目目录运行 npm install @evo-hq/evo-agent,或使用 pnpm add / yarn add / bun add。

@evo-hq/evo-agent 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/evo-hq__evo-agent 是否存在。

@evo-hq/evo-agent 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@evo-hq/evo-agent 需要什么版本的 Node.js?

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

@evo-hq/evo-agent 可以商用吗?

@evo-hq/evo-agent 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@evo-hq/evo-agent 的下载量有多少?

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

@evo-hq/evo-agent 还在维护吗?

最新版本 0.8.0 发布于 2026/07/18(3 个月前);至今共发布 65 个版本,其中过去 12 个月发布了 65 个;首次发布于 2026/04/12。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。