核心用法
Manus 技能通过 REST API 与 Manus 自主 AI 代理交互，实现自动化任务执行。主要功能包括：
任务创建与管理
- 使用
POST /v1/tasks创建任务，支持三种模式：chat（对话）、adaptive（自适应）、agent（完全自主） - 三种 Agent 配置：
manus-1.6（标准）、manus-1.6-lite（轻量快速）、manus-1.6-max（深度复杂任务） - 支持多轮对话（通过
taskId延续任务）和交互模式（interactiveMode允许追问澄清）
文件与项目管理
- 附件支持：已上传文件 ID、URL 链接、Base64 编码数据三种方式
- 独立文件上传接口
POST /v1/files，返回file_id供任务引用 - 项目（Project）机制：创建共享指令的项目，关联多任务保持上下文一致性
第三方集成
- Connectors：预配置 OAuth 后可访问 Gmail、Google Calendar、Notion 等应用
- Webhooks：任务完成时自动回调指定端点，推送状态和输出文件信息
工作流建议
1. 创建任务时启用 createShareableLink 和 taskMode: "agent"
2. 轮询 GET /v1/tasks/{task_id} 监控状态（pending → running → completed/failed）
3. 从响应 output 数组中获取 fileUrl 直接下载文件
4. 复杂任务通常需 2-10 分钟以上完成
显著优点
- 真正自主性：不同于简单 LLM 调用，Manus 拥有虚拟计算机环境，可主动浏览网页、安装软件、执行多步骤操作
- 完整交付物：输出为可直接使用的文件（PDF、代码、文档等），非纯文本回复
- 企业级组织：项目和连接器机制支持复杂业务场景的多任务协调和第三方系统集成
- 安全隔离：明确设计为
disable-model-invocation: true，防止 AI 自主触发，需用户显式授权每次任务
潜在缺点与局限性
- 执行时间不可控：复杂任务可能耗时 10 分钟以上，需异步轮询处理
- 成本不透明：Manus 为商业服务，API 调用按任务复杂度计费，无实时用量反馈
- 黑盒执行：代理内部操作过程不可见，仅能通过最终输出和分享链接查看结果
- 网络依赖重：所有执行发生在 Manus 云端，无法本地离线运行
- 连接器配置门槛：访问 Gmail/Calendar/Notion 需预先在 manus.im 完成 OAuth 授权流程
适合人群
- 需要自动化复杂研究、数据分析、内容生成的知识工作者
- 希望将 AI 执行与现有工作流（通过 Webhook/文件下载）集成的开发者
- 愿意用时间换深度，接受异步执行以获取更高质量完整交付物的用户
常规风险
- API 密钥泄露：
MANUS_API_KEY需妥善保管，泄露可能导致账户被滥用 - 数据隐私：任务提示和附件上传至 Manus 云端处理，敏感信息需谨慎评估
- 输出质量波动：自主代理行为具有一定随机性，相同提示可能产生差异结果
- 服务可用性：依赖 Manus 平台稳定性，存在第三方服务中断风险
- 计费失控：长时复杂任务可能产生意外费用，建议设置预算监控