浏览器操作(1) 功能说明 浏览器操作能力用于在 Agent 沙箱中启动浏览器实例,并通过自动化调试地址完成页面访问和程序化控制。 典型应用场景 页面自动化测试:在隔离沙箱中执行页面打开、点击、输入、断言等操作。 任务流程编排:在业务流程中通过代码驱动浏览器完成网页访问与信息采集。 可视化调试排障:通过控制台的 VNC 调试观察浏览器状态,复现和定位问题。 前提条件 已完成 SDK 运行环境与环境变量配置。 已在 Agent 沙箱服务控制台创建可用的浏览器沙箱模板,并记录模板 templateid。 本地已安装 Python 及 Playwright 依赖,并具备网络访问目标页面的权限。 使用限制 template 参数必须填写已创建且可用的浏览器沙箱 templateid。 cdpurl 依赖访问令牌,请妥善保管,避免泄露。 浏览器实例的可用时长受沙箱生命周期和配额策略限制。 当页面需要额外认证(如登录态、验证码)时,自动化脚本可能需要配套处理逻辑。 操作步骤 步骤一:在控制台创建浏览器沙箱模板并记录 templateid 登录 Agent 沙箱服务控制台创建浏览器沙箱模板,创建完成后记录该模板的 templateid,用于代码中创建实例。 步骤二:运行代码并通过 VNC 监控浏览器 运行下列代码后,在 Agent 沙箱控制台进入对应实例,打开 VNC 调试 查看浏览器实时画面;代码中使用 cdpurl 进行自动化操作。 python from e2b import Sandbox from playwright.syncapi import syncplaywright 请替换为您在控制台记录的templateid templateid "4xxxx3e9xxxxxxxxxxxf22xxx50xxxx" 创建浏览器沙箱实例 sandbox Sandbox.create(templatetemplateid) 拼接 cdp url,用于通过 Playwright 操作浏览器 cdpurl f" print("cdpurl:", cdpurl) with syncplaywright() as playwright: 连接到沙箱浏览器实例 browser playwright.chromium.connectovercdp( cdpurl, headers{"XAccessToken": str(sandbox.envdaccesstoken)} ) 获取第一个上下文与页面并访问目标站点 context browser.contexts[0] page context.pages[0] page.goto(" 输出页面标题,确认操作成功 print("title:", page.title())
来自: