Skip to content

This is a multi agent tutorial based on the CAMEL framework, aimed at understanding how to build an Agent Society from the ground up!

Notifications You must be signed in to change notification settings

datawhalechina/handy-multi-agent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

56 Commits
 
 
 
 
 
 

Repository files navigation

Handy Multi-Agent 教程

Handy Multi-Agent Logo

基于CAMEL框架从零开始构建多智能体系统的实用指南

GitHub stars GitHub forks GitHub issues GitHub license

🎉 项目已正式发布第一版! 完整教程文档已更新至docs目录,配套可执行代码位于code目录,可一键运行。如有任何疑问或功能建议,欢迎在GitHub提issue反馈~

📖 项目简介

Handy-Multi-Agent 是一套专为希望深入了解并实践多智能体系统的开发者设计的实用指南。本教程基于国内领先的多智能体框架 CAMEL-AI(NeruIPS'2023),从最基本的单个Agent开发,逐步引导读者构建复杂的Multi Agent应用。

🎯 面向人群

本项目侧重于实践和动手构建Agent应用,同时结合必要的理论知识,适合:

  • 对多智能体系统、大模型应用或人工智能领域有研究兴趣的学习者
  • 希望通过实践了解并探索LLM在多智能体系统中应用的开发者

🚀 学习目标

通过本项目,我们希望帮助开发者:

  1. 理解基础:掌握CAMEL框架的使用方法,理解Agent的基本概念
  2. 提升技能:通过实践项目,涉及RAG、Memory、Multi Agent等技术,提高构建和管理智能体的能力
  3. 应用实践:将所学知识应用于解决实际问题,培养实践能力和创新思维

👨‍💻 适合人群

  • 技术基础:具备Python编程基础,能够阅读和理解项目源代码和相关理论
  • 兴趣与动机:对AI智能体领域充满热情,希望从代码层面对智能体进行个性化能力开发

📚 项目结构

handy-multi-agent/
├── docs/                # 教程文档
│   ├── chapter0/        # 第零章:序言
│   ├── chapter1/        # 第一章:环境配置
│   ├── chapter2/        # 第二章:Agent的构成组件
│   ├── chapter3/        # 第三章:CAMEL框架简介及实践
│   ├── chapter4/        # 第四章:CAMEL框架下的RAG应用
│   ├── chapter5/        # 第五章:综合案例
│   ├── chapter6/        # 第六章:结语
│   ├── appendix/        # 附录
│   ├── images/          # 文档图片资源
│   └── files/           # 文档相关文件
│
├── code/                # 配套代码
│   ├── 第一章.ipynb      # 第一章实践代码
│   ├── 第二章.ipynb      # 第二章实践代码
│   ├── 第三章.ipynb      # 第三章实践代码
│   ├── 第四章/           # 第四章实践代码
│   └── 第五章/           # 第五章实践代码
│
└── README.md            # 项目说明文档

📝 内容目录

章节概览

  • 第零章:序言

    • 0.1 加入我们
    • 0.2 如何贡献?
  • 第一章:环境配置

    • 1.1 获取CAMEL
    • 1.2 API设置
    • 1.3 Hello CAMEL!
    • 1.4 第一章课程作业
  • 第二章:Agent 的构成组件

    • 2.1 智能体概述
    • 2.2 Agent设计原则与方法
    • 2.3 Models
    • 2.4 Messages
    • 2.5 Prompt Engineering
    • 2.6 Memory
    • 2.7 Tools
    • 2.8 第二章课程作业
  • 第三章:CAMEL框架简介及实践

    • 3.1 CAMEL框架简介
    • 3.2 创建你的第一个Agent Society
    • 3.3 创建你的Workforce
    • 3.4 第三章课程作业
  • 第四章:CAMEL框架下的RAG应用

    • 4.1 RAG的组件介绍
    • 4.2 向量数据库介绍
    • 4.3 搭建知识库
    • 4.4 构建RAG应用
    • 4.5 RAG应用的评估
    • 4.6 Graph RAG应用实战
    • 4.7 第四章课程作业
  • 第五章:综合案例

    • 5.1 应用概览
    • 5.2 用户意图识别模块
    • 5.3 旅游信息检索
    • 5.4 攻略生成模块
    • 5.5 反馈优化模块
    • 5.6 搭配知识集用
    • 5.7 第五章课程作业
  • 附录

    • 支持的模型
    • Loader补充

🛠️ 使用指南

环境要求

  • Python 3.10-3.12

安装CAMEL

pip install "camel-ai[all]==0.2.38"

学习步骤

  1. 阅读文档:访问docs目录或在线文档,按章节顺序学习理论知识
  2. 运行代码:在code目录中找到对应章节的代码文件,按照说明运行实践练习
  3. 完成作业:每章末尾提供的作业可巩固所学知识
  4. 项目实践:综合应用所学内容,实现自己的多智能体系统

🔍 在线阅读

完整教程内容可访问以下链接之一查看:

📅 Roadmap

  • 发布第一版内容内测
  • 飞书内容迁移仓库
  • 更新案例源代码文件
  • 发布第一版内容公测
  • 补充更多实例和新特性讲解

🧑‍💻 参与贡献

  • 如果你想参与项目,欢迎查看 Issue 了解未分配的任务
  • 发现问题请在 Issue 中进行反馈🐛
  • 对项目感兴趣想要参与可以通过 Discussion 进行交流💬
  • 如有任何想法可以联系DataWhale&CAMEL社区开发者

👥 贡献者名单

核心贡献者

主要贡献者

特别感谢@Sm1les对项目的帮助和支持~

📱 关注我们

扫描下方二维码关注公众号:Datawhale

扫描下方二维码关注公众号:CAMEL-AI

📄 LICENSE

知识共享许可协议
本作品采用知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议进行许可。

注:默认使用CC 4.0协议,也可根据自身项目情况选用其他协议