Repolode
提交项目
VRSEN

VRSEN/agency-swarm

一个用于构建多智能体系统的 Python 框架，让具有明确角色的 AI 智能体按预定义的通信流程协作。

在 GitHub 查看官网
Star
4,629
Fork
1,063
未关闭 Issue
9
最近提交
6天前

这是什么？

Agency Swarm 是一个用 Python 构建多智能体应用的框架，按照真实组织的结构把多个 AI 智能体组织成一个团队协同工作。每个智能体都有自己的角色、指令和工具，开发者可以指定哪些智能体之间可以发起对话。框架基于 OpenAI Agents SDK 构建，并在其上增加了编排层。

智能体之间通过专门的 send_message 工具通信，Agency 上设置的有向 communication_flows 决定了谁能联系谁。工具既可以用 @function_tool 装饰器定义为 Python 函数，也可以继承 BaseTool 并使用 Pydantic 字段定义，还能从 OpenAPI schema 自动生成。会话历史可通过加载和保存回调持久化，例如存入数据库或文件。

项目要求 Python 3.12 及以上版本，原生支持 OpenAI 模型，并可通过 LiteLLM 接入 Anthropic、Gemini、Azure OpenAI 等其他模型服务。框架还提供网页演示和终端界面来运行智能体团队。

核心功能

  • 01为每个智能体定义角色、指令、工具和模型参数。
  • 02通过有向的 communication_flows 限制智能体之间的通信方向。
  • 03支持将 Python 函数、BaseTool 类或 OpenAPI schema 转换为工具。
  • 04通过加载和保存回调实现会话历史的持久化。
  • 05提供网页演示、终端界面和异步 get_response 接口来运行团队。

适用场景

  • 快速原型化由多个专业智能体组成的团队，例如由 CEO 智能体向开发和助理智能体分派任务。
  • 构建内部自动化，让智能体调用由 OpenAPI schema 描述的现有接口。
  • 运行需要跨会话保存对话状态的多智能体工作流。

快速上手

  1. 1

    使用 pip 安装框架

    pip install -U agency-swarm
  2. 2

    在 .env 文件或 shell 中设置 OpenAI API 密钥

    export OPENAI_API_KEY="YOUR_API_KEY"
  3. 3

    从 Agency Starter Template 开始，按照 README 定义智能体和通信流程

使用前须知

  • 需要 Python 3.12 或更高版本。
  • 运行智能体需要 OpenAI API 密钥或其他受支持的模型服务商密钥。
  • 从 v0.x 迁移需要将项目适配到新的基于 SDK 的版本。

收录于专题

多智能体编排框架开源 AI Agent 框架与应用

标签

#multi-agent#llm#agents#python#openai#orchestration

常见问题

agency-swarm 是什么？
一个用于构建多智能体系统的 Python 框架，让具有明确角色的 AI 智能体按预定义的通信流程协作。 Agency Swarm 是一个用 Python 构建多智能体应用的框架，按照真实组织的结构把多个 AI 智能体组织成一个团队协同工作。每个智能体都有自己的角色、指令和工具，开发者可以指定哪些智能体之间可以发起对话。框架基于 OpenAI Agents SDK 构建，并在其上增加了编排层。
agency-swarm 可以免费使用吗？用的什么许可证？
agency-swarm 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
agency-swarm 还在维护吗？
活跃维护中。agency-swarm 最近一次提交是在 2026年11月2日。
agency-swarm 适合用来做什么？
快速原型化由多个专业智能体组成的团队，例如由 CEO 智能体向开发和助理智能体分派任务。 构建内部自动化，让智能体调用由 OpenAPI schema 描述的现有接口。 运行需要跨会话保存对话状态的多智能体工作流。
agency-swarm 怎么安装和运行？
使用 pip 安装框架: pip install -U agency-swarm 在 .env 文件或 shell 中设置 OpenAI API 密钥: export OPENAI_API_KEY="YOUR_API_KEY" 从 Agency Starter Template 开始，按照 README 定义智能体和通信流程
在哪里获取 agency-swarm？
源代码和安装说明在 GitHub 上：https://github.com/VRSEN/agency-swarm

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目