任务系统

概述

任务系统允许用户向 Manus 提交 AI Agent 任务并实时跟踪进度。

任务生命周期

Created → Queued → Processing → Completed
                            ↘ Failed

状态定义

状态	描述
`created`	任务已提交，等待进入队列
`queued`	在队列中，等待处理
`processing`	AI Agent 正在处理任务
`completed`	任务成功完成
`failed`	任务遇到错误

创建任务

通过 API

// POST /api/manus/tasks/create
const response = await fetch('/api/manus/tasks/create', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    prompt: '你的任务描述',
    type: 'general',
    priority: 'normal',
  }),
});

const { success, task } = await response.json();

任务类型

类型	描述	积分
`general`	通用任务	1
`research`	研究分析	2
`coding`	代码生成	3
`creative`	创意内容	2

任务结构

interface ManusTask {
  id: string;
  user_id: string;
  account_id: string;
  prompt: string;
  type: string;
  status: TaskStatus;
  priority: 'low' | 'normal' | 'high';
  credits_used: number;
  result: object | null;
  error: string | null;
  started_at: Date | null;
  completed_at: Date | null;
  created_at: Date;
}

查看任务

任务列表

在 /manus/tasks 访问你的任务：

按状态、类型或日期筛选
按创建时间或优先级排序
查看任务详情和结果

任务历史

在 /manus/tasks/history 查看已完成的任务：

完整的任务执行日志
结果下载选项
积分消耗历史

实时更新

任务支持实时状态更新：

// 订阅任务更新
const eventSource = new EventSource(`/api/manus/tasks/${taskId}/stream`);

eventSource.onmessage = (event) => {
  const update = JSON.parse(event.data);
  console.log('任务更新:', update);
};

错误处理

常见错误

错误	原因	解决方案
`insufficient_credits`	积分不足	购买更多积分
`account_unavailable`	没有绑定账号	领取或绑定账号
`rate_limited`	请求过多	等待后重试
`invalid_prompt`	输入为空或无效	检查提示词格式

重试逻辑

失败的任务可以重试：

// POST /api/manus/tasks/{id}/retry
const response = await fetch(`/api/manus/tasks/${taskId}/retry`, {
  method: 'POST',
});

最佳实践

清晰的提示词：编写具体、详细的提示词
监控积分：提交前跟踪积分使用情况
处理错误：实现适当的错误处理
使用优先级：设置适当的优先级级别
检查状态：使用轮询或流式更新获取状态

任务系统

On this page