跳到主要内容

编程智能体

OpenHands

在 E2B 沙箱中运行 OpenHands Agent Canvas,并在浏览器中打开它的 Web 界面。智能体的 Shell 命令、文件编辑和网页浏览都留在沙箱中。

维护方
E2B
集成方式
预构建的 openhands 模板
模板
openhands
语言
TypeScript, Python

配置

快速开始

将提示词粘贴到您的编程智能体中,或按以下步骤自行配置。

粘贴到您的编程智能体中

在本项目中于 E2B 沙箱内运行 OpenHands。

  1. 1.使用项目的包管理器安装 e2b 包。
  2. 2.SDK 需要 E2B_API_KEY 环境变量。如果尚未设置,请向我索要 API 密钥(在 https://console.e2b.dev/?tab=keys 获取)。切勿将其硬编码。为沙箱另外生成一个 AGENT_CANVAS_API_KEY,并且切勿将其打印出来。
  3. 3.按照 https://docs.e2b.dev/agents/openhands 上的 OpenHands 指南:从 openhands 模板创建一个超时时暂停的沙箱,在后台启动 agent-canvas --public,并等待 8000 端口上的 /health 就绪。
  4. 4.运行一次,并展示沙箱返回的 Agent Canvas URL。

或自行配置

  1. 1. 安装 E2B SDK

    npm i e2b
  2. 2. 设置密钥

    export E2B_API_KEY="e2b_..."
    export AGENT_CANVAS_API_KEY=$(openssl rand -base64 32)
  3. 3. 在沙箱中启动 Agent Canvas

    import { Sandbox } from 'e2b'
    
    const apiKey = process.env.AGENT_CANVAS_API_KEY!
    
    const sandbox = await Sandbox.create('openhands', {
      timeoutMs: 60 * 60 * 1000,
      lifecycle: { onTimeout: 'pause', autoResume: true },
    })
    
    const canvas = await sandbox.commands.run(
      'agent-canvas --public > /tmp/agent-canvas.log 2>&1',
      {
        background: true,
        timeoutMs: 0,
        envs: { LOCAL_BACKEND_API_KEY: apiKey },
      }
    )
    await canvas.disconnect()
  4. 4. 打开 Web 界面

    const url = `https://${sandbox.getHost(8000)}`
    while (!(await fetch(`${url}/health`).then((r) => r.ok, () => false))) {
      await new Promise((resolve) => setTimeout(resolve, 2000))
    }
    
    console.log(`Agent Canvas: ${url}`)

安全

沙箱中运行的内容

Agent Canvas 以及智能体的所有操作都在沙箱中运行,与您的机器隔离。

  • 代码预装了 Agent Canvas、OpenHands Agent Server 和 Chromium。智能体在其中运行 Shell 命令、编辑文件并浏览网页。
  • 状态对话、设置和工作区保存在沙箱的 /home/user/.openhands 下。日志写入 /tmp/agent-canvas.log。
  • 生命周期设置 onTimeout: 'pause' 和 autoResume 后,沙箱会在超时时暂停,并在下一次请求其 URL 时恢复。
  • 访问权限公开模式会要求输入您的 Agent Canvas API 密钥,因此只有您分享了密钥的人才能使用该智能体。

已启动 30亿+ 个沙箱

为每个智能体 配一台机器