# @computesdk/agent37 中文文档

规范地址：https://npmcn.com/package/%40computesdk/agent37/

版本：0\.1\.7
npm 元数据更新时间：2026-11-13T15:45:52.691Z
中文译文更新时间：2026-11-14T13:13:33.497Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：90.1 kB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-11-04T13:30:14.160Z
- 最新版本发布：2026-11-13T15:45:52.460Z
- 近 30 天下载量：2038（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 8 个）

## 中文简介

Agent37 为 AI 代理提供 ComputeSDK - Linux sandbox 和 专用核心 VM 的供应商,任何端口都有公共 URL

## 安装

```sh
npm install @computesdk/agent37
```

也可以使用：`pnpm add @computesdk/agent37`、`yarn add @computesdk/agent37`、`bun add @computesdk/agent37`

## README

# @ computesdk/ 代理37

Agent37 ComputeSDK的提供商 - AI代理的持久Linux sandbox,任何端口都有签名的URL,以及可选的性能类型,其核心被持有.

## 安装

```bash
npm install @computesdk/agent37
```

## 设置

1.  创建 API 密钥 [代理37.com/dashboard/cloud/api-keys (英语)](https://www.agent37.com/dashboard/cloud/api-keys)
2.  设置环境变量 :

```bash
export AGENT37_API_KEY=sk_live_your_api_key
```

## 快速启动

```typescript
import { compute } from 'computesdk';
import { agent37 } from '@computesdk/agent37';

compute.setConfig({
  provider: agent37({ apiKey: process.env.AGENT37_API_KEY }),
});

const sandbox = await compute.instances.create();

const result = await sandbox.runCommand('node -v && python3 --version');
console.log(result.stdout);

await sandbox.destroy();
```

或者直接给供货厂打电话:

```typescript
import { agent37 } from '@computesdk/agent37';

const sdk = agent37({ apiKey: process.env.AGENT37_API_KEY });
const sandbox = await sdk.sandbox.create({ type: 'performance', cpu: 4, memory: 16384 });
```

## 配置

```typescript
interface Agent37Config {
  /** Agent37 API key - if not provided, will use AGENT37_API_KEY env var */
  apiKey?: string;
  /** API base URL - defaults to AGENT37_BASE_URL, then https://api.agent37.com */
  baseUrl?: string;
  /** Exec base URL - defaults to AGENT37_EXEC_URL, then https://sandbox.agent37.app */
  execUrl?: string;
  /** Run commands as root (default true). Set false to run as the image's own user. */
  runAsRoot?: boolean;
}
```

## 创建选项

| 选项 | 地图到 | 页:1 |
| --- | --- | --- |
| `templateId` | `template` | 模板名称. 默认 `agent37-base` (德比安有节点,Python,git和构建工具). |
| `type` | `type` | `default`, (中文(简体) ), `performance` (一整台其核心为其所持有的机器)或 `vm`。 。 。 . |
| `cpu` (或 `vcpus`, (中文(简体) ), `cpus`(中文(简体) ) | `resources.cpu` | vCPUs. (中文(简体) ). 大小为2 vCPU / 4. GB, 4. 8, 4. 16和 4. 32. |
| `memory` (MB,或 `memoryMiB`, (中文(简体) ), `memoryMb`(中文(简体) ) | `resources.memory` | 圆通至通通GB. |
| `sizeClass` | `resources` | 标准大小 : `md` (2 vCPU / 4 GB) 并 `lg` (4/8) (中文(简体) ). `xs`, (中文(简体) ), `sm`, (中文(简体) ), `xl` 财务报告和审定财务报表 `2xl` 失败 `unsupported`; 组合 `sizeClass` 与 `cpu`编号 :`memory` 是一个 `conflict`。 。 。 . |
| `diskMb` (或 `diskMiB`(中文(简体) ) | `resources.disk` | 圆通至通通GB. |
| `region` | `region` | `us` (违约), `eu` 或者说 `ap-south`。 。 。 . |
| `envs` | `env` | 沙盒的环境变量 . |
| `name`, (中文(简体) ), `metadata` | `name`, (中文(简体) ), `metadata` | 标签在实例中返回. |

## 特征

-   **命令执行** 与 `cwd`, (中文(简体) ), `env` 和背景命令
-   **文件系统** 读取、写入、列表、 mkdir, 存在并删除
-   **端口 URL 服务器**数字 : `getUrl({ port })` 返回一个没有 API 密钥而到达端口的已签名 URL
-   **持久性**:一个沙盒保存其文件并安装了软件包,直到您销毁它

## 限制

-   命令完成后返回输出; 没有流线 .
-   `runCommand`是因为 `timeout` 停止等待结果。 命令本身一直在沙盒里运行.
-   文件系统内容为UTF-8文本,不是任意的二进制. 在远程 shell 的可写文件中, 写入使用绑定的执行请求和唯一模式 0600 中转文件 `TMPDIR` (默认) `/tmp`,然后覆盖到位。 Stage 不需要目的地- 方向写入权限 。 保留了现有的权限和硬链接,并遵循了同义链接. 何时 `flock` 可用(如底模),一个inode锁防止并行 SDK 写到同一个inode 之间互出;锁错误被宣传. 未定义图像 `flock` 回到普通的重定向,所以同时写到同一个inode可以互出. 读者可在两种情况下观察进行中的最后副本。 上传失败使目的地保持不变;在最后发布期间失败可以留下一空或部分文件.
-   使用 GNU 读取 `stat`, (中文(简体) ), `dd` 财务报告和审定财务报表 `base64` 以每个执行器最多 256 KB 传输,低于 512 KB 输出上限,然后跨块边界解码 UTF-8。 支持空文件和同义链接目标. 截断、 错误的块、 读取错误、 短读和检测到文件变化, 而不是返回部分内容 。 读取不是快照: 在传输时避免修改文件 。 完整的字符串仍然保存在客户端记忆中.
-   沙盒没有寿命限制,所以总是打电话 `destroy()` 当你完成.

## 链接

-   [API 文档](https://www.agent37.com/docs)
-   [定价](https://www.agent37.com/pricing)

## 常见问题

### @computesdk/agent37 是什么？

Agent37 为 AI 代理提供 ComputeSDK - Linux sandbox 和 专用核心 VM 的供应商,任何端口都有公共 URL

### 如何安装 @computesdk/agent37？

在项目目录运行 npm install @computesdk/agent37，或使用 pnpm add / yarn add / bun add。

### @computesdk/agent37 支持 TypeScript 吗？

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

### @computesdk/agent37 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @computesdk/agent37 可以商用吗？

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

### @computesdk/agent37 的下载量有多少？

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

### @computesdk/agent37 还在维护吗？

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