ag2ai/ag2

这是什么？

核心功能

• 01Agent 类提供异步 ask() 调用，并支持延续多轮对话。
• 02通过 @tool 装饰的普通 Python 函数实现工具调用。
• 03以可选依赖的形式支持多家大模型服务商。
• 04运行中可暂停并向人工请求输入或确认。
• 05基于 Hub 的多智能体编排，通过类型化通道通信并保留预写日志。
• 06可选的知识存储与历史压缩，用于实现持久记忆。

适用场景

• 构建调用自定义 Python 工具的单个助手型智能体。
• 让规划类和审阅类智能体通过对话协作，逐步优化输出。
• 在工具执行前加入人工审批环节。
• 用 Python 快速搭建智能体或多智能体工作流的原型。

快速上手

1. 1

   安装带 OpenAI 扩展的包

   pip install ag2[openai]
2. 2

   将 OpenAI API 密钥设置为环境变量

   export OPENAI_API_KEY="<your-api-key>"
3. 3

   保存 README 中的第一个智能体示例并运行

使用前须知

• !需要 Python 3.10 或更高版本。
• !运行示例需要付费的 OpenAI API 密钥或其他模型提供商的密钥。
• !不能直接从 AG2 Classic 无缝升级；autogen 导入名和经典智能体类已被移除。

标签

常见问题

ag2 是什么？

用于构建 AI 智能体的 Python 框架，支持调用大模型和工具，并让多个智能体协同完成任务。 AG2（原 AutoGen）是一个开源的 Python 框架，用于构建 AI 智能体，并协调多个智能体共同完成任务。Agent 可以连接模型服务商，通过 @tool 装饰的 Python 函数调用工具，并自动完成完整的工具调用循环。模型服务通过可选依赖安装，例如 ag2[openai]、ag2[anthropic]、ag2[gemini] 和 ag2[ollama]。

ag2 可以免费使用吗？用的什么许可证？

ag2 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

ag2 还在维护吗？

活跃维护中。ag2 最近一次提交是在 2026年10月21日。

ag2 适合用来做什么？

构建调用自定义 Python 工具的单个助手型智能体。 让规划类和审阅类智能体通过对话协作，逐步优化输出。 在工具执行前加入人工审批环节。 用 Python 快速搭建智能体或多智能体工作流的原型。

ag2 怎么安装和运行？

安装带 OpenAI 扩展的包: pip install ag2[openai] 将 OpenAI API 密钥设置为环境变量: export OPENAI_API_KEY="<your-api-key>" 保存 README 中的第一个智能体示例并运行

在哪里获取 ag2？

源代码和安装说明在 GitHub 上：https://github.com/ag2ai/ag2