# @agent-assistant/telemetry 中文文档

规范地址：https://npmcn.com/package/%40agent-assistant/telemetry/

版本：0\.4\.37
npm 元数据更新时间：2026-10-04T06:45:50.795Z
中文译文更新时间：2026-11-05T22:03:12.704Z
软件包许可：未声明

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

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

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

- 包体积（解压后）：113 kB，42 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-04-20T12:14:10.374Z
- 最新版本发布：2026-10-04T06:45:50.427Z
- 近 30 天下载量：14174（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：53（近 12 个月 53 个）

## 中文简介

代理助理的使用、费用和反应遥测原始数据

## 安装

```sh
npm install @agent-assistant/telemetry
```

也可以使用：`pnpm add @agent-assistant/telemetry`、`yarn add @agent-assistant/telemetry`、`bun add @agent-assistant/telemetry`

## README

# 代理助理遥测

## 人类Eval帮助者

`@agent-assistant/telemetry/evals` 包括产品 eval 的可重复使用的助手 (a) 将案件保留在人类授权的系统中,同时分享决定性的检查和 运行文物.

产品通常只能保存一个小的包装脚本和自己的 `evals/suites/*/cases.md` 文档。 共享软件包提供:

-   标记 `cases.md` 解析和编译到生成 `cases.jsonl`。 。 。 .
-   JSONL套件通过套件,外壳或标记来加载和过滤.
-   对内容、 regex 、 工具调用、 路由元数据进行决定性检查 理由和疑问.
-   通过下列途径进行人文审查跟踪: `Must`, (中文(简体) ), `Must Not`,以及 `Human Review: true`。 。 。 .
-   运行文物写作 : `result.json`, (中文(简体) ), `summary.md`,以及 `human-review.md`。 。 。 .
-   具有可插件产品执行器的通用 CLI 运行回路 .
-   本地 OpenCode 一发即审即决运行和更深处的提供者执行器助手 代理中继交易.
-   CI 概要渲染失败/ 上市时被忽略 `needs-human` 案件审查.

最小产品跑道:

```ts
import {
  compileHumanEvalSuitesFromMarkdown,
  runHumanEvalCli,
  summarizeLatestHumanEvalRunForCi,
} from '@agent-assistant/telemetry/evals';
import path from 'node:path';

const rootDir = path.resolve(import.meta.dirname, '../..');

compileHumanEvalSuitesFromMarkdown({
  suitesDir: path.join(rootDir, 'evals', 'suites'),
});

const exitCode = await runHumanEvalCli({
  argv: process.argv.slice(2),
  rootDir,
  runsDir: path.join(rootDir, '.nightcto', 'evals', 'runs'),
  productName: 'NightCTO Evals',
  executors: {
    async nightcto(testCase, context) {
      // Invoke the product here and normalize to:
      // { content: string, toolCalls: Array<{ name: string }>, status?: string }
      return { content: String(testCase.input.message ?? ''), toolCalls: [] };
    },
  },
});

if (process.env.GITHUB_STEP_SUMMARY) {
  summarizeLatestHumanEvalRunForCi({
    rootDir,
    runsDir: path.join(rootDir, '.nightcto', 'evals', 'runs'),
    githubStepSummaryPath: process.env.GITHUB_STEP_SUMMARY,
    title: 'NightCTO Eval CI Summary',
  });
}

process.exit(exitCode);
```

## 提供者备份运行

提供商支持的运行是选入的,所以离线的确定性检查是便宜的。 使用 `--provider` 允许执行人调用模型或经纪人,以及 `--executor` 改为 通过一个提供者管理现有的手工案件,而不改写每个案件.

```sh
node scripts/evals/run-product-evals.mjs --provider --executor opencode --suite workflow-authoring
```

OpenCode 帮助将代理助理包住 CLI 运行器,所以产品 可使用免费或本地的OpenCode模型而无需OpenRouter证书:

```ts
import {
  createOpenCodeHumanEvalExecutor,
  runHumanEvalCli,
} from '@agent-assistant/telemetry/evals';

const exitCode = await runHumanEvalCli({
  argv: process.argv.slice(2),
  rootDir,
  productName: 'Ricky Evals',
  executors: {
    opencode: createOpenCodeHumanEvalExecutor({
      productName: 'Ricky',
      model: 'opencode/minimax-m2.5-free',
      instructions: [
        'Follow Ricky workflow standards.',
        'Prefer deterministic verification, review artifacts, and honest blocker reporting.',
      ],
    }),
  },
});
```

使用直接的 OpenCode 路径快速扫描候选人的本地质量 答案是单个助手的反应。 通常结果还是 `needs-human`; 模型输出被捕获到 `human-review.md` 一个人 与案件相对 `Must` 财务报告和审定财务报表 `Must Not` 子弹.

## 复杂 Evals 代理中继器

当 eval 需要真正的执行地形而非单个时使用 Agent Relay 模式答案:工人产卵、工具中介工作、渠道/经纪人行为、, 多代理协调,或依赖中继元数据的产品路径. `createAgentRelayHumanEvalExecutor()` 动态导入仅节点中继器 适配器只当此执行器运行时 .

```ts
import {
  createAgentRelayHumanEvalExecutor,
  runHumanEvalCli,
} from '@agent-assistant/telemetry/evals';

const exitCode = await runHumanEvalCli({
  argv: process.argv.slice(2),
  rootDir,
  productName: 'Ricky Evals',
  executors: {
    relay: createAgentRelayHumanEvalExecutor({
      productName: 'Ricky',
      channelId: 'agent-assistant-evals',
      workerName: 'ricky-eval-worker',
      timeoutMs: 300_000,
      spawnWorker: {
        enabled: true,
        cli: 'opencode',
        model: 'opencode/minimax-m2.5-free',
        includeWorkflowConventions: true,
      },
      instructions: 'Exercise the real worker path and return an Agent Assistant ExecutionResult.',
    }),
  },
});
```

以下列方式处理这些案件:

```sh
node scripts/evals/run-product-evals.mjs --provider --executor relay --case workflow-authoring.multi-agent-repair
```

对于长期运行的Evals,更喜欢一次一个案例或一个套房,并给 执行一个更大的超时 。 中继等产出包括正常内容, 结构化工具调用时, 中继元数据, 以及正常的微量数据 人类eval管理着文物.

## 常见问题

### @agent-assistant/telemetry 是什么？

代理助理的使用、费用和反应遥测原始数据

### 如何安装 @agent-assistant/telemetry？

在项目目录运行 npm install @agent-assistant/telemetry，或使用 pnpm add / yarn add / bun add。

### @agent-assistant/telemetry 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @agent-assistant/telemetry 支持 ESM 还是 CommonJS？

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

### @agent-assistant/telemetry 可以商用吗？

@agent-assistant/telemetry 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @agent-assistant/telemetry 的下载量有多少？

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

### @agent-assistant/telemetry 还在维护吗？

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