AgentBay：专为 AI Agent 构建的云沙箱

AgentBay 为 AI Agent 提供按需云沙箱——即包含浏览器、桌面、移动端及代码执行能力的隔离环境。只需几秒钟即可创建沙箱，让你的 Agent 执行任务，并在任务完成后将其销毁。无需管理任何基础设施。

通过支持 Python、TypeScript、Golang 和 Java 的 SDK，AgentBay 能够通过简单的 API 为你的 Agent 提供完整的云端环境：执行命令、浏览网页、自动化桌面应用、测试移动端 UI 或运行代码——所有操作都在安全且可销毁的沙箱中进行。

---

🎯 功能特性

• 🌐 浏览器操作 (Browser Use) 自动化网页操作，包括内容抓取、测试和工作流。支持跨浏览器兼容，具备自然语言控制和远程访问能力。 [了解更多 →]

• 🖥️ 桌面操作 (Computer Use) 用于企业应用自动化的云桌面环境。标准化的接口通过智能资源调度实现传统软件的自动化。 [了解更多 →]

• 📱 移动端操作 (Mobile Use) 用于智能应用自动化的云端移动环境。支持精确的 UI 识别与控制，并能进行并行任务处理以满足测试场景。 [了解更多 →]

• 💻 代码空间 (Code Space) 支持多语言代码生成、编译和调试的专业云开发环境。提供安全、智能的自动化编程体验。 [了解更多 →]

✅ 前置条件

在使用 SDK 之前，你需要：

1. 注册阿里云账号：https://aliyun.com
2. 获取 APIKEY 凭证：AgentBay 控制台
3. 设置环境变量：
   • Linux/MacOS 用户：

     export AGENTBAY_API_KEY=your_api_key_here
     

   • Windows 用户：

     setx AGENTBAY_API_KEY your_api_key_here
     

📦 安装

语言	安装命令	文档
Python	pip install wuying-agentbay-sdk	Python 文档
TypeScript	npm install wuying-agentbay-sdk	TypeScript 文档
Golang	go get github.com/aliyun/wuying-agentbay-sdk/golang/pkg/agentbay	Golang 文档
Java	参见下方 Maven 配置	Java 文档

Java Maven 依赖：

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>agentbay-sdk</artifactId>
    <version>0.20.0</version>
</dependency>

🚀 快速入门

Python

from agentbay import AgentBay, CreateSessionParams

agent_bay = AgentBay()

# 创建一个云沙箱 (选项: "code_latest", "browser_latest", "desktop_latest")
session = agent_bay.create(CreateSessionParams(image_id="code_latest")).session

# 在沙箱中执行代码
result = session.code.run_code("print('Hello AgentBay')", "python")
if result.success:
    print(result.result)  # Hello AgentBay

agent_bay.delete(session)

TypeScript

import { AgentBay } from 'wuying-agentbay-sdk';

const agentBay = new AgentBay();

// 创建一个云沙箱
const session = (await agentBay.create({ imageId: "code_latest" })).session;

// 在沙箱中执行代码
const result = await session.code.runCode("print('Hello AgentBay')", "python");
if (result.success) {
    console.log(result.result);  // Hello AgentBay
}

await agentBay.delete(session);

Golang

import "github.com/aliyun/wuying-agentbay-sdk/golang/pkg/agentbay"

client, _ := agentbay.NewAgentBay("", nil)

// 创建一个云沙箱
result, _ := client.Create(agentbay.NewCreateSessionParams().WithImageId("code_latest"))
session := result.Session

// 在沙箱中执行代码
res, _ := session.Code.RunCode("print('Hello AgentBay')", "python")
fmt.Println(res.Output)  // Hello AgentBay

client.Delete(session, false)

Java

import com.aliyun.agentbay.*;

AgentBay agentBay = new AgentBay();

// 创建一个云沙箱
CreateSessionParams params = new CreateSessionParams();
params.setImageId("code_latest");
Session session = agentBay.create(params).getSession();

// 在沙箱中执行代码
CodeResult result = session.getCode().runCode("print('Hello AgentBay')", "python");
if (result.getSuccess()) {
    System.out.println(result.getResult()); // Hello AgentBay
}

agentBay.delete(session);