当前位置：首页 > news >正文

AutoGen 安装与使用指南

news 2026/5/11 20:40:24

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

进入页面后：

点击 Settings → DefaultModel → Edit Model
添加 OpenAI API Key（或其他兼容 LLM API）
选择模型（如 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