专为 AI 代理打造的云沙盒

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

凭借适用于Python、TypeScript、Golang和Java的 SDK，AgentBay 通过简单的 API 为您的代理提供完整的云环境：执行命令、浏览网页、自动化桌面应用、测试移动 UI 或运行代码——所有这些都在安全且可丢弃的沙盒中完成。

🎯 您可以做什么

🌐 浏览器使用 自动化网页操作，包括内容抓取、测试和工作流。跨浏览器兼容，支持自然语言控制和远程访问。 了解更多 →	🖥️ 计算机使用 面向企业应用自动化的云桌面环境。标准化接口可实现对遗留软件的自动化，并进行智能资源调度。 了解更多 →
📱 移动端使用 基于云的移动环境，用于智能应用自动化。精确的 UI 识别与控制，配合并行任务处理，适用于测试场景。 了解更多 →	💻 代码空间 专业的云开发环境，支持多语言代码生成、编译和调试。提供安全、智能的自动化编程体验。 了解更多 →

✅ 前提条件

在使用 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
     

📦 安装

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>agentbay-sdk</artifactId>
    <version>0.19.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().setImageId("code_latest");
Session session = agentBay.create(params).getSession();

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

agentBay.delete(session, false);

📚 文档

初次使用 AgentBay？ 从快速入门教程开始——5 分钟内即可上手。

🔧 核心功能

🎛️ 会话管理

• 会话生命周期 — 按需创建、管理和删除云沙箱
• 环境配置 — 配置区域、端点和沙箱镜像
• 会话监控 — 监控状态和健康状况

🛠️ 内置模块

• 命令执行 — 在云沙箱中运行 Shell 命令
• 文件操作 — 上传、下载和管理文件
• 上下文与数据持久化 — 在不同会话间保存和检索数据
• Git 操作 — 远程克隆、提交和管理代码仓库

🤖 AI 辅助开发

如果您正在使用 AI 编码助手（Claude、Cursor、GitHub Copilot 等）配合 AgentBay SDK 进行开发，请将以下文件用作上下文：

• llms.txt — 简明概述（约 1.4 万 token，约 55 KB）
• llms-full.txt — 完整 SDK 源码、API 文档和示例（约 21.1 万 token，约 827 KB）

🆘 获取帮助

• GitHub Issues

📞 联系方式

欢迎访问我们的产品官网并加入社区！

• 🌐 AgentBay 国际官网: https://www.alibabacloud.com/product/agentbay
• 🇨🇳 AgentBay 中国官网（中文）: https://www.aliyun.com/product/agentbay
• 💬 Discord 社区: 点击加入 Discord
• 💼 钉钉群: 点击加入

📄 许可证

本项目采用 Apache License 2.0 许可证授权——详情请参阅LICENSE 文件。

wuying-agentbay-sdk 快速上手指南

AgentBay 是专为 AI Agent 打造的云端沙盒服务，提供浏览器、桌面、移动端及代码执行等隔离环境。通过简单的 API，即可在秒级创建按需沙盒，完成任务后自动销毁，无需管理基础设施。

环境准备

在使用 SDK 之前，请确保完成以下准备工作：

1. 注册账号：拥有阿里云账号（https://aliyun.com）。

2. 获取密钥：登录 AgentBay 控制台 获取 API Key。

3. 配置环境变量：将 API Key 设置为环境变量，以便 SDK 自动识别。

   • Linux / MacOS:

     export AGENTBAY_API_KEY=your_api_key_here
     

   • Windows (CMD):

     setx AGENTBAY_API_KEY your_api_key_here
     

   • Windows (PowerShell):

     $env:AGENTBAY_API_KEY="your_api_key_here"
     

安装步骤

根据您的开发语言选择对应的安装命令。国内开发者如遇网络问题，建议配置相应的镜像源加速下载。

Java Maven 依赖配置：

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

基本使用

以下示例展示如何创建一个代码执行沙盒（code_latest），运行一段 Python 代码，并在完成后销毁沙盒。

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().setImageId("code_latest");
Session session = agentBay.create(params).getSession();

// 在沙盒中执行代码
CodeExecutionResult result = session.getCode().runCode("print('Hello AgentBay')", "python");
if (result.isSuccess()) {
    System.out.println(result.getResult());  // 输出：Hello AgentBay
}

// 销毁沙盒
agentBay.delete(session, false);

提示：除了代码执行，AgentBay 还支持浏览器自动化（Browser Use）、桌面应用操作（Computer Use）和移动端测试（Mobile Use）。更多高级用法请参考官方文档中的功能指南。