跳到主要内容

智能体平台

Claude Managed Agents

Claude 负责运行智能体循环,工具调用则在您自己的沙箱中运行。E2B 上的 webhook 路由器为每个会话分配一个独立的工作沙箱。

维护方
E2B
集成方式
通过 webhook 自托管的环境
模板
E2B/claude-managed-agents-webhooks
软件包
e2b + anthropic
语言
Python, TypeScript

配置

快速开始

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

粘贴到您的编程智能体中

为此 Claude Managed Agents 项目添加 E2B 沙箱。

  1. 1.使用项目的包管理器安装 e2b 和 Anthropic SDK(Python 用 anthropic,TypeScript 用 @anthropic-ai/sdk)。
  2. 2.代码需要 E2B_API_KEY 环境变量。如果尚未设置,请向我索要 API 密钥(在 https://console.e2b.dev/?tab=keys 获取)。切勿将其硬编码。以同样的方式向我索要 Claude Console 中的 ANTHROPIC_API_KEY、ANTHROPIC_ENVIRONMENT_ID、ANTHROPIC_ENVIRONMENT_KEY 和 ANTHROPIC_AGENT_ID。
  3. 3.按照 https://docs.e2b.dev/agents/claude-managed-agents 上的 Claude Managed Agents 指南操作:以 auto-resume 启动 E2B/claude-managed-agents-webhooks 模板,写入它的配置,并打印 webhook URL。让我在 Claude Console 中为 session.status_run_started 注册该 URL,然后将签名密钥(ANTHROPIC_WEBHOOK_SIGNING_KEY)写入同一个沙箱。
  4. 4.创建一个会话,发送一条会运行 Shell 命令的消息,并展示 Claude 的回答和沙箱中的工作进程日志。

或自行配置

  1. 1. 安装 SDK

    pip install e2b anthropic
  2. 2. 设置密钥

    export E2B_API_KEY="e2b_..."
    export ANTHROPIC_API_KEY="..."
    export ANTHROPIC_ENVIRONMENT_ID="..."
    export ANTHROPIC_ENVIRONMENT_KEY="..."
    export ANTHROPIC_AGENT_ID="..."
    # after you register the webhook in step 4
    export ANTHROPIC_WEBHOOK_SIGNING_KEY="..."
  3. 3. 启动 webhook 沙箱

    import os
    from e2b import Sandbox
    
    sandbox = Sandbox.create(
        "E2B/claude-managed-agents-webhooks",
        lifecycle={"on_timeout": "pause", "auto_resume": True},
    )
    
    config = "/opt/anthropic-managed-agents-js/config"
    sandbox.files.write(f"{config}/e2b-api-key", f"{os.environ['E2B_API_KEY']}\n")
    sandbox.files.write(f"{config}/anthropic-api-key", f"{os.environ['ANTHROPIC_API_KEY']}\n")
    sandbox.files.write(f"{config}/anthropic-environment-id", f"{os.environ['ANTHROPIC_ENVIRONMENT_ID']}\n")
    sandbox.files.write(f"{config}/anthropic-environment-key", f"{os.environ['ANTHROPIC_ENVIRONMENT_KEY']}\n")
    
    print(f"Webhook URL: https://{sandbox.get_host(8000)}/webhook")
  4. 4. 注册 webhook,然后启动会话

    from anthropic import Anthropic as Claude
    
    sandbox.files.write(
        "/opt/anthropic-managed-agents-js/config/anthropic-webhook-signing-key",
        f"{os.environ['ANTHROPIC_WEBHOOK_SIGNING_KEY']}\n",
    )
    
    client = Claude(api_key=os.environ["ANTHROPIC_API_KEY"])
    
    session = client.beta.sessions.create(
        agent=os.environ["ANTHROPIC_AGENT_ID"],
        environment_id=os.environ["ANTHROPIC_ENVIRONMENT_ID"],
        title="E2B webhook smoke",
    )
    
    client.beta.sessions.events.send(
        session.id,
        events=[{
            "type": "user.message",
            "content": [{
                "type": "text",
                "text": "Use bash to echo webhook-smoke-ok. Answer only with that text.",
            }],
        }],
    )

安全

沙箱中运行的内容

由 Claude 决定做什么。文件系统、工具、网络和日志都位于您自己的 E2B 沙箱中。

  • 工具每次工具调用都在工作沙箱中运行,工作目录为 /mnt/session。Claude 的推理循环不在沙箱中。
  • 状态每个会话都有自己的工作沙箱。后续轮次会重新连接它,并复用同一份 /mnt/session 文件。
  • 生命周期路由器以 auto-resume 和超时暂停启动工作沙箱,空闲会话会暂停,而不会丢失状态。
  • 路由webhook 沙箱用您的签名密钥验证 Claude 的 webhook,并保存会话与沙箱的对应关系。

已启动 30亿+ 个沙箱

为每个智能体 配一台机器