ag2

环境要求

• Python 版本 >= 3.10
• 已安装 pip 包管理工具
• 你需要使用的大模型服务商 API Key（如 OpenAI）
• 终端可执行 export 命令（Windows 可用对应方式设置环境变量）

安装与启动步骤

1. 1安装 AG2 包

   按你使用的模型供应商选择对应的 extra 安装。默认只装最小依赖，不加 extra 无法调用模型。

   pip install ag2[openai]

   复制

2. 2配置 API Key

   每个供应商读取各自的标准环境变量，密钥无需写进代码或提交到仓库。换成 Anthropic、Gemini 等时改对应变量名。

   export OPENAI_API_KEY="sk-xxxxxxxx"

   复制

3. 3编写第一个智能体

   AG2 全程异步，Agent.ask 发起一轮对话并返回 AgentReply，文本在 reply.body 中。把示例保存为 main.py。

   import asyncio
   
   from ag2 import Agent
   from ag2.config import OpenAIConfig
   
   agent = Agent(
       "assistant",
       prompt="You are a helpful assistant.",
       config=OpenAIConfig(model="gpt-4o-mini"),
   )
   
   
   async def main() -> None:
       reply = await agent.ask("Summarize the main differences between Python lists and tuples.")
       print(reply.body)
   
   
   asyncio.run(main())

   复制

4. 4运行并查看回复

   执行脚本，终端应打印模型返回的文本内容。若报认证错误，检查环境变量是否在当前终端生效。

   python main.py

   复制

关键配置

如何确认成功

运行 python main.py，终端打印出模型对列表与元组区别的回答文本即成功。

常见问题

注意事项

• AG2 要求 Python >= 3.10，低版本无法安装。
• AG2 v1.0 后顶层包为 ag2，经典 AutoGen 接口已迁至独立仓库 ag2ai/ag2-classic，原有代码仍可继续使用。
• AG2 是异步框架，调用需配合 async/await 与 asyncio.run。
• 密钥建议通过环境变量注入，不要硬编码或提交进版本库。