Agency Swarm - 技术发现报告

Agency Swarm 是一个基于 OpenAI Agents SDK 构建的多智能体编排框架，通过模拟真实组织结构（如 CEO、开发者、虚拟助手等角色）来创建和管理协作式 AI 智能体团队。

Agency Swarm - 技术发现报告

基本信息

  • 名称： Agency Swarm
  • 官方地址： https://agency-swarm.ai
  • GitHub 仓库： https://github.com/VRSEN/agency-swarm
  • 当前版本： 1.8.0（2026-02-25 发布）
  • License： MIT
  • 主要编程语言： Python
  • 首次发布日期： 2023-11-16
  • 创建者/维护团队： Arsenii Shatokhin（aka VRSEN）

一句话定位

Agency Swarm 是一个基于 OpenAI Agents SDK 构建的多智能体编排框架，通过模拟真实组织结构（如 CEO、开发者、虚拟助手等角色）来创建和管理协作式 AI 智能体团队。

核心特性

  1. 可定制的智能体角色（Customizable Agent Roles） - 开发者可以定义具有不同职责的智能体角色（如 CEO、Developer、Virtual Assistant），每个角色拥有独立的指令、工具和能力配置。
  2. 类型安全的工具系统（Type-Safe Tools） - 基于 Pydantic 模型开发工具，自动进行参数验证，兼容 OpenAI Agents SDK 的 FunctionTool 格式，同时支持从 OpenAPI Schema 自动生成工具。
  3. 有向通信流编排（Orchestrated Communication Flows） - 智能体之间通过 send_message 工具通信，使用 > 运算符定义方向性的通信权限（如 ceo > dev 表示 CEO 可主动联系 Developer），确保通信结构清晰可控。
  4. 灵活的状态持久化（Flexible State Persistence） - 通过 load_threads_callback 和 save_threads_callback 回调函数管理对话历史，支持数据库或文件存储，实现跨会话的状态持久化。
  5. 多模型后端支持 - 原生支持 OpenAI GPT-5 系列，通过 LiteLLM 路由器还支持 Anthropic Claude、Google Gemini、xAI Grok、Azure OpenAI、OpenRouter 等多种模型后端。
  6. 生产就绪（Production-Ready Focus） - 内置 Web UI 和终端 CLI 界面，提供异步 API，测试覆盖率达 92%，面向真实生产环境部署设计。

社区生态

  • GitHub Stars： 4,206（截至 2026-04-12）
  • Contributors： 21 位贡献者，核心贡献者为 bonk1t（1,273 次提交）、VRSEN（476 次提交）、ArtemShatokhin（427 次提交）
  • 最近更新日期： 2026-04-12（持续活跃维护中）
  • 社区讨论热度： 拥有 GitHub Discussions 论坛、Discord 社区频道、YouTube 频道和 Twitter 账号（@vrsen）
  • PyPI 下载量： 包名 agency-swarm，最新版本 1.8.0 于 2026-02-25 发布，详细下载统计可在 pepy.tech 查看

技术栈定位

  • 所属领域： AI 多智能体编排框架（Multi-Agent Orchestration）
  • 解决的核心问题： 简化多个 AI 智能体之间的协作编排，通过组织结构化的通信流管理复杂的多智能体工作流
  • 替代/竞品技术： CrewAI、AutoGen（Microsoft）、LangGraph、MetaGPT、OpenAI Agents SDK（原生）
  • 依赖的上游技术： OpenAI Agents SDK、OpenAI Responses API、Pydantic、LiteLLM（可选）
  • 下游使用者/集成方： 企业级 AI 自动化系统、内容创作工作流、YouTube 内容策略自动化、业务流程自动化

关键链接汇总

官方资源

教程资源

社区资源

信息来源