Agency Swarm

Agency Swarm：可靠的多代理编排框架

Agency Swarm 是一个开源框架，旨在通过利用和扩展 OpenAI Agents SDK 来简化 AI 代理的创建。它有助于构建、编排和管理 AI 代理的协作集群，从而实现具有用户定义的通信流的真正代理协作。

什么是 Agency Swarm？

Agency Swarm 通过引入诸如具有灵活通信流的真正代理协作、用于定义复杂通信的 Agency 类、灵活的会话持久性以及用于代理通信的专用 send_message 工具等功能来增强 OpenAI Agents SDK。它允许开发人员从现实世界的组织结构角度考虑自动化，从而使代理和用户都能直观地理解。

主要特点：

• 可定制的代理角色： 定义具有定制指令、工具和功能的不同代理角色（例如，CEO、虚拟助手、开发人员）。
• 完全控制提示/指令： 保持对每个代理的指导提示的完全控制，以实现精确的行为自定义。
• 类型安全的工具： 使用 Pydantic 模型开发工具以进行自动参数验证。
• 精心安排的代理通信： 代理通过专用的 send_message 工具进行通信，交互由显式的、定向的通信流控制。
• 灵活的状态持久性： 通过为 Agency 提供 load_threads_callback 和 save_threads_callback 来管理会话历史记录，从而实现跨会话的持久性（例如，DB/文件存储）。
• 多代理编排： 在 OpenAI Agents SDK 基础上构建代理工作流程，并通过 Agency Swarm 的结构化编排层进行增强。
• 关注生产就绪： 专为可靠性而构建，并设计为可在实际环境中轻松部署。

Agency Swarm 是如何工作的？

Agency Swarm 基于 OpenAI Agents SDK 构建，引入了 Agency 的概念，该概念管理多个代理及其通信流。主要组件包括：

• Agency： 一个使用 > 运算符定义代理之间通信流的协调器。它还通过回调函数处理会话持久性。
• Agent： 具有内置文件处理和子代理注册的基本 SDK 代理的扩展。可以为代理分配特定的角色、指令和工具。
• 通信流： 在 Agency 上定义的显式的、定向的通信路径，用于管理代理之间的交互方式。
• 工具： 使用 Pydantic 模型开发或从 OpenAPI 模式转换而来的自定义工具，允许代理执行特定任务。

如何使用 Agency Swarm？

1. 安装： 使用 pip 安装软件包：pip install -U agency-swarm
2. 设置 OpenAI 密钥： 在 .env 文件中设置您的 OpenAI API 密钥，或在您的 shell 中导出它。
3. 创建工具： 使用 @function_tool 装饰器定义自定义工具或扩展 BaseTool。
4. 定义代理角色： 定义具有特定指令、工具和功能的代理角色。
5. 定义 Agency 通信流： 使用 Agency 类和 > 运算符建立代理之间的通信流。
6. 运行演示： 使用 Web UI (agency.copilot_demo())、终端 (agency.terminal_demo()) 或以编程方式运行演示。

Agency Swarm 适合谁？

Agency Swarm 专为希望构建复杂的多代理 AI 应用程序的开发人员、AI 工程师和研究人员而设计。它特别适用于：

• 自动化需要多个 AI 代理之间协作的复杂任务。
• 构建模仿现实世界组织结构的 AI 驱动的工作流程。
• 创建可以轻松部署和扩展的生产就绪的 AI 应用程序。

为什么选择 Agency Swarm？

Agency Swarm 比传统的 AI 开发方法具有多个优势：

• 简化的多代理编排： 提供了一个用于管理和编排多个 AI 代理的结构化框架。
• 增强的协作： 通过用户定义的通信流实现真正的代理协作。
• 生产就绪： 专为可靠性而构建，并设计为可在实际环境中轻松部署。
• 可扩展： 利用并扩展 OpenAI Agents SDK，允许开发人员自定义和扩展框架以满足其特定需求。

构建多代理 AI 应用程序的最佳方式？

Agency Swarm 提供了一个强大而灵活的框架，用于构建多代理 AI 应用程序。通过定义代理角色、通信流和自定义工具，开发人员可以创建 AI 驱动的工作流程，从而可以自动化复杂任务并解决现实世界中的问题。该框架对生产准备就绪和可扩展性的关注使其成为构建可扩展且可靠的 AI 应用程序的理想选择。

兼容性：

• Python： 3.12+
• 模型后端：
  • OpenAI（原生）：GPT-5 系列、GPT-4o 等。
  • 通过 LiteLLM（路由器）：Anthropic (Claude)、Google (Gemini)、Azure OpenAI、OpenRouter (gateway) 等。
• 操作系统： macOS、Linux、Windows

结论：

Agency Swarm 通过提供一个结构化框架来管理代理角色、通信流和工具，从而简化了多代理 AI 应用程序的开发。其生产就绪的设计和可扩展性使其成为构建可扩展且可靠的 AI 解决方案的强大工具。如果您希望构建需要多个代理之间协作的复杂 AI 应用程序，那么 Agency Swarm 是一个绝佳的选择。