跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.profy.cn/llms.txt

Use this file to discover all available pages before exploring further.

​
任务调度

Profy 的任务系统是连接用户需求和 AI Agent 能力的核心调度层。用户从市场选择应用、填写参数、提交任务，系统自动分发给 Agent 执行，用户付费后查看完整结果。

​
概述

​
任务生命周期

​
状态说明

状态标识说明
已创建created任务已创建，等待用户填写参数
已提交submitted参数已提交，等待 Agent 调度
执行中processingAgent 正在处理任务
已完成completedAgent 执行完成，结果预览可见
已支付paid用户已付费，完整结果可见
失败failed执行失败，可重新提交

​
核心流程

​
创建任务

用户在市场选择应用后，创建关联该应用的任务。 
// POST /api/task/create
{
  "appUuid": "app-xxxxx",
  "title": "我的翻译任务"
}

​
提交执行

填写应用定义的输入参数后提交任务，系统自动调度 Agent 执行。 
// POST /api/task/submit
{
  "taskId": "task-xxxxx",
  "params": {
    "text": "Hello, world!",
    "targetLang": "zh"
  }
}
提交后，Core API 通过 agent-invoke 服务将任务分发到外部 Agent 系统（如 MindSynth/Lingda），并异步等待回调。

​
Agent 回调

Agent 执行完成后，通过内部回调通知结果： 
// POST /internal/task/callback
{
  "taskId": "task-xxxxx",
  "status": "completed",
  "resultPreview": "翻译结果预览...",
  "resultFull": "完整翻译内容...",
  "costCoins": 50
}

​
付费查看

用户查看结果预览后，付费解锁完整结果： 
// POST /api/task/pay
{
  "taskId": "task-xxxxx"
}
付费操作从用户金币账户扣除 costCoins 金额，扣费成功后 payStatus 更新为 paid。

​
付费查看模型

设计要点：
  • 结果分为 resultPreview（免费预览）和 resultFull（付费内容）
  • 未付费时只返回预览，付费后返回完整结果
  • 金币扣费通过 requestId 保证幂等性

​
任务管理

方法路径说明
POST/api/task/list分页任务列表（支持筛选状态）
POST/api/task/rename重命名任务
POST/api/task/pin置顶/取消置顶
POST/api/task/delete删除任务
POST/api/task/result查看任务结果

​
API 接口汇总

方法路径说明认证
POST/api/task/create创建任务需要
POST/api/task/submit提交任务执行需要
POST/api/task/list任务列表需要
POST/api/task/result查看结果需要
POST/api/task/pay付费解锁需要
POST/api/task/rename重命名需要
POST/api/task/pin置顶需要
POST/api/task/delete删除需要

​
文件系统

任务可关联文件（输入附件或输出结果），文件通过 MinIO 对象存储管理：
方法路径说明
POST/api/file/upload上传文件
GET/api/file/download/:fileUuid下载文件
DELETE/api/file/:fileUuid删除文件
每个文件拥有唯一 fileUuid，通过 fileInfos 表记录元信息（文件名、大小、MIME 类型、关联任务）。

​
相关链接

应用市场

从市场发现应用，发起任务

金融支付

任务付费的金币扣费机制