cloud-agent

name	cloud-agent
description	将任务委托给云端 Agent 执行。云端拥有隔离代码沙箱、项目构建发布到公网、24/7 持续运行等本地不具备的能力。适用于需要沙箱执行、应用发布、不受开机限制的长任务。支持带文件委托。
metadata	{"xiaodazi":{"dependency_level":"cloud_api","os":["common"],"backend_type":"tool","user_facing":true}}

云端 Agent 委托

云端 Agent 是本地的能力扩展。本地优先处理，但当本地不适合或无法完成时，委托云端。

云端与本地的能力边界

云端独有（本地做不到）

• 隔离代码沙箱：Docker 容器内安全执行任意代码（Python/Node/Shell），不影响用户系统
• 项目构建与发布：沙箱内 build 项目 + 打包 Docker 镜像 + 部署到公网 URL，用户可直接访问
• 24/7 持续运行：云端定时任务不受电脑开关机影响，支持 cron/interval/once 三种调度模式
• 云端文件存储：S3/OSS 持久化，生成预签名下载链接

本地独有（云端做不到）

• 桌面 UI 自动化（peekaboo / pywinauto / Claude Computer Use）
• 本地应用控制（打开微信、操作飞书、Apple Mail/Calendar 等）
• 截图 + OCR、剪贴板读写
• 本地文件直接访问（整理桌面、移动文件）

两端都有（不是委托云端的理由）

• 联网搜索：本地有 DuckDuckGo/Brave/Tavily/arXiv/论文搜索，日常搜索本地即可
• 网页内容提取：本地有 Jina Reader、Crawl4AI
• 知识库检索：本地有 FTS5 + 语义搜索 + RAG
• 文件处理：本地可直接读写 PDF/Excel/Word

什么时候委托云端

满足以下任一理由即可委托：

理由 1：持续运行 — 任务可能比本次开机时长更久

每天早上 8 点帮我看科技新闻 true 定时任务，8 点用户可能没开机 周末帮我盯一下 XX 商品有没有降价 true 跨天监控，周末不一定开电脑 花一下午深度调研这个行业，不着急 true 多小时任务，用户可能中途关机 下午 3 点提醒我开会 false 用户正在用电脑，本地提醒更即时可靠

理由 2：沙箱执行 — 需要隔离环境运行代码或构建发布项目

帮我跑一下这段 Python 数据分析脚本 true 需要隔离沙箱环境安全执行代码 做一个生日邀请网页，发链接给朋友 true 沙箱构建项目 + 发布到公网 URL 构建一个贪食蛇网页小游戏 true 需要沙箱构建、运行 dev server、可发布 帮我做个 PPT false 本地有 PPT Skill，无需沙箱

理由 3：深度调研 — 长时间、多轮、不怕关机的深度分析

云端深度调研的优势不在于"能搜索"（本地也能），而在于：

• 不受开机限制，可以跑数小时
• 多轮迭代搜索 + 分析 + 再搜索，自主推进
• 适合产出完整报告、对比分析等重度输出

调研最新的 AI Agent 框架并写对比报告 true 需要多轮搜索 + 长时间分析 + 产出完整报告，用户可能中途关机 帮我分析这三家竞品的功能差异，写一份对比分析 true 需要爬取多个竞品网站 + 长时间深度对比 搜一下明天上海天气 false 简单搜索，本地搜索工具秒级返回 搜一下最新的 AI 论文 false 单次搜索，本地有 arXiv/论文搜索 Skill，即时返回

绝对不要委托云端的场景

帮我整理桌面上的文件 false 纯本地文件操作，云端无法访问本地桌面 打开微信 false 本地应用操作，云端无法控制桌面应用 帮我写一封邮件 false 文本生成是本地基础能力，无需委托 帮我搜一下这个问题 false 本地有多个搜索 Skill（DuckDuckGo/Brave/Tavily），即时返回

使用方式

基本调用：

cloud_agent(task="调研 AI Agent 赛道最新动态并写一份分析报告")

带上下文：

cloud_agent(
    task="基于以下竞品列表做深度调研",
    context="竞品: Manus, Devin, Bolt..."
)

带文件（PDF / Excel / 图片等）：

cloud_agent(
    task="分析这份行业报告并提取关键数据",
    files=[{"file_url": "/path/to/report.pdf", "file_name": "行业报告.pdf", "file_type": "application/pdf"}]
)

本地文件会自动上传到云端后再传给云端 Agent 处理。

执行特性

• 流式输出：云端默认流式返回，执行过程中会实时推送进度（思考中 -> 工具调用 -> 生成文本）
• 执行时间：简单任务 10-30 秒，深度调研 1-3 分钟，沙箱构建项目 2-5 分钟
• 文件支持：可传入 PDF、Excel、CSV、图片等文件，本地文件会自动上传到云端 S3
• 网络依赖：需要网络连接，不可达时工具会返回明确错误提示
• 结果格式：返回纯文本结果，如需生成本地文件（PPT / Excel），应在本地完成