手把手教你搭建自主讨论多智能体

一、项目背景

最近好多家长和老师在讨论中考的相关事项，我将「多智能体协作」技术应用于该场景——搭建多位深耕中考的学科老师智能体，通过OpenAgents构建群聊网络，借助GLM赋予其专业人设与对话逻辑，让他们围绕中考的考点变化、复习方法、命题趋势等内容展开深度讨论，既可为考生/家长提供实用参考，也能直观展现AI Agent在垂直场景的应用价值。

二、核心技术栈

核心依赖两大工具，确保多智能体协作流畅、角色还原度高：

1. OpenAgents

- 开源地址：https://github.com/openagents-org/openagents

- 核心作用：搭建群聊网络中枢，实现多位老师智能体的实时连接、消息互通与协作，支持自定义智能体角色、配置网络参数。

- 特点：无协议限制，可无缝对接GLM，支持本地部署与可视化管理。

2. GLM

- 官方地址：https://www.bigmodel.cn/glm-coding

- 核心作用：为老师智能体赋予「灵魂」——基于精细化提示工程，还原中考老师的专业视角、语言风格（如教学话术、考点解读逻辑），支持长文本对话、指令精准遵循。

- 优势：编码能力强（可生成中考复习工具代码）、角色代入感深、回复简洁专业，适配教育场景的专业讨论需求。

三、落地实操步骤

第一步：环境准备与OpenAgents安装

1. 前置条件

已安装Python 3.9+环境（建议用Miniconda管理），网络通畅可访问GLM-4.7 API。

Miniconda可参考下图自己搜索

2. 安装OpenAgents

打开CMD/Terminal，执行以下命令：

pip install openagents

验证安装成功（需显示版本号，如0.8.4.post4）：

pip install --upgrade openagents==0.8.4

openagents --version

由于我之前已安装了，现在给OpenAgents做个升级，如下图：

第二步：创建并启动OpenAgents网络

1. 初始化项目网络

创建名为「Shanghai-Zhongkao-Group」的网络（可自定义名称），生成配置文件：

openagents init Shanghai-Zhongkao-Group

执行后会自动生成工作目录，包含`agents/`（智能体配置文件夹）、`network.yaml`（网络配置文件）等核心文件。

2. 启动网络

进入项目目录，启动网络（默认端口8700）：

cd Shanghai-Zhongkao-Group

openagents network start

第三步：配置GLM-4.7模型

需将OpenAgents与GLM-4.7绑定，确保智能体具备专业对话能力：

1. 获取GLM-4.7 API Key

- 访问智谱官网创建一个新的API Key

- 登录后点击「API Key」→「添加新的APIKey」，生成格式为「id.secret」的密钥（务必保存，切勿泄露）

2. 在OpenAgents中配置GLM-4.7

1. 打开OpenAgents Studio(http://localhost:8700/studio/)，点击左侧「服务代理」→「默认模型配置」。

2. 填写以下信息：

- 提供商：Custom OpenAI Compatible

- BaseURL：https://open.bigmodel.cn/api/paas/v4

- 模型名称：glm-4.7

- API密钥：填写上述获取的GLM-4.7 API Key

3. 解决环境变量问题（避免启动失败）

在Terminal中执行以下命令，配置环境变量（Windows系统）：

$env:OPENAI_BASE_URL = "https://open.bigmodel.cn/api/paas/v4"

$env:OPENAI_API_KEY = "你的GLM-4.7 API Key（如id.secret）"

第四步：创建3位中考老师智能体

1. 快速生成智能体配置文件

在`Shanghai-Zhongkao-Group/agents/`目录下，用CMD批处理创建3个老师的YAML配置文件（避免手动新建）

for %f in ("ZhangLaoshi.yaml" "WangLaoshi.yaml" "LiLaoshi.yaml") do @if not exist "%f" type nul > "%f"

执行后，`agents/`目录下会生成3个空YAML文件，分别对应3位老师。

2. 配置老师智能体人设（核心：精细化提示工程）

修改3个YAML文件的内容，分别定义「数学老师」、「语文老师」和「英语老师」的身份、专业领域、对话风格，以下为完整配置示例：

（1）王老师（初中数学，上海中考深耕15年）

（2）李老师（初中语文，上海中考命题研究骨干）

（3）张老师（初中英语，上海中考命题研究骨干）

第五步：启动老师智能体，开始群聊

1. 启动智能体（解决编码问题）

在Terminal中执行以下命令（确保UTF-8编码兼容）：

# 配置编码（避免中文乱码）

set PYTHONUTF8=1

set PYTHONIOENCODING=utf-8

set OPENAI_BASE_URL=https://open.bigmodel.cn/api/paas/v4

set OPENAI_API_KEY=

# 启动王老师智能体

openagents agent start agents/WangLaoshi.yaml

# 新建CMD窗口，启动李老师智能体

set PYTHONUTF8=1

set PYTHONIOENCODING=utf-8

set OPENAI_BASE_URL=https://open.bigmodel.cn/api/paas/v4

set OPENAI_API_KEY=

openagents agent start agents/LiLaoshi.yaml

# 新建CMD窗口，启动张老师智能体

set PYTHONUTF8=1

set PYTHONIOENCODING=utf-8

set OPENAI_BASE_URL=https://open.bigmodel.cn/api/paas/v4

set OPENAI_API_KEY=

openagents agent start agents/ZhangLaoshi.yaml

```

启动成功后，在OpenAgents Studio的「已连接代理」中会显示2位老师的状态为「online」。

2. 发起上海中考相关讨论

1. 打开OpenAgents Studio的「用户控制台」（点击右上角「返回用户控制台」）。

2. 选择「 general」频道（或新建「#上海中考讨论」频道），输入讨论话题（示例）：

2026年上海中考 大家怎么看？

3. 查看老师们的实时讨论回复（示例效果）：

四、常见问题解决方案

1. 智能体启动后直接退出

原因：环境变量未配置正确。解决方案：重新执行第三步的环境变量配置命令，确保API Key无拼写错误。

2. 中文乱码或解码失败

原因：编码未设置为UTF-8。解决方案：启动智能体前，务必执行编码配置命令（`PYTHONUTF8=1` `PYTHONIOENCODING=utf-8`）。

3. 建议使用GLM-4.5模型（网络效果好）

4. 忘记管理员密码

解决方案：执行`pip install --upgrade openagents`重新安装，或使用默认密码「admin」登录。

五、项目总结

本方案通过OpenAgents搭建轻量化群聊网络，借助GLM-4.7的角色还原能力，实现了多位上海中考老师的专业讨论。核心优势在于：

1. 实操性强：所有命令可直接复制执行，无需复杂开发；

2. 场景贴合：老师的人设、对话逻辑完全围绕上海中考，建议实用；

3. 可扩展性高：可新增英语、物理等学科老师，或添加真题爬取、自动答疑等功能。

无论是考生/家长用于复习参考，还是教育从业者研究AI在教学中的应用，都具备很高的落地价值。真正实现「让专业的人（智能体）聊专业的事」，让AI成为教育场景的实用伙伴。

#OpenAgents

#Multi-AgentHackathon2025

#多智能体

#智能体网络