Paper Retrieval

Repilot 科研智能体（paper-retrieval）

本 Skill 对应的 MCP 服务标识符为 paper-retrieval（见 mcp.json 的 mcpServers.paper-retrieval），对外产品名为「Repilot 科研智能体」。下文所有工具均通过该 MCP 服务调用。

本连接器提供科研辅助能力，所有任务均为异步执行，提交后立即返回任务ID，需通过状态查询获取最终结果。

状态与耗时汇总

• 统一状态枚举：accepted（已受理）、processing（执行中）、completed（完成）、failed（失败）、cancelled（已取消）、not_found（任务不存在）。
• 轮询建议：
  • 短任务（quick_search）：每 30 秒查询一次，最多轮询 3 次。
  • 中任务（smart_assistant）：每 60 秒查询一次，最多轮询 4 次。
  • 长任务（start_detailed_report、start_research_task）：每 60 秒查询一次，分别最多轮询 20 次和 30 次。

可用工具

1. start_research_task - 课题申报 / 撰写 PPT

• 用途：生成科研申报书、研究汇报 PPT、医学科普 PPT 等文档。
• 参数：

  参数	类型	必填	说明
  taskTitle	string	✅	用户需求描述，可包含具体方向、要求等

• 返回：{"taskId": "...", "status": "accepted"}，随后轮询 get_task_status。

2. quick_search - 快速文献检索

• 用途：快速检索学术文献，返回文献列表。
• 参数：

  参数	类型	必填	说明
  query	string	✅	检索关键词或问题
  sessionId	string	-	会话ID（可选）

• 返回：{"taskId": "...", "status": "accepted"}。

3. smart_assistant - 智能查询检测项目

• 用途：回答医学检测项目、样本保存方法、疾病检查建议、标志物临界值等问题。
• 输出契约：结果 JSON 中 text 与 reasoning 由服务端保证一致（不一致时以 reasoning 为准自动回填 text），可直接使用 text 字段作答。
• 参数：

  参数	类型	必填	说明
  content	string	✅	用户输入内容
  sessionId	string	-	会话ID（可选）

• 返回：{"taskId": "...", "status": "accepted"}。

4. start_detailed_report - 综述报告生成

• 用途：根据课题生成详细的文献综述报告。
• 参数：

  参数	类型	必填	说明
  topic	string	✅	课题或研究方向

• 返回：{"taskId": "...", "status": "accepted"}。

5. get_task_status - 查询任务状态

• 用途：查询任意异步任务的当前状态。
• 参数：taskId (string, 必填)
• 返回：包含 status 字段的 JSON。

6. get_task_result - 获取任务结果

• 用途：获取已完成任务的最终内容。
• 参数：taskId (string, 必填)
• 返回：若任务完成，返回 result 字段。

7. cancel_task - 取消任务

• 用途：取消正在执行的任务。
• 参数：taskId (string, 必填)

调用流程与约束

1. 提交任务：调用对应的启动工具，传入用户需求。
2. 轮询状态：按上述轮询建议定时调用 get_task_status，直到状态为 completed、failed 或 cancelled。

• 若返回 not_found，检查任务ID是否正确。
• 超时未完成可调用 cancel_task 取消。

3. 获取结果：任务完成后调用 get_task_result 获取最终内容展示给用户。

重要限制

• 并发限制：同一用户同时只能运行一个任务。若提交时返回 "已有任务在运行，请稍后再试"，请告知用户等待当前任务完成，不要重复提交。
• 异步特性：所有工具调用都在几秒内返回，不会阻塞。请勿在单次请求中等待长时间结果。
• 认证：使用 OAuth 2.0，Token 由 WorkBuddy 自动管理。
• 错误处理：若 failed，读取 error 字段并向用户解释。
• 边界：
  • 不支持同时运行多个任务。
  • 不支持实时流式输出。
  • 不支持修改已提交任务的参数（需取消后重新提交）。

示例对话

用户：帮我生成一份关于“AI 在医疗诊断中的应用”的科研申报书。
AI 动作：调用 start_research_task，参数 taskTitle: "AI 在医疗诊断中的应用"。
AI 回复：告知用户任务已启动，预计 15–30 分钟，并定期查询进度。

用户：查一下近两年关于基因编辑的文献。
AI 动作：调用 quick_search，参数 query: "基因编辑"。
AI 回复：告知用户约 30~80 秒后返回结果，随后调用 get_task_result 获取并展示列表。

用户（轮询时）：获取结果。
AI 动作：调用 get_task_result，参数 taskId: "def456"。
返回：文献列表。
AI 回复：展示列表。