You need to enable JavaScript to run this app.
文档中心
函数服务

函数服务

复制全文
下载 pdf
All-in-One Sandbox
一键部署 All-in-One Sandbox 应用
复制全文
下载 pdf
一键部署 All-in-One Sandbox 应用
本文为您介绍如何通过函数服务应用中心一键部署 All-in-One Sandbox 应用。​
背景信息​
  • 应用介绍​
  • All-in-One Sandbox 是一个高度集成的、多功能的云端开发与执行环境。其核心价值在于将一个完整的开发和交互所需的核心工具(浏览器、Shell 终端、文件系统、VSCode 编辑器、Python/node.js 代码执行)封装在单个 Sandbox 中,从而为自动化任务(尤其是 AI Agent)、云端开发和安全代码执行提供了一个开箱即用的标准化环境。​
  • All-in-One Sandbox 解决了传统分离式工具链中环境不一致、文件传输繁琐、组件间交互困难等痛点,实现了真正意义上的一体化和无缝操作。​
  • 运行时​
  • Native 运行时。​
  • 关联云服务​
注意​
关联的云服务会产生相应的使用费用。计费详情,请查看关联云服务对应的计费文档。​
  • 函数服务:通过函数服务创建 Sandbox 实例。​
  • API 网关:通过 API 网关访问 All-in-One Sandbox 中的服务。​
注意事项​
当前仅 华北2(北京)地域支持本功能。​
前提条件​
  • 已创建 Serverless 网关 类型的 API 网关实例,操作详情参见 创建实例。​
  • 首次使用函数服务,需确保已完成跨服务授权。如未授权,控制台会弹出跨服务授权页面引导您进行授权。​
操作步骤 ​
  1. 在顶部导航栏,选择目标地域。​
  1. 在左侧导航栏选择 应用 > 应用广场。​
  1. 在 应用广场,选择 All-in-One Sandbox 模板,单击 创建沙箱应用。​
  1. 在 创建沙箱应用 页面,配置应用参数。​
  • ​
    参数​
    说明​
    基础配置​
    ​
    名称​
    自定义沙箱应用名称。同一账号下沙箱应用名称不可重复。创建成功后名称不支持修改。​
    沙箱镜像​
    ​
    容器镜像​
    默认为您选择最新的 All-in-one 沙箱镜像版本。​
    网关路由配置​
    ​
    域名类型​
    沙箱应用的访问域名类型:​
    • 统一域名:沙箱应用中的所有沙箱实例共享一个访问域名。通过 Header 为x-faas-instance-name,或 Query 为faasInstanceName请求指定沙箱实例。​
    • 泛域名:【邀测·申请试用】通过泛域名为每个沙箱实例提供独立的访问入口。​
    沙箱实例相关说明,请参见 沙箱实例。​
    网关实例​
    选择 API 网关实例。沙箱应用将以 API 网关作为流量入口。​
    网关服务​
    选择 API 网关实例对应的服务。​
    路由名称​
    自定义路由名称。路由名称创建成功后不支持修改。​
    Path​
    设置允许访问沙箱应用的请求路径。仅支持前缀匹配,路径必须以/开头。​
    环境变量​
    ​
    环境变量​
    ​
    自定义配置的环境变量,在函数代码运行时可以直接读取到。​
    说明​
    容器镜像 选择 自定义镜像 时:veFaaS 将自动解析目标镜像配置文件,获取该镜像中的 环境变量 信息。您可以按需修改。​
    高级配置​
    详细的参数说明,请参见 函数配置。​
    ​
  1. 单击 确定,开始创建和部署应用。​
  • 系统将自动跳转至应用详情页面,为您实时展示应用部署日志。​
操作结果​
应用部署成功后,在应用详情页面的 云资源 列表中,单击 API 网关 下的 访问地址,即可进入您的应用交互界面。​
后续操作​
使用 All-in-One Sandbox​
支持通过 API 、SDK 和 MCP 调用 All-in-One Sandbox。​
  • API​
  • SDK​
  • Python SDK 示例如下。​
说明​
代码示例中的 `$URL` 为 Sandbox 的访问入口,地址获取方法参见 访问沙箱实例。​
  • ​
    from agent_sandbox import Sandbox​
    ​
    client = Sandbox(base_url="$URL")​
    ​
    ctx = client.sandbox.get_sandbox_context()​
    print(ctx)​
    ​
    result = client.shell.exec_command(command="ls -la")​
    print(result)​
    ​
  • MCP​
  • MCP 的接口是 /v1/mcp,拼接应用访问地址后的地址即为 MCP 的地址,示例如下。​
  • ​
    {​
    "mcpServers": {​
    "aio-sandbox": {​
    "url": "https://sd2mleni5ni4n75n9****.apigateway-cn-beijing.volceapi.com/v1/mcp"​
    }​
    }​
    }​
    ​
  • ​
相关文档​
通过 API 或 SDK 创建沙箱实例​
除了通过函数服务控制台创建沙箱实例,你还可以通过 API 或 All-in-One SDK 创建沙箱实例。​
  • API ​
  • SDK ​
  • Python All-in-One SDK 示例如下。​
  • ​
    from __future__ import print_function​
    ​
    import os​
    import sys​
    ​
    # Add the parent directory to Python path so we can import agent_sandbox​
    sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))​
    ​
    from agent_sandbox.providers import VolcengineProvider​
    ​
    ​
    def main():​
    """​
    Main function demonstrating Volcengine provider usage.​
    """​
    # Configuration - replace with your actual credentials​
    access_key = os.getenv("VOLC_ACCESSKEY")​
    secret_key = os.getenv("VOLC_SECRETKEY")​
    region = os.getenv("VOLCENGINE_REGION", "cn-beijing")​
    ​
    # Initialize the Volcengine provider​
    provider = VolcengineProvider(​
    access_key=access_key,​
    secret_key=secret_key,​
    region=region​
    )​
    ​
    print("=== Volcengine Sandbox Provider Example ===\n")​
    ​
    function_id = "yatoczqh"​
    ​
    print("1. Creating a sandbox...")​
    sandbox_id = provider.create_sandbox(function_id=function_id)​
    print(f"Create response: {sandbox_id}")​
    ​
    ​
    if __name__ == "__main__":​
    main()​
    ​
​
最近更新时间:2026.02.03 16:03:50
这个页面对您有帮助吗?
有用
有用
无用
无用