跳到主要内容

编程智能体

Gemini CLI

从预构建的 gemini 模板在沙箱中运行 Google 的 Gemini CLI。为它提供 Gemini API 密钥和一个任务,它就会在沙箱的文件、终端和 git 上工作。

维护方
E2B
集成方式
预构建的 gemini 沙箱模板
软件包
e2b
语言
TypeScript, Python

配置

快速开始

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

粘贴到您的编程智能体中

从这个项目在 E2B 沙箱中运行 Gemini CLI。

  1. 1.使用项目的包管理器安装 e2b SDK。
  2. 2.SDK 需要 E2B_API_KEY 环境变量,Gemini CLI 需要 GEMINI_API_KEY。如果尚未设置 E2B_API_KEY,请向我索要 API 密钥(在 https://console.e2b.dev/?tab=keys 获取)。切勿将任何一个密钥硬编码。
  3. 3.按照 https://docs.e2b.dev/agents/gemini-cli 上的 Gemini CLI 指南操作:从 gemini 模板创建沙箱,在 envs 中传入 GEMINI_API_KEY,并以 0 作为命令超时运行 gemini --skip-trust --yolo -p。完成后终止沙箱。
  4. 4.运行一个任务,并展示来自沙箱的输出。

或自行配置

  1. 1. 安装 E2B SDK

    npm init -y && npm pkg set type=module
    npm install e2b
    npm install -D tsx
  2. 2. 设置 API 密钥

    export E2B_API_KEY="e2b_..."
    export GEMINI_API_KEY="..."
  3. 3. 以 headless 模式运行 Gemini CLI

    import { Sandbox } from 'e2b'
    
    const sandbox = await Sandbox.create('gemini', {
      envs: { GEMINI_API_KEY: process.env.GEMINI_API_KEY! },
      timeoutMs: 600_000,
    })
    
    const result = await sandbox.commands.run(
      `gemini --skip-trust --yolo -p "Create a hello world HTTP server in Python"`,
      { timeoutMs: 0 }
    )
    
    console.log(result.stdout)
    await sandbox.kill()
  4. 4. 处理代码仓库

    await sandbox.commands.run(
      'git clone --depth 1 https://x-access-token:$GITHUB_TOKEN@github.com/<owner>/<repo>.git /home/user/repo',
      { envs: { GITHUB_TOKEN: process.env.GITHUB_TOKEN! } }
    )
    
    await sandbox.commands.run(
      `cd /home/user/repo && gemini --skip-trust --yolo -p "Add error handling to all API endpoints"`,
      { timeoutMs: 0 }
    )
    
    const diff = await sandbox.commands.run('cd /home/user/repo && git diff')
    console.log(diff.stdout)

安全

沙箱中运行的内容

Gemini CLI 及其运行的每条命令都在沙箱中,与您的机器隔离。

  • 智能体gemini 通过 -⁠-⁠yolo 自动批准工具调用,并通过 -⁠-⁠skip-⁠trust 在本次运行中信任工作目录。
  • 文件您克隆的代码仓库,以及 Gemini CLI 做出的每一处更改。用 git diff 读取结果。
  • 会话会话按目录保存在 ~/.gemini 下。-⁠-⁠resume latest 继续最近一次会话。
  • 网络默认可以访问互联网。处理不受信任的输入或密钥时,请用网络规则限制出站流量。

已启动 30亿+ 个沙箱

为每个智能体 配一台机器