跳到主要内容

智能体框架与 SDK

Flue

将 Flue 智能体的文件和 Shell 工具指向 E2B 沙箱。E2B 蓝图会在您的代码仓库中添加一个小型适配器,让 bash 在 Firecracker microVM 中运行,而不是在您的主机上。

维护方
Flue
集成方式
通过 flue add 添加的蓝图
软件包
e2b
语言
TypeScript

配置

快速开始

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

粘贴到您的编程智能体中

为这个 Flue 项目添加 E2B 沙箱。

  1. 1.使用项目的包管理器安装 e2b 包。
  2. 2.E2B SDK 读取 E2B_API_KEY 环境变量。如果尚未设置,请向我索要 API 密钥(在 https://console.e2b.dev/?tab=keys 获取),并将其写入 .env。切勿将其硬编码。
  3. 3.按照 https://docs.e2b.dev/agents/flue 上的 Flue 指南操作。应用 npx flue add sandbox e2b --print 输出的蓝图,然后在 useSandbox 的 createSandbox() 中创建沙箱,并用 e2b(sandbox) 包装它。
  4. 4.用 flue run 运行一次智能体,并展示来自沙箱的输出。

或自行配置

  1. 1. 添加 E2B SDK

    npx @flue/cli@latest init . --target node
    npm install
    npm install e2b
  2. 2. 设置 API 密钥

    E2B_API_KEY="e2b_***"
    ANTHROPIC_API_KEY="sk-ant-***"
  3. 3. 添加适配器

    npx flue add sandbox e2b --print | claude
  4. 4. 编写并运行智能体

    'use agent';
    import { useModel, useSandbox } from '@flue/runtime';
    import { Sandbox } from 'e2b';
    import { e2b } from '../sandboxes/e2b.ts';
    
    export function Analyst() {
      useModel('anthropic/claude-sonnet-4-6');
    
      useSandbox({
        async createSandbox(options) {
          const sandbox = await Sandbox.create({
            timeoutMs: 10 * 60_000,
            metadata: { framework: 'flue', agent: 'analyst' },
          });
          return e2b(sandbox).createSandbox(options);
        },
      });
    
      return 'You work in a Linux sandbox. Use bash for anything about the machine or its files.';
    }

安全

沙箱中运行的内容

智能体的文件和 Shell 工具在隔离的沙箱中运行,与您的主机隔离。

  • 工具useSandbox() 提供的 read、write、edit、bash、grep 和 glob,映射到 sandbox.files 和 sandbox.commands。
  • 隔离命令在带有 Debian 工具链的 Firecracker microVM 中运行,而不是作为您主机上的进程。
  • 状态以 options.id 作为沙箱的键,并用 Sandbox.connect() 重新连接,即可为每个对话保留一个工作区。
  • 生命周期默认超时为 5 分钟;可设置 timeoutMs。Flue 从不终止沙箱,因此请自行调用 sandbox.kill()。

已启动 30亿+ 个沙箱

为每个智能体 配一台机器