AgentRun Sandbox SDK 正式开源！集成 LangChain 等主流框架，一键开启智能体沙箱新体验 - 链载Ai

在大模型与智能体（Agent）技术迅猛发展的今天，开发者不仅需要强大的模型能力，更亟需一个安全、弹性、易用且可扩展的运行环境来承载复杂的 Agent 逻辑。为此，我们正式推出 AgentRun Sandbox SDK 并全面开源！

函数计算 AgentRun^{ingFang SC", Cambria, Cochin, Georgia, Times, "Times New Roman", serif;visibility: visible;">[}^{ingFang SC", Cambria, Cochin, Georgia, Times, "Times New Roman", serif;visibility: visible;">1]}是以高代码为核心、生态开放、灵活组装的一站式 Agentic AI 基础设施平台，致力于为企业级 Agentic 应用提供从开发、部署到运维的全生命周期支持。平台深度构建于阿里云函数计算（Function Compute, FC）之上，天然继承了 Serverless 架构的三大核心优势：极致弹性、按量付费、零运维负担。

更重要的是，函数计算 AgentRun 通过深度集成 AgentScope、LangChain、dify、RAGFlow、Mem0 等主流开源生态，打造了一个高性能、高安全、高可观测的智能体运行底座。平台提供五大核心能力：高性能 Sandbox 执行环境、统一模型代理与高可用保障、全链路可观测性、工具与 MCP（Model Context Protocol）统一管理，以及完善的数据安全与隔离治理机制。这一切，只为让你专注于智能体的业务逻辑本身，而无需被底层基础设施的复杂性所困扰。

函数计算 AgentRun 的核心亮点之一，是其内置的多类型 Sandbox 运行环境，基于阿里云 FC 安全隔离架构构建，确保每一次执行都安全可控：

为降低接入门槛，函数计算AgentRun 特别开源推出基于 Python 语言的 Sandbox SDK，开发者仅需几行配置即可将任意智能体接入沙箱服务。无需修改原有框架逻辑，即可享受 Serverless 架构下的安全、弹性与高性能。

LangChain 是当前最流行的 Agent 编排框架之一。现在，通过 AgentRun Sandbox SDK，你可以零改造地为 LangChain Agent 添加安全可靠的代码执行能力。

安装 AgentRun Sandbox SDK 后，在 LangChain 工具中注册 Code Interpreter 工具，即可让 Agent 自主编写并运行 Python 代码。整个过程无需改动原有项目结构，轻松完成本地调试。

1. 安装 Serverless Devs

运行脚手架，您需要使用 Serverless Devs 工具，请参考对应安装教程^{ingFang SC", Cambria, Cochin, Georgia, Times, "Times New Roman", serif;visibility: visible;">[}^{ingFang SC", Cambria, Cochin, Georgia, Times, "Times New Roman", serif;visibility: visible;">2]}。

2. 初始化脚手架应用

3.配置认证信息

首次使用前，需要登录函数计算AgentRun 控制台^{ingFang SC", Cambria, Cochin, Georgia, Times, "Times New Roman", serif;visibility: visible;">[}^{ingFang SC", Cambria, Cochin, Georgia, Times, "Times New Roman", serif;visibility: visible;">4]}，创建服务关联角色（SLR）。

4. 了解 Agent 如何与 LangChain 集成

使用from agentrun.integration.langchain import model, sandbox_toolset导入 langchain 的集成能力，这里默认提供了model、sandbox_toolset、toolset，可以快速创建 langchain 可识别的大模型、工具。

同时，通过 AgentRunServer 可以快速开放 HTTP Server供其他业务集成。

5.调用 Agent

平台已为你准备好开箱即用的模板应用——“函数求值计算专家”。该智能体能理解用户输入的数学求值问题（如计算sin(x) + x^2的极值），自动生成数值计算代码并在沙箱中执行，最终返回数值计算分析结果。

1. 登录“函数计算 AgentRun”控制台，创建好模型、沙箱等资源

登录阿里云函数计算AgentRun 控制台^{ingFang SC", Cambria, Cochin, Georgia, Times, "Times New Roman", serif;visibility: visible;">[}^{ingFang SC", Cambria, Cochin, Georgia, Times, "Times New Roman", serif;visibility: visible;">5]}，首先创建好模型和代码解释器沙箱资源：

2.进入探索页面，点击“函数求值计算专家”应用，一键部署

进入函数计算AgentRun 探索页面^[^6]，点击“函数求值计算专家”应用，一键部署。

选择刚刚创建好的大语言模型和沙箱资源，点击确认创建，创建此 Agent 应用

3.点击自动生成域名，进入网页体验智能体应用

等待前端后端服务部署完成，点击生成的域名，跳转至智能体应用页面快速体验相关能力。

您也可以在运行时与沙箱 >> Agent 运行时页面，查看您刚刚部署 Agent 应用的详细信息，基于 WebIDE 也可以进行在线调试与二次开发。

跳转到应用 Web 链接，通过对话体验基于代码解释器沙箱的数值计算能力

AgentScope 是由阿里通义实验室推出的开源智能体框架，强调模块化与可组合性。结合函数计算 AgentRun 的 Browser Sandbox，你的 Agent 将具备实时联网、信息检索与交互操作的能力。

通过 AgentRun SDK，只需简单配置即可启用浏览器工具。随后，Agent 即可执行如“访问新浪财经，获取今日腾讯控股股价”等指令，并返回结构化数据。

1.安装 Serverless Devs

运行脚手架，您需要使用 Serverless Devs 工具，请参考对应安装教程。

2.初始化脚手架应用

3.配置认证信息

4.了解 Agent 如何与 AgentScope 集成

使用from agentrun.integration.agentscope import model, sandbox_toolset导入 AgentScope 的集成能力，这里默认提供了model、sandbox_toolset、toolset，可以快速创建 AgentScope 可识别的大模型、工具。

同时，通过 AgentRunServer 可以快速开放 HTTP Server 供其他业务集成。

5.基于 AgentRun Sandbox SDK 进行二次开发

在此版代码示例中，通过开源的 AgentRun Sandbox SDK 对浏览器（Browser）沙箱进行灵活二次开发为 AgentScope 原生工具，针对工具调用的开始前准备阶段，可以通过 SDK 创建沙箱示例或者选择一个正在运行的沙箱；在调用结束后，可以通过 SDK 及时删除沙箱，节省资源消耗。通过 AgentRun Sandbox SDK，可以和代码无缝集成，灵活对沙箱的生命周期进行全流程管理操作。

_browser_sandbox=Nonedefget_browser_sandbox():"""获取或创建browsersandbox"""global_browser_sandboxif_browser_sandboxisNone:try:print(f"正在创建browsersandbox:{SANDBOX_NAME}")_browser_sandbox=Sandbox.create(template_type=TemplateType.BROWSER,template_name=SANDBOX_NAME,sandbox_idle_timeout_seconds=1800,)#等待browser准备就绪（最多尝试15次，每次等待1秒）max_retries=15foriinrange(max_retries):health_status=_browser_sandbox.check_health()ifhealth_status["status"]=="ok":print(f"browsersandbox准备就绪id:{_browser_sandbox.sandbox_id}")breakimporttimetime.sleep(1)else:#超过最大重试次数仍未就绪raiseException(f"browsersandbox在{max_retries}秒内未能准备就绪")exceptExceptionase:print(f"创建browsersandbox失败:{str(e)}")importtracebacktraceback.print_exc()returnNonereturn_browser_sandboxasyncdefbrowser_search(keyword:str,page:int=1,wait_seconds:float=1.5)->ToolResponse:"""使用Bing搜索指定关键词，并查看指定页码的结果，返回搜索结果标题列表Args:keyword:搜索关键词page:页码，从1开始，默认为第1页wait_seconds:等待页面加载的秒数，默认为1.5秒Returns:搜索结果标题列表，每个标题包含文本内容和链接"""try:importasynciofromurllib.parseimportquote#构造Bing搜索URL#first参数：第1页=0,第2页=10,第3页=20，以此类推first=(page-1)*10+1encoded_keyword=quote(keyword)url=f"https://www.bing.com/search?q={encoded_keyword}&first={first}"print(f"[DEBUG]url:{url}")browser=get_browser_sandbox()ifbrowserisNone:returnmake_tool_response("浏览器工具不可用，请透出让用户检查browser是否存在的信息")asyncwithbrowser.async_playwright(record=True)asplaywright:try:#设置导航超时为5秒，并等待页面加载awaitplaywright.goto(url,timeout=5000)#等待页面加载完成ifwait_seconds>0:print(f"等待{wait_seconds}秒以确保页面加载完成")awaitasyncio.sleep(wait_seconds)#获取页面HTML内容html=awaitplaywright.html_content()print(f"[DEBUG]htmllength:{len(html)}")exceptExceptionaspage_error:#捕获页面操作相关的错误error_msg=str(page_error)if"TargetClosedError"inerror_msgor"closed"inerror_msg.lower():returnmake_tool_response("搜索失败:页面在加载过程中被关闭，该网站可能不允许自动化访问")elif"timeout"inerror_msg.lower():returnmake_tool_response(f"搜索失败:页面加载超时（{url}），请稍后重试")else:raise#其他错误继续抛出，由外层捕获#使用工具函数提取搜索结果search_results=extract_bing_search_results(html)ifnotsearch_results:returnmake_tool_response(f"搜索'{keyword}'（第{page}页）完成，但未找到搜索结果")#格式化输出formatted_results=[]fori,resultinenumerate(search_results,1):formatted_results.append(f"{i}.{result['title']}\n链接:{result['link']}")print(f"{i}.{result['title']}\n链接:{result['link']}")result_text="\n\n".join(formatted_results)returnmake_tool_response(f"成功搜索'{keyword}'（第{page}页），找到{len(search_results)}个结果：\n\n{result_text}")exceptExceptionase:importtracebacktraceback.print_exc()returnmake_tool_response(f"搜索失败:{str(e)}")asyncdefbrowser_text_content(url:str,wait_seconds:float=1.5)->ToolResponse:"""访问指定网页并获取其纯文本内容（已过滤HTML标签和脚本）先导航到指定URL，等待页面加载，然后提取页面的可读文本内容。Args:url:要访问的网页URL地址wait_seconds:等待页面加载的秒数，默认为1.5秒（大多数网页足够）返回页面的可读文本内容，已自动过滤：-所有HTML标签-JavaScript代码-CSS样式-HTML注释Returns:页面的纯文本内容注意：-默认等待1.5秒通常足够大多数网页加载-如果内容没有完全加载，可以增加wait_seconds参数重试（如wait_seconds=3.0）-某些网页可能会拦截自动化工具访问，导致无法获取内容-如果遇到访问失败，可以尝试其他来源的链接"""#检查URL是否在黑名单中importasynciotry:browser=get_browser_sandbox()ifbrowserisNone:returnmake_tool_response("浏览器工具不可用，请透出让用户检查browser是否存在的信息")asyncwithbrowser.async_playwright(record=True)asplaywright:try:#先导航到指定URL，设置超时为5秒awaitplaywright.goto(url,timeout=5000)#等待页面加载完成ifwait_seconds>0:awaitasyncio.sleep(wait_seconds)#获取HTML内容html=awaitplaywright.html_content()#使用过滤函数提取纯文本text=filter_html_to_text(html)print(f"{url}:\n{text}\n{'='*100}")#如果文本内容太长，只返回前50000个字符和总长度信息iflen(text)>50000:returnmake_tool_response(f"成功访问{url}\n\n文本内容（前10000字符）:\n{text[:50000]}\n\n...(总长度:{len(text)}字符)")returnmake_tool_response(f"成功访问{url}\n\n文本内容:\n{text}")exceptExceptionaspage_error:#捕获页面操作相关的错误error_msg=str(page_error)if"TargetClosedError"inerror_msgor"closed"inerror_msg.lower():returnmake_tool_response(f"获取网页内容失败:{url}\n错误:页面在加载过程中被关闭\n注意:该网页可能对自动化工具进行了拦截，建议尝试其他来源")elif"timeout"inerror_msg.lower():returnmake_tool_response(f"获取网页内容失败:{url}\n错误:页面加载超时（5秒）\n建议:可以尝试增加wait_seconds参数或尝试其他来源")else:raise#其他错误继续抛出，由外层捕获exceptExceptionase:returnmake_tool_response(f"获取网页内容失败:{url}\n错误:{str(e)}\n注意:该网页可能对自动化工具进行了拦截，建议尝试其他来源")

AgentRun Sandbox SDK 中，集成了 PlayWright，用户可以根据上述代码进行二次开发为相应工具，browser_search()通过必应搜索相关内容。同时，browser_text_content()通过网页抓取，为 Agent 提供更多信息。

此外，get_browser_sandbox()通过 SDK 二次开发，可以灵活管理 Sandbox 的生命周期，包含创建、删除等一站式生命周期管理。

6.调用 Agent

我们基于此能力打造了“金融股票专家”应用：用户输入股票名称或代码，Agent 自动打开财经网站，抓取最新行情、财报摘要与新闻舆情，综合分析后生成投资建议。

1.登录“函数计算 AgentRun”控制台，创建好模型、沙箱等资源

登录阿里云函数计算AgentRun 控制台，首先创建好模型和代码解释器沙箱资源：

2.进入探索页面，点击“股票金融专家”应用，一键部署

进入函数计算AgentRun 探索页面，点击“股票金融专家”应用，一键部署。

选择刚刚创建好的大语言模型和沙箱资源，点击确认创建，创建此 Agent 应用

3.点击自动生成域名，进入网页体验智能体应用

等待前端后端服务部署完成，点击生成的域名，跳转至智能体应用页面快速体验相关能力。

您也可以在运行时与沙箱 >> Agent 运行时页面，查看您刚刚部署 Agent 应用的详细信息，基于 WebIDE 也可以进行在线调试与二次开发。