功能说明

浏览器操作能力用于在 Agent 沙箱中启动浏览器实例，并通过自动化调试地址完成页面访问和程序化控制。

典型应用场景

• 页面自动化测试：在隔离沙箱中执行页面打开、点击、输入、断言等操作。

• 任务流程编排：在业务流程中通过代码驱动浏览器完成网页访问与信息采集。

• 可视化调试排障：通过控制台的 VNC 调试观察浏览器状态，复现和定位问题。

前提条件

• 已完成 SDK 运行环境与环境变量配置。

• 已在 Agent 沙箱服务控制台创建可用的浏览器沙箱模板，并记录模板 template_id。

• 本地已安装 Python 及 Playwright 依赖，并具备网络访问目标页面的权限。

使用限制

• template 参数必须填写已创建且可用的浏览器沙箱 template_id。

• cdp_url 依赖访问令牌，请妥善保管，避免泄露。

• 浏览器实例的可用时长受沙箱生命周期和配额策略限制。

• 当页面需要额外认证（如登录态、验证码）时，自动化脚本可能需要配套处理逻辑。

操作步骤

步骤一：在控制台创建浏览器沙箱模板并记录 template_id

登录 Agent 沙箱服务控制台创建浏览器沙箱模板，创建完成后记录该模板的 template_id，用于代码中创建实例。

步骤二：运行代码并通过 VNC 监控浏览器

运行下列代码后，在 Agent 沙箱控制台进入对应实例，打开 VNC 调试 查看浏览器实时画面；代码中使用 cdp_url 进行自动化操作。
 

from e2b import Sandbox
from playwright.sync_api import sync_playwright


# 请替换为您在控制台记录的template_id
template_id = "4xxxx3e9-xxxx-xxxx-xxx-f22xxx50xxxx"

# 创建浏览器沙箱实例
sandbox = Sandbox.create(template=template_id)

# 拼接 cdp url，用于通过 Playwright 操作浏览器
cdp_url = f"https://{sandbox.get_host(9223)}"
print("cdp_url:", cdp_url)
with sync_playwright() as playwright:
    # 连接到沙箱浏览器实例
    browser = playwright.chromium.connect_over_cdp(
        cdp_url,
        headers={"X-Access-Token": str(sandbox._envd_access_token)}
    )

    # 获取第一个上下文与页面并访问目标站点
    context = browser.contexts[0]
    page = context.pages[0]
    page.goto("https://www.ctyun.cn")

    # 输出页面标题，确认操作成功
    print("title:", page.title())