跳到主要内容

智能体框架与 SDK

OpenAI Agents SDK

在 E2B 中运行 OpenAI Agents SDK 沙箱智能体。SDK 内置的 E2BSandboxClient 在隔离的沙箱中为每个 SandboxAgent 提供文件系统、终端和网络。

维护方
OpenAI
集成方式
内置于 openai-agents
软件包
openai-agents[e2b]
语言
Python

配置

快速开始

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

粘贴到您的编程智能体中

为此 OpenAI Agents SDK 项目添加 E2B 沙箱。

  1. 1.使用项目的包管理器安装带 e2b 扩展的 Agents SDK("openai-agents[e2b]")。
  2. 2.沙箱客户端需要 E2B_API_KEY 环境变量。如果尚未设置,请向我索要 API 密钥(在 https://console.e2b.dev/?tab=keys 获取)。切勿将其硬编码。
  3. 3.按照 https://docs.e2b.dev/agents/openai-agents-sdk 上的 OpenAI Agents SDK 指南操作。用 E2BSandboxClient 创建会话,通过 RunConfig(sandbox=SandboxRunConfig(session=session)) 在其上运行 SandboxAgent,并在 finally 块中关闭会话。
  4. 4.运行一次智能体,并展示来自沙箱的输出。

或自行配置

  1. 1. 安装带 E2B 扩展的 SDK

    pip install openai-agents[e2b]
  2. 2. 设置 API 密钥

    export OPENAI_API_KEY="..."
    export E2B_API_KEY="..."
  3. 3. 创建沙箱会话

    from agents.extensions.sandbox import (
        E2BSandboxClient,
        E2BSandboxClientOptions,
        E2BSandboxType,
    )
    
    client = E2BSandboxClient()
    session = await client.create(
        options=E2BSandboxClientOptions(
            sandbox_type=E2BSandboxType.E2B,
            timeout=900,
            pause_on_exit=True,
        )
    )
  4. 4. 在其中运行 SandboxAgent

    from agents import ModelSettings, Runner
    from agents.run import RunConfig
    from agents.sandbox import SandboxAgent, SandboxRunConfig
    
    agent = SandboxAgent(
        name="Workspace Inspector",
        model="gpt-5.4",
        instructions="Inspect the workspace, explain what files exist, and summarize the project.",
        model_settings=ModelSettings(tool_choice="required"),
    )
    
    try:
        result = await Runner.run(
            agent,
            "Look around the workspace and summarize what you find.",
            run_config=RunConfig(sandbox=SandboxRunConfig(session=session)),
        )
        print(result.final_output)
    finally:
        await session.shutdown()

安全

沙箱中运行的内容

每个 SandboxAgent 都在独立的隔离沙箱中工作,与运行 SDK 的机器隔离。

  • 代码SandboxAgent 发出的命令和文件读写,在 E2B 会话中执行。
  • 工作区用 Manifest 为沙箱预置初始文件,并暴露端口以获取实时预览 URL。
  • 生命周期timeout 限定会话时长。pause_on_exit=True 会保留沙箱以便检查;session.shutdown() 会将其释放。
  • MCP创建会话时传入 MCP 服务器配置,智能体即可通过沙箱的 MCP 网关访问它们。

已启动 30亿+ 个沙箱

为每个智能体 配一台机器