@bunny-agent/ sandbox-sandock (英语)

桑多克沙盒适配器 给邦尼特工 运行 AI 代理 山多克 沙发 远程沙盒(而不是当地或通过E2B/Daytona),有持久性的卷,种子文件上传和快速启动的图像.

先决条件

• 节点.js 20+
• Sandock API 密钥 (env:) (中文(简体) ) SANDOCK_API_KEY(中文(简体) )

安装

npm install @bunny-agent/sandbox-sandock

快速启动

import { SandockSandbox } from "@bunny-agent/sandbox-sandock";

const sandbox = new SandockSandbox({
  apiKey: process.env.SANDOCK_API_KEY,
  workdir: "/workspace",
  image: "ghcr.io/vikadata/bunny-agent:latest",
  skipBootstrap: true,
});

密钥选项

用法图案

1. 最小 (预建图像)

new SandockSandbox({
  apiKey: process.env.SANDOCK_API_KEY,
  image: "ghcr.io/vikadata/bunny-agent:latest",
  skipBootstrap: true,
  workdir: "/workspace",
});

2. 持久性量

new SandockSandbox({
  apiKey: process.env.SANDOCK_API_KEY,
  image: "ghcr.io/vikadata/bunny-agent:latest",
  skipBootstrap: true,
  workdir: "/workspace",
  volumes: [
    { volumeName: "my-workspace", volumeMountPath: "/workspace" },
    { volumeName: "my-session", volumeMountPath: "/root/.claude" },
  ],
});

3. 重新使用现有的沙盒

过 sandboxId 重新连接到一个先前创建的沙盒。 适配器只有在沙盒目前安装时才会重新装入 RUNNING 状态。 如果沙盒被停止、暂停或不复存在, attach() 返回到自动创建新的.

const sandbox = new SandockSandbox({
  apiKey: process.env.SANDOCK_API_KEY,
  image: "ghcr.io/vikadata/bunny-agent:latest",
  skipBootstrap: true,
  workdir: "/workspace",
  sandboxId: "cached-sandbox-id", // from your cache
});

const handle = await sandbox.attach();
// Store handle.getSandboxId() for next request

说明: 适配器不尝试启动被停止的沙盒. 仅 RUNNING 沙盒被重新使用。 这避免出乎意料的冷启动延迟,并确保了连贯的附加经验.

对于web app,缓存 sandboxId 服务器侧(例如有 30-min TTL 的 immerry Map),所以之后请求在没有客户端侧状态的情况下再用同个沙盒. 使用 keep: true (默认)使沙盒在请求之间运行.

与 @ bunny- agent/ sdk 联系

import { createBunnyAgent } from "@bunny-agent/sdk";
import { SandockSandbox } from "@bunny-agent/sandbox-sandock";
import { generateText } from "ai";

const bunnyAgent = createBunnyAgent({
  sandbox: new SandockSandbox({
    apiKey: process.env.SANDOCK_API_KEY,
    workdir: "/workspace",
    image: "ghcr.io/vikadata/bunny-agent:latest",
    skipBootstrap: true,
  }),
  env: { ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY! },
});

const { text } = await generateText({
  model: bunnyAgent("sonnet"),
  prompt: "Create a hello world program",
});

安装 : npm install @bunny-agent/sandbox-sandock @bunny-agent/sdk ai

API 密码

桑多克桑德克( Adapter )

• attach() — 创建或再使用沙盒;返回 a SandboxHandle
• getHandle() —— 如果附加, 返回当前控件, 否则 null

沙盒手提箱( 返回于 attach()(中文(简体) )

• getSandboxId() 返回沙盒实例 ID
• getVolumes() - 返回挂载量清单(或 null(中文(简体) )
• getWorkdir() ——返回工作目录
• exec(command, opts) 执行命令和流输出
• upload(files, targetDir) 上传文件到沙盒
• readFile(filePath) 从沙盒读取文件
• destroy() - 停止并删除沙盒

关于跳过Bootstrap

• skipBootstrap: true: 图像已包含 bunny-agent run; 只上传种子文件( 从 templatesPath),无跑道安装. 使用预建的图像 ghcr.io/vikadata/bunny-agent:latest。 。 。 .
• skipBootstrap: false: 在附件上, 运行 npm install @bunny-agent/runner-cli@latest 内 workdir,然后使用 ${workdir}/node_modules/.bin/bunny-agent run 用于执行.

许可证

阿帕奇 - 2.0