在完全托管的云沙箱中运行 AI Agent。
Qoder Cloud Agents 是全托管的 AI Agent 运行平台。你无需自建 agent loop、管理工具执行沙箱或处理长连接——只需通过 API 定义 Agent、启动 Session，即可在云端运行复杂任务并实时接收结果。
成功响应格式：
所有 API 请求需要携带以下 Header：
列表接口统一使用游标分页，响应结构：
使用
Q: Cloud Agents 和 Qoder CLI 可以同时使用吗？
A: 完全可以。CLI 适合本地交互开发，Cloud Agents 适合自动化和集成场景，两者互补。
Q: 一个 Agent 可以同时运行多少个 Session？
A: 没有硬性限制，同一个 Agent 配置可以同时关联多个活跃 Session。
Q: 数据安全如何保障？
A: 每个 Session 运行在隔离的容器沙箱中，Session 之间无法互相访问。环境销毁后数据清除。
核心概念
| 概念 | 说明 | 类比 |
|---|---|---|
| Agent | 可复用的配置模板，定义模型、系统提示词、工具集 | "员工的岗位说明书" |
| Environment | Session 运行的容器环境，包含依赖包和启动配置 | "办公桌和工具箱" |
| Session | 一次具体的对话/任务执行实例 | "一次具体的工作会话" |
| Event | Session 中产生的实时事件流 | "工作进度实时播报" |
工作流程
1
定义 Agent
指定模型、system prompt、可用工具。
2
配置 Environment
选择容器类型、预装依赖和启动脚本。新账号需先
POST /api/v1/cloud/environments 创建环境（无预置默认环境）。3
启动 Session
绑定 Agent + Environment，创建运行实例。
4
发消息 + 收事件
向 Session 发送
user.message，然后通过 SSE 流（或轮询）实时接收 Agent 思考、消息、状态变更等事件。快速验证连通性
适用场景
- 长时间异步任务 — 代码审查、大规模重构、自动化测试生成
- API 集成 — 在后端服务中嵌入 Agent 能力，无需维护运行时
- 批量处理 — 并行启动多个 Session 处理批量请求
- 定时任务 — 结合调度系统，周期性运行 Agent 完成巡检/报告
认证方式
所有 API 请求需要携带以下 Header：
| Header | 值 | 说明 |
|---|---|---|
Authorization | Bearer <PAT 或 SAT> | 个人访问令牌（PAT）或服务账号令牌（SAT） |
个人用户可在 Qoder 控制台「设置 → 个人访问令牌」中创建 PAT。Service Account 需要先创建 SA API Key，再通过 Service Token Exchange 接口置换短期 SAT。详见 认证。
分页机制
列表接口统一使用游标分页，响应结构：
after_id / before_id 查询参数翻页。
常见问题
Q: Cloud Agents 和 Qoder CLI 可以同时使用吗？
A: 完全可以。CLI 适合本地交互开发，Cloud Agents 适合自动化和集成场景，两者互补。
Q: 一个 Agent 可以同时运行多少个 Session？
A: 没有硬性限制，同一个 Agent 配置可以同时关联多个活跃 Session。
Q: 数据安全如何保障？
A: 每个 Session 运行在隔离的容器沙箱中，Session 之间无法互相访问。环境销毁后数据清除。
下一步
- 快速开始 — 5 步跑通第一个 Cloud Agent
- 定义 Agent — 深入了解 Agent 配置
- 云端环境 — 配置运行环境
- 启动 Session — 管理会话生命周期