云端 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：持续运行 — 任务可能比本次开机时长更久

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

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

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

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

绝对不要委托云端的场景

使用方式

基本调用：

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），应在本地完成