云函数 浏览器沙箱应用（内测中）

注意：说明：

一、前置依赖

主账号服务授权（如果你已授权，请跳过该步骤）

你需要为 Serverless Framework、CODING DevOps、云函数创建服务角色并授权。具体操作如下：

在 腾讯云控制台 中，选择云产品 > 云函数，进入 Serverless 控制台，选择 AI 应用 > Agent：

·为预设策略授权：按界面提示，单击“同意授权”：

·为非预设策略授权：

1.1 单击“前往关联”为角色绑定策略。

1.2 进入访问管理 > 角色控制台，单击对应的角色名称 CODING_QCSRole。

1.3 单击关联策略，搜索并选择策略 “QcloudSCFFullAccess”。

1.4 单击确定完成策略绑定。

子账号服务授权（如果你已授权，请跳过该步骤）

1. 创建自定义策略

1.1 登录主账号并进入访问管理控制台。

1.2 在策略页面单击新建自定义策略，选择按策略语法创建。

1.3 选择空白模板，并单击下一步。

1.4 修改策略名称，并将创建 Agent 需要的最小策略内容输入到策略内容框。如下：

·策略名称：例如 scf-agent。

·策略内容：

{ "statement": [ { "action": [ "tcr:DescribeInstances", "tcr:ValidateUserPersonal", "tcr:CreateUserPersonal", "tcr:DescribeRepositoryOwnerPersonal", "tcr:DescribeRepositoryFilterPersonal", "tcr:DescribeImagePersonal", "sls:GetInstance", "sls:ListInstances", "scf:ListFunctions", "scf:ListTriggers", "scf:ListVersionByFunction", "scf:ListAliases", "scf:ListCustomDomains", "scf:GetFunction", "scf:GetAccount", "scf:GetFunctionEventInvokeConfig", "scf:GetFunctionTotalNum", "scf:UpdateFunctionCode", "cam:GetRole", "cam:ListAttachedRolePolicies", "cls:DescribeTopics", "cls:DescribeLogsets", "cfs:DescribeCfsFileSystems", "vpc:DescribeVpcs", "vpc:DescribeSubnets", "coding:*" ], "effect": "allow", "resource": "*" } ], "version": "2.0"}

附：策略的相关 action 说明

2. 给子账号关联对应策略授权

2.1 自定义策略成功后，搜索对应策略，单击关联用户/组/角色。

2.2 勾选目前子账号的用户，单击确定，将子账号关联到对应策略上。

3. 确认策略关联成功

3.1 进入用户列表页面，单击子账号，进入用户详情页。

3.2 确认子账号已经授权 scf-agent 策略。

容器镜像准备

·如果你通过容器镜像部署，你需要先准备好 WebServer 类型的容器镜像，并上传到容器镜像仓库。

1.1 镜像要求：需要搭建 HTTP Server，监听 0.0.0.0:9000 或 *:9000。HTTP Server 需在30秒内启动完毕。如未完成，则可能会导致健康检查超时，出现以下错误：

The request timed out in 30000ms.Please confirm your http server have enabled listening on port 9000.

1.2 上传到镜像仓库：你可以根据实际需求进行镜像仓库选型（详情可参见 容器镜像服务企业版、容器镜像服务个人版）。

·如果你希望通过代码方式部署应用，可以参考 自定义创建 Web 函数，并配置 基于会话并发模式。

二、步骤一：创建浏览器沙箱应用

1. 登录 Serverless 控制台，单击左侧导航栏的 Agent。

2. 在 Serverless AI 运行时页面上的沙箱工具区域，单击创建应用，进入应用创建流程。

3. 在基础配置版块：

3.1 填入应用名称：应用的唯一标识，不可重复，创建后不可修改。

3.2 选择地域：资源必须归属于某个地域。

4. 在环境配置版块：

4.1 选择内存：设置资源类型对应的规格，当前仅支持 CPU 不同内存配置，详情请参见 函数算力支持。

4.2 添加环境变量，在配置中定义的环境变量可在函数运行时从环境中获取到。详情请参见 环境变量。

5. 在网络配置版块，配置函数网络访问权限：

·公网访问：默认未启用，如果需要访问公网资源，则需要启用。

·私有网络：启用后，应用可以访问同一个私有网络下的资源。

6. 在日志配置版块：启用日志投递，可将函数运行日志实时投递到指定位置。详情请参见 日志投递配置。

7. 在隔离、并发配置版块：配置实例安全隔离和单实例并发模式。

7.1 实例安全隔离：

·如果启用，保证一个沙箱独占一个实例，沙箱销毁时，实例也销毁。

·如果不启用，多个沙箱可能共享一个实例。

7.2 配置基于会话单实例并发模式，该配置主要用于标记客户端请求以哪种方式携带沙箱 ID、配置沙箱生命周期、底层实例支持的沙箱并发数和请求，其中本应用中“会话”的配置对应的是“沙箱”的配置。具体配置项说明如下：

8. 单击提交，启动应用的部署。

9. 应用部署完成后，在应用详情页面，可以获得访问地址。如果想从公网访问，建议你配置 自定义域名。

三、步骤二：生成浏览器沙箱实例

1. 应用部署完成后，在应用详情页面，可以获得应用访问地址。

2. 在客户端指定沙箱 ID，生成浏览器沙箱实例：

注意：说明：

注意：请先执行命令 pip install steel-sdk，按照 Steel 依赖，如已安装，请跳过。

from steel import Steeldef create_browser_sandbox(): # 用你的浏览器沙箱应用 URL 替换 {$URL} sandbox_url = "{$应用URL}" # 客户端生成沙箱 ID sandbox_id = "sandbox-id-123456" # 通过指定沙箱 ID x-ssid 生成沙箱 client = Steel(base_url = sandbox_url) session = client.sessions.create( extra_headers={ 'sandbox-id': sandbox_id } ) ws_url = session.websocketUrl print(f"✅ Browser Sandbox created: {sandbox_id}") print(f" WebSocket地址: {ws_url}") if __name__ == "__main__": create_browser_sandbox()

返回结果如下：

✅ 浏览器沙箱已创建: sandbox-id-123456 WebSocket地址: ws://******.ap-******.tencentscf.com/

四、通过 Playwright 使用浏览器

以下完整示例演示如何在浏览器中访问腾讯云：

前置依赖：参考步骤一创建浏览器沙箱，该沙箱的会话配置如下（你也可以改成其他方式，代码需要对应修改）：

·会话 Key 来源：HTTP Header

·会话 Key 名称：sandbox-id

from steel import Steelfrom playwright.sync_api import sync_playwrightimport timedef playwright_demo(): # 创建浏览器沙箱实例 # 用你的浏览器沙箱应用 URL 替换 sandbox_url = "https://******.ap-hongkong.tencentscf.com" # 客户端生成沙箱 ID sandbox_id = "sandbox-id-12345678" client = Steel(base_url = sandbox_url) session = client.sessions.create( extra_headers={ 'sandbox-id': sandbox_id } ) ws_url = session.websocketUrl print(f"✅ 浏览器沙箱已创建: {sandbox_id}") print(f" WebSocket地址: {ws_url}") # 完成浏览器沙箱实例创建 # 启动 playwright playwright = sync_playwright().start() browser = playwright.chromium.connect_over_cdp(ws_url, headers={ 'sandbox-id': sandbox_id }) print("✅ 连接到浏览器") # 创建一个新的页面 context = browser.contexts[0] page = context.new_page() # 访问腾讯云 page.goto("https://cloud.tencent.com/") print(f"✅ 访问腾讯云：{page.url}") # 获取页面标题 print(f" 页面标题: {page.title()}") # 关闭浏览器连接 browser.close()if __name__ == "__main__": playwright_demo()

返回结果如下：

✅ 浏览器沙箱已创建: sandbox-id-12345678 WebSocket地址: ws://******.ap-******.tencentscf.com/✅ 连接到浏览器✅ 访问腾讯云：https://cloud.tencent.com/ 页面标题: 腾讯云 产业智变·云启未来 – 腾讯

五、通过 Puppeteer 使用浏览器

以下完整示例演示如何在浏览器中访问腾讯云：

前置依赖：参考步骤一创建浏览器沙箱，该沙箱的会话配置如下：

·会话 Key 来源：Query String

·会话 Key 名称：sandboxId

import asynciofrom pyppeteer import connectfrom steel._client import Steelsandbox_url = '******.ap-hongkong.tencentscf.com'sandbox_id = 'd45ea6f6-c5b2-47b5-9a42-4237d8647945'async def puppeteer_demo(): # 浏览器沙箱 初始化 client = Steel(base_url=f'http://{sandbox_url}', default_query={'sandboxId':sandbox_id}) session = client.sessions.create( extra_query={ 'sandboxId': sandbox_id } ) cdp_url = f'{session.websocketUrl}?sandboxId={sandbox_id}' print(f"✅ 浏览器沙箱已创建: {sandbox_id}") print(f" CDP 地址: {cdp_url}") # 完成浏览器沙箱实例创建 try: browser = await connect({ 'browserWSEndpoint': cdp_url, 'defaultViewport': None }) print('✅ 通过 CDP 连接到浏览器') page = await browser.newPage() await page.goto('https://cloud.tencent.com/') print(f"✅ 访问腾讯云：{page.url}") print(f" 页面标题: {await page.title()}") await browser.close() except Exception as error: print('Error:', str(error))if __name__ == "__main__": asyncio.run(puppeteer_demo())

返回结果如下：

✅ 浏览器沙箱已创建: d45ea6f6-c5b2-47b5-9a42-4237d8647945 CDP 地址: ws://******.ap-hongkong.tencentscf.com/?sandboxId=d45ea6f6-c5b2-47b5-9a42-4237d8647945✅ 通过 CDP 连接到浏览器✅ 访问腾讯云：https://cloud.tencent.com/ 页面标题: 腾讯云 产业智变·云启未来 – 腾讯

六、在 browser-use agent 集成浏览器沙箱工具

以下完整示例演示如何在 browser-use agent 集成浏览器沙箱，查询天气信息：

前置依赖：参考步骤一创建浏览器沙箱，该沙箱的会话配置如下：

·会话 Key 来源：Query String

·会话 Key 名称：sandboxId

from browser_use import Agent, BrowserSessionfrom browser_use.llm import ChatDeepSeekfrom steel._client import Steelfrom dotenv import load_dotenvimport asyncioimport os# 读取 DEEPSEEK_API_KEY 配置load_dotenv()# 浏览器沙箱配置sandbox_url = '******.ap-hongkong.tencentscf.com'sandbox_id = 'd43ea6f6-c5b2-47b5-9a42-4237d8647945'cdp_url = f'ws://{sandbox_url}?sandboxId={sandbox_id}'# 模型服务配置deepseek_api_key = os.getenv('DEEPSEEK_API_KEY')async def main(): # 模型服务 初始化 llm = ChatDeepSeek( base_url='https://api.deepseek.com/v1', model='deepseek-chat', api_key=deepseek_api_key, ) # 浏览器沙箱 初始化 client = Steel(base_url=f'http://{sandbox_url}', default_query={'sandboxId':sandbox_id}) session = client.sessions.create(session_id=sandbox_id) browser_session = BrowserSession(cdp_url=cdp_url) # 任务 task = "打开百度，查询深圳天气" # Agent 初始化 agent = Agent(task=task, llm=llm, browser_session=browser_session) # 执行任务 await agent.run()if __name__ == "__main__": asyncio.run(main())

返回结果如下：

INFO [service] Using anonymized telemetry, see https://docs.browser-use.com/development/telemetry.WARNING [Agent] ⚠️ DeepSeek models do not support use_vision=True yet. Setting use_vision=False for now…INFO [Agent] Task: 打开百度，查询深圳天气INFO [Agent] Newer version available: 0.9.0 (current: 0.8.1). Upgrade with: uv add browser-use@0.9.0INFO [Agent] Starting a browser-use agent with version 0.8.1, with provider=deepseek and model=deepseek-chatINFO [Agent] INFO [Agent] Step 1:INFO [Agent] ❔ Eval: No previous action to evaluate – this is the first step.INFO [Agent] Memory: Starting fresh browser session. Need to navigate to Baidu and search for Shenzhen weather information.INFO [Agent] Next goal: Navigate to Baidu's homepage to begin the search process.INFO [Agent] ▶️ navigate: url: https://www.baidu.com, new_tab: FalseINFO [tools] Navigated to https://www.baidu.comINFO [Agent] INFO [Agent] Step 2:INFO [Agent] Eval: Successfully navigated to Baidu's homepage as the first step.INFO [Agent] Memory: Currently on Baidu homepage, ready to search for Shenzhen weather information.INFO [Agent] Next goal: Input '深圳天气' into the search box and click search to get weather information.INFO [Agent] ▶️ [1/2] input: index: 16, text: 深圳天气, clear: TrueINFO [BrowserSession] ⌨️ Typed "深圳天气" into element with index 16INFO [Agent] ▶️ [2/2] click: index: 41INFO [tools] ️ Clicked elementINFO [Agent] INFO [Agent] Step 3:INFO [Agent] Eval: Successfully searched for Shenzhen weather on Baidu and obtained comprehensive weather information.INFO [Agent] Memory: Successfully completed the user request by navigating to Baidu, searching for '深圳天气', and retrieving detailed weather information including current conditions (19-24°C, cloudy), wind conditions, air quality, and extended forecasts.INFO [Agent] Next goal: Present the weather information to the user and complete the task.INFO [Agent] ▶️ done: text: 已成功在百度查询深圳天气信息：**当前天气状况（14:35更新）**- 地点：深圳- 天气：多云- 温度：19~24°C- 风力：东北风3级- 空气质量：38 优**今日预报**- 当前温度：19°C- 天气状况：多云- 体感温度：24°C（人体感觉较为舒适）- 湿度：56…, success: True, files_to_display: []INFO [Agent] Final Result: 已成功在百度查询深圳天气信息：**当前天气状况（14:35更新）**- 地点：深圳- 天气：多云- 温度：19~24°C- 风力：东北风3级- 空气质量：38 优**今日预报**- 当前温度：19°C- 天气状况：多云- 体感温度：24°C（人体感觉较为舒适）- 湿度：56%- 紫外线指数：偏弱- 降水量：0.0毫米**生活气象指数**- 穿衣：外套类（舒适）- 感冒：少发（无需特别防护）- 洗车：较适宜（未来一天无雨）- 化妆：控油（露质面霜打底）**日出日落时间**- 日出：06:24- 日落：17:52已成功完成在百度查询深圳天气的任务。INFO [Agent] ✅ Task completed successfully

七、社区完整 API 说明

社区完整 API 列表请查阅 Steel API 文档，使用 API 时，需要将 endpoint 替换成应用的访问地址，并根据你指定方式（会话 Key 来源、会话 Key 名称）携带上沙箱 ID。

如果通过 SDK 调用，需要先安装 steel-sdk ，支持 Node 和 Python：

·Node：使用时需要将访问地址 baseURL 替换为应用的 URL。SDK 使用详见 Node SDK 指引。

·Python：使用时需要将访问地址 base_url 替换为应用的 URL。SDK 使用详见 Python SDK 指引。