AutoGen 安装与使用指南

AutoGen 安装与使用指南

一、环境准备

1. 检查 miniconda 安装状态

conda --version

如果未安装，可通过 Homebrew 安装：

brew install --cask miniconda

2. 初始化 conda（首次使用）

conda init zsh

然后重新加载配置：

source ~/.zshrc

3. 创建 conda 环境

conda create -n juke-ai python=3.13 -y

4. 激活环境

conda activate juke-ai

二、安装 AutoGen

1. 安装 pyautogen 核心包

pip install pyautogen

验证安装：

pip show pyautogen

2. 安装 AutoGen Studio（Web UI）

pip install -U autogenstudio

三、启动 AutoGen Studio

启动命令

conda activate juke-ai
autogenstudio ui --port 8081

启动成功后，在浏览器中访问：

http://127.0.0.1:8081

端口说明

  • 默认端口：8080
  • 如果端口被占用，可指定其他端口：--port 8082

停止 UI

方法 1：终端前台运行时

Ctrl+C

方法 2：后台运行时

pkill -f autogenstudio

方法 3：查找进程后停止

# 查找进程
ps aux | grep autogenstudio

# 杀掉进程（替换 PID）
kill <PID>

四、首次配置

1. 配置 API Key

进入页面后：

  1. 点击 Settings → DefaultModel → Edit Model
  2. 添加 OpenAI API Key（或其他兼容 LLM API）
  3. 选择模型（如 gpt-4o, gpt-4o-mini 等）

2. 模型配置示例（JSON 格式）

{
  "provider": "autogen_ext.models.openai.OpenAIChatCompletionClient",
  "component_type": "model",
  "version": 1,
  "component_version": 1,
  "description": "OpenAI GPT-4o-mini",
  "label": "OpenAI GPT-4o Mini",
  "config": {
    "model": "gpt-4o-mini",
    "api_key": "sk-proj-xxx",
    "model_info": {
      "vision": "False",
      "function_calling": "True",
      "json_output": "False",
      "family": "unknown",
      "structured_output": "True"
    }
  }
}

五、功能模块说明

英文名称 中文说明 功能
Team Builder 团队构建器 创建和管理智能体团队
Playground 测试场 实时测试和调试智能体对话
Gallery 画廊 浏览和管理模型配置
Settings 设置 配置 API Key 和模型参数
Deploy 部署 部署智能体应用

六、常用命令速查

# 激活环境
conda activate juke-ai

# 退出环境
conda deactivate

# 启动 UI
autogenstudio ui --port 8081

# 指定数据目录
autogenstudio ui --port 8081 --appdir ./my_autogen_data

# 更新 AutoGen
pip install -U pyautogen autogenstudio

# 停止 UI
pkill -f autogenstudio

七、环境信息

  • Python 版本：3.13.12
  • pyautogen 版本：0.10.0
  • autogen-agentchat 版本：0.7.5
  • autogen-core 版本：0.7.5
  • autogenstudio 版本：0.4.2.2
  • 环境路径：/opt/homebrew/Caskroom/miniconda/base/envs/juke-ai

八、注意事项

  1. AutoGen Studio 目前仅支持英文界面
  2. 可使用浏览器自带翻译功能辅助使用
  3. 数据默认存储在 ~/.autogenstudio 目录
  4. 首次使用需要配置有效的 API Key
  5. 停止服务按 Ctrl+C

九、参考资源

posted @ 2026-03-01 11:15  元贞  阅读(2)  评论(0)    收藏  举报