manus

Manus

Manus 是一个可异步处理复杂任务的自主 AI Agent。它尤其擅长通过并行处理和网页浏览进行深度研究，并生成包含数据可视化内容的综合报告。

何时使用 Manus

• 深度研究 - 市场分析、竞争格局研究、产品比较
• 股票／财务分析 - 公司研究、技术分析、价格图表
• 产品研究 - 跨品牌功能比较、规格分析
• 报告生成 - 创建 Markdown 报告、CSV 文件、图表和可视化内容
• 多来源综合分析 - 从多个网站收集并整合信息
• 长时间运行的任务 - 任何需要 1-10 分钟或更长时间自主处理的任务

研究提示词示例

有效的研究提示词会明确说明范围、来源和期望的输出：

产品比较：

Find the best 4K monitors for Mac with Thunderbolt connectivity and 120Hz+ refresh rate.
Focus on BenQ, Samsung, Dell, LG. Only include models released in the last year.
Compare specs, prices, and Mac-specific features. Output a comparison table.

股票／公司分析：

Analyze [TICKER] stock: company profile, recent performance, technical indicators,
valuation metrics, and insider activity. Include a price chart for the past year.

市场研究：

Research the [industry] market: key players, market size, growth trends,
recent developments, and competitive landscape. Focus on [region/segment].

竞争分析：

Compare [Product A] vs [Product B] vs [Product C]: features, pricing,
user reviews, pros/cons. Create a decision matrix for [use case].

环境设置

需要设置 MANUS_API_KEY 环境变量。基础 URL：https://api.manus.ai

核心工作流

1. 创建任务 → 立即返回 task_id
2. 轮询状态 → 持续检查，直到 status 为 completed 或 failed
3. 返回结果 → 提取输出文本和文件附件

创建任务

curl -s -X POST "https://api.manus.ai/v1/tasks" -H "API_KEY:$MANUS_API_KEY" -H "Content-Type:application/json" -d '{"prompt":"<task description>","agentProfile":"manus-1.6"}'

Agent 配置：

• manus-1.6-lite - 快速处理简单任务（快速查询、简单问题）
• manus-1.6 - 标准配置（默认选项，适合大多数研究）
• manus-1.6-max - 复杂推理（深度研究、多来源分析、详细报告）

响应：

{"task_id":"abc123","task_title":"...","task_url":"https://manus.im/app/abc123"}

检查任务状态

curl -s -X GET "https://api.manus.ai/v1/tasks/{task_id}" -H "API_KEY:$MANUS_API_KEY"

状态值： pending、running、completed、failed

每隔 5-10 秒轮询一次，直到任务完成。

提取文本输出：

curl -s -X GET "https://api.manus.ai/v1/tasks/{task_id}" -H "API_KEY:$MANUS_API_KEY" | jq -r '.output[] | select(.role=="assistant") | .content[] | select(.type=="output_text") | .text'

提取文件附件：

curl -s -X GET "https://api.manus.ai/v1/tasks/{task_id}" -H "API_KEY:$MANUS_API_KEY" | jq -r '.output[] | select(.role=="assistant") | .content[] | select(.type=="output_file") | "\(.fileName): \(.fileUrl)"'

列出任务

curl -s -X GET "https://api.manus.ai/v1/tasks" -H "API_KEY:$MANUS_API_KEY" | jq '.data[] | {id, status, title: .metadata.task_title}'

多轮对话

通过包含 taskId，继续现有任务：

curl -s -X POST "https://api.manus.ai/v1/tasks" -H "API_KEY:$MANUS_API_KEY" -H "Content-Type:application/json" -d '{"prompt":"follow-up question","taskId":"abc123","agentProfile":"manus-1.6"}'

删除任务

curl -s -X DELETE "https://api.manus.ai/v1/tasks/{task_id}" -H "API_KEY:$MANUS_API_KEY"

高级选项

参数	描述
taskMode	chat、adaptive 或 agent
projectId	关联项目以使用共享指令
attachments	文件对象数组（见下文）
connectors	预配置的连接器 ID（Gmail、Calendar、Notion）
createShareableLink	启用公开访问 URL

文件附件

可使用以下三种格式之一附加文件：

URL 附件：

{"prompt":"Analyze this","attachments":[{"type":"url","url":"https://example.com/doc.pdf"}]}

Base64 附件：

{"prompt":"What's in this image?","attachments":[{"type":"base64","data":"<base64>","mime_type":"image/png"}]}

文件 ID（上传后）：

{"prompt":"Review this file","attachments":[{"type":"file","file_id":"file-xxx"}]}

项目

创建包含共享指令的项目：

curl -s -X POST "https://api.manus.ai/v1/projects" -H "API_KEY:$MANUS_API_KEY" -H "Content-Type:application/json" -d '{"name":"My Project","instruction":"Always respond concisely"}'

在任务中使用项目：

curl -s -X POST "https://api.manus.ai/v1/tasks" -H "API_KEY:$MANUS_API_KEY" -H "Content-Type:application/json" -d '{"prompt":"...","projectId":"proj_xxx","agentProfile":"manus-1.6"}'

最佳实践

• 对于简单查询，使用 manus-1.6-lite（速度更快、成本更低）
• 对于研究任务，使用 manus-1.6 或 manus-1.6-max
• 始终提供 task_url，以便用户在浏览器中查看进度
• 以合理的间隔轮询状态（简单任务每隔 5-10 秒，研究任务每隔 15-30 秒）
• 检查 credit_usage 字段以跟踪消耗
• 对于研究任务，请明确说明范围、时间范围、来源和期望的输出格式
• 研究任务通常会生成多个输出文件（报告、CSV 文件、图表）——提取所有附件
• Manus 使用并行处理开展多方面研究——一个提示词即可涵盖多个角度

错误处理

检查是否有失败的任务：

curl -s -X GET "https://api.manus.ai/v1/tasks/{task_id}" -H "API_KEY:$MANUS_API_KEY" | jq '{status, error}'

如果 status 为 failed，则 error 字段会包含失败原因。常见问题：

• API 密钥无效 → 检查是否已设置 MANUS_API_KEY
• 任务超时 → 简化提示词或使用 manus-1.6-max
• 请求频率受限 → 等待后重试

API 参考

完整的端点文档请参阅 references/api.md。