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） - 开发者可以定义具有不同职责的智能体角色，每个角色拥有独立的指令（instructions）、工具集（tools）和模型配置（model_settings），支持通过继承 Agent 基类或直接实例化两种方式。
  2. 类型安全的工具系统（Type-Safe Tools） - 基于 Pydantic BaseModel 开发工具（继承 BaseTool 类或使用 @function_tool 装饰器），自动进行参数验证，兼容 OpenAI FunctionTool 格式，同时支持从 OpenAPI Schema 自动生成工具。
  3. 有向通信流编排（Orchestrated Communication Flows） - 智能体之间通过 SendMessage 工具通信，使用 communication_flows 参数定义方向性通信权限（如 (ceo, dev) 表示 CEO 可主动联系 Developer），支持 Handoff 模式实现控制权转移。
  4. 灵活的状态持久化（Flexible State Persistence） - 通过 load_threads_callback 和 save_threads_callback 回调函数管理对话历史，支持数据库或文件存储，实现跨会话的状态持久化。
  5. 多模型后端支持 - 原生支持 OpenAI GPT-5/GPT-4o 系列，通过 LiteLLM 路由器还支持 Anthropic Claude、Google Gemini、xAI Grok、Azure OpenAI、OpenRouter 等多种模型后端。
  6. 生产就绪（Production-Ready Focus） - 内置 Web UI（CopilotKit/AG-UI）和终端 CLI 界面，提供异步 API、FastAPI 集成、流式输出、成本追踪、Guardrails 护栏和 MCP Tools Server，测试覆盖率达 92%。

社区生态

  • GitHub Stars： 4,208（截至 2026-04-12）
  • Forks： 1,014
  • Contributors： 21 位贡献者，核心贡献者为 bonk1t（1,273 次提交）、VRSEN（476 次提交）、ArtemShatokhin（427 次提交）
  • 最近更新日期： 2026-04-12（持续活跃维护中）
  • 社区讨论热度： 拥有 GitHub Discussions 论坛、Discord 社区频道、YouTube 频道和 Twitter 账号（@vrsen）
  • PyPI 下载量： 包名 agency-swarm，最新版本 1.8.0，详细下载统计可在 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 内容策略自动化、业务流程自动化、客户支持系统

关键链接汇总

官方资源

教程资源

社区资源

信息来源