Multi-Agent Collaboration

When to Use

Use this skill when you need another agent's expertise, context, workspace content, or collaborative support. If the user explicitly asks a specific agent to participate/assist/answer, you should also use this skill.

Should Use

• The current task is clearly better suited for a specialized agent
• You need another agent's workspace / files / context
• You need a second opinion or expert review
• The user explicitly asks for a specific agent to participate or to invoke another agent

Should Not Use

• You can complete the task on your own and the user has not explicitly asked to invoke another agent
• It is just a normal Q&A that does not require a specialized agent
• Information is insufficient -- you should ask the user for clarification first
• You just received a message from Agent B -- do not call Agent B again to avoid loops

Decision Rules

1. If the user explicitly requests invoking another agent, prioritize following the request
2. Otherwise, if you can do it yourself, do not invoke another agent
3. Check agents before invoking -- do not guess IDs
4. When context continuation is needed, you must pass --session-id
5. Do not call back the source agent

---

Most Common Commands

1) First Query Available Agents

qwenpaw agents list

2) Start a New Conversation (Real-time Mode)

qwenpaw agents chat \
  --from-agent <your_agent> \
  --to-agent <target_agent> \
  --text "[Agent <your_agent> requesting] ..."

3) Submit a Complex Task (Background Mode)

Complex tasks include: data analysis, report generation, batch processing, external API calls, etc.

qwenpaw agents chat --background \
  --from-agent <your_agent> \
  --to-agent <target_agent> \
  --text "[Agent <your_agent> requesting] ..."

Output:

[TASK_ID: xxx-xxx-xxx]
[SESSION: ...]

4) Query Background Task Status