QwenPaw agent 用的工具插件,把后台任务等待封装成一次工具调用。

干嘛的

QwenPaw 的 spawn_subagent(background=True) 可以把任务丢到后台,返回一个 task_id。原来 agent 想等结果,得自己写循环:sleep → check_agent_task → sleep → check_agent_task → ...

这个插件把循环封装成一次调用:

# 以前:agent 自己轮询
spawn_subagent(..., background=True)  → task-abc
sleep 10 → check_agent_task → running
sleep 20 → check_agent_task → finished ✅

# 现在:一次搞定
wait_agent_task("task-abc")  → 跑完直接返回 ✅

功能

  • 等一个任务wait_agent_task(task_id="task-abc")
  • 同时等多个wait_agent_task(task_id=["task-abc", "task-def"])
  • 指定超时wait_agent_task(task_id="task-abc", timeout=120)
  • 智能轮询:间隔自动递增(1s → 3s → 5s → 10s cap),又快又省
  • 前置校验:task_id 不存在立刻报错,不白等
  • 超时返回:任务在后台继续跑,可重新等
  • 零依赖:复用 QwenPaw 内置组件,不装额外包

参数

参数 类型 说明
task_id str 或 list[str] 要等的任务 ID,一个或多个
timeout int 最多等多久(秒),默认 900

返回格式

[TASK_ID: task-abc]
⏱ Duration: 47.3s
[STATUS: completed]
<reply>
子 agent 的输出内容
</reply>

插件市场链接(推荐使用插件市场来安装)

https://platform.agentscope.io/plugins/tool-wait-agent-task

项目地址

https://github.com/onesixth/qwenpaw-plugin-tool-wait_agent_task

更多推荐