这篇解决什么

CrewAI 解决的是「按角色分任务」的 Multi-Agent，不是通用图编排。核心对象只有三个：Agent（角色、目标、工具）、Task（要交付什么）、Crew（谁和谁、按什么流程跑）。原先这篇是空草稿，并进这一条，不再另开标题。

先写角色边界，再写 Crew

每个 Agent 只给一类工具和一份短目标。规划、检索、执笔、验收不要塞进同一个角色，否则和本系列 Multi-Agent 文里说的「自己写自己打分」是同一个坑。Task 要写可检查的交接物（一份带引用的摘要、一份补丁），不要写「尽量做好」。

流程只有两类，先用顺序

  • Sequential：任务按列表交接，适合流水线。
  • Hierarchical：多一个管理者拆任务、汇总。管理者没有独立验收标准时，层级只会放大胡编。

工具失败、循环次数、token 预算要在 Crew 外设上限。框架不会替你做停止机制，那部分看「停止与日志」。

和 LangGraph、AgentScope 怎么选

  • 角色、任务描述对业务方可读，用 CrewAI。
  • 要条件边、HITL、精确恢复，用 LangGraph。
  • 要权限、Sandbox、服务化 Runtime，用 AgentScope。

单 Agent 加工具能完成的事，不要上 Crew。评估看任务完成率和协作轮次，而不是某一句回复是否漂亮。