AIWaves Agents 项目快速入门指南
2025-07-08 00:55:31作者：蔡丛锟
项目概述
AIWaves Agents 是一个基于大语言模型(LLM)的智能体开发框架，它允许开发者快速构建和部署各种类型的AI智能体。该项目提供了单智能体和多智能体交互的实现方案，支持多种运行方式，包括命令行、Gradio界面和FastAPI服务。
安装方式
从源码安装
对于希望深度定制或参与开发的用户，推荐从源码安装：
- 克隆项目仓库
- 进入项目目录
- 使用pip进行可编辑安装
安装完成后，需要注意部分导入语句可能需要调整，将"from agents.XXX import XXX"改为"from XXX import XXX"。
通过PyPI安装
对于大多数用户，最简单的安装方式是通过PyPI：
pip install ai-agents
这种方式安装简单快捷，但需要注意每次代码更新后需要重新安装以获取最新功能。
单智能体配置与运行
配置文件详解
单智能体的核心配置文件通常位于examples/Single_Agent/{target_agent}/config.json，主要配置项包括：
- 智能体特定参数：如购物助手中的商品匹配阈值(MIN_CATEGORY_SIM)、商品数据库路径(TOY_INFO_PATH)等
- 通用参数：
- API_KEY：大模型API密钥
- PROXY：代理设置
- API_BASE：API基础地址
- MAX_CHAT_HISTORY：最大对话历史长度
- User_Names：要运行的智能体名称
如果使用Web搜索组件，还需要额外配置搜索引擎参数。
运行方式
-
命令行运行：
cd examples python run.py --agent Single_Agent/{target_agent}/config.json -
Gradio界面运行：
cd examples python Single_Agent/run_gradio.py --agent Single_Agent/{target_agent}/config.json -
FastAPI服务运行：
cd examples python run_backend.py --agent Single_Agent/{target_agent}/config.json
多智能体配置与运行
多智能体配置与单智能体类似，主要区别在于User_Names参数可以指定多个智能体名称，如["Mike","Mary"]。
运行方式与单智能体基本相同，只需将路径中的Single_Agent替换为Multi_Agent。
对于Fiction-Studio等特定演示，需要先设置环境变量：
export PROXY="xxx"
export API_KEY="sk-xxxxxxx"
自定义智能体开发
开发步骤
- 根据template.py模板编写config.json配置文件
- 按照需求实现智能体逻辑
- 使用与标准智能体相同的运行方式启动自定义智能体
自定义大语言模型
项目支持替换默认的大语言模型，开发者可以：
- 修改src/agents/LLM/base_LLM.py中的init_LLM方法
- 实现自定义LLM类，继承自LLM基类
- 确保实现get_response方法，并保持输入输出格式一致
- 特别注意流式输出(stream=True/False)的处理方式
SOP生成功能
单智能体SOP生成
- 配置examples/sop_generation/gen_single_agent/run.py中的参数
- 设置目标描述(target)和API相关配置
- 运行脚本生成标准操作流程
多智能体SOP生成
- 配置examples/sop_generation/gen_multi_agent/run.py
- 除了基本参数外，还可设置need_coder标志指示是否需要代码输出
- 运行脚本生成多智能体协作的标准操作流程
智能体中心(Agent Hub)
项目提供了智能体中心功能，开发者可以：
- 浏览社区共享的智能体示例
- 基于现有智能体进行二次开发
- 贡献自己的智能体实现
- 通过标准流程提交智能体配置和代码
最佳实践建议
- 对于初次使用者，建议从PyPI安装开始
- 开发新智能体时，先研究template.py和现有示例
- 替换LLM时，务必保持接口一致性
- 多智能体场景下，注意配置正确的角色名称
- 生产环境部署推荐使用FastAPI方式
通过本指南，开发者可以快速上手AIWaves Agents项目，构建各种类型的智能体应用。项目提供了从简单到复杂的多种使用场景，支持高度自定义，是探索多智能体系统的理想平台。
