毕业设计：构建多智能体应用

原文：Hello-Agents · 第十六章 毕业设计 · 在线阅读

一句话

通过开源项目形式构建并分享自己的多智能体应用，将所学知识融会贯通。

什么时候翻这页

当你完成Hello-Agents教程前15章学习，准备动手实践构建自己的多智能体应用时。

核心概念

• 毕业设计：独立设计并实现一个完整的智能体应用，将所学知识整合到项目中
• 开源项目：通过GitHub提交代码，参与社区协作开发
• ReAct：一种智能体范式，结合推理(Reasoning)和行动(Acting)
• 工具系统：智能体使用工具扩展能力的方式
• 记忆机制：智能体保存和利用历史信息的能力
• 通信协议：智能体之间交换信息的方式

怎么做

1. 项目选题

• 选题原则：实用性、解决真实问题、在有限时间和资源内可完成、清晰展示技术能力
• 推荐选题方向：
  • 生产力工具类：智能代码审查助手、智能文档生成器、智能会议助手、智能邮件助手
  • 学习辅助类：智能学习伙伴、智能论文助手、智能编程导师、智能语言学习助手
  • 创意娱乐类：智能故事生成器、智能游戏NPC、智能音乐推荐、智能菜谱助手
  • 数据分析类：智能数据分析师、智能股票分析、智能舆情监控、智能竞品分析
  • 生活服务类：智能健康助手、智能理财助手、智能购物助手、智能家居控制

2. 开发环境准备

• 安装必要工具：

  # 安装HelloAgents
  pip install "hello-agents[all]"
  
  # 安装Jupyter Notebook
  pip install jupyter notebook
  
  # 或使用JupyterLab（推荐）
  pip install jupyterlab
  

• 配置Git和GitHub
• Fork项目仓库并创建开发分支
• 设置项目目录结构

3. 项目开发

• 编写README文档（项目介绍、核心功能、技术栈、快速开始、使用示例等）
• 编写requirements.txt（列出项目所需的所有Python依赖）
• 开发Jupyter Notebook（项目介绍、环境配置、工具定义、智能体构建、功能演示等）
• 测试项目（确保代码正常运行、文档完整、有清晰使用示例等）
• 处理大文件（使用外部链接、创建独立仓库或使用示例数据）

4. 提交Pull Request

• 提交代码到GitHub
• 创建Pull Request（遵循特定格式：[毕业设计] 项目名称 - 简短描述）
• 填写PR信息（项目信息、简介、核心功能、技术亮点等）
• 响应Review意见并修改代码

命令 / 代码速查

Git命令

# 检查Git版本
git --version

# 配置Git用户信息
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

# 生成SSH密钥
ssh-keygen -t ed25519 -C "你的邮箱"

# 克隆仓库
git clone git@github.com:你的用户名/hello-agents.git

# 添加上游仓库
git remote add upstream https://github.com/datawhalechina/hello-agents.git

# 创建并切换到新分支
git checkout -b feature/你的项目名称

# 提交代码
git add .
git commit -m "feat: 添加XXX毕业设计项目"
git push origin feature/你的项目名称

项目结构

你的用户名-项目名称/
├── README.md              # 项目说明文档
├── requirements.txt       # Python依赖列表
├── main.ipynb            # 主要的Jupyter Notebook
├── data/                 # 数据文件（可选）
├── outputs/              # 输出结果（可选）
├── src/                  # 源代码（可选）
└── .gitignore            # Git忽略规则

Jupyter Notebook结构

# ========================================
# 第1部分:项目介绍
# ========================================

"""
# 项目名称

## 项目简介
简要介绍项目的目标和功能

## 作者信息
- 姓名:XXX
- GitHub:@XXX
- 日期:2025-XX-XX
"""

# ========================================
# 第2部分:环境配置
# ========================================

# 安装依赖
!pip install -q hello-agents[all]

# 导入必要的库
from hello_agents import SimpleAgent, HelloAgentsLLM
from hello_agents.tools import BaseTool
import os
from dotenv import load_dotenv

# 加载环境变量
load_dotenv()

# ========================================
# 第3部分:工具定义
# ========================================

class CustomTool(BaseTool):
    """自定义工具类"""

    name = "tool_name"
    description = "工具描述"

    def run(self, query: str) -> str:
        """工具执行逻辑"""
        # 实现你的工具逻辑
        return "结果"

# ========================================
# 第4部分:智能体构建
# ========================================

# 创建LLM
llm = HelloAgentsLLM()

# 创建智能体
agent = SimpleAgent(
    name="智能体名称",
    llm=llm,
    system_prompt="系统提示词"
)

# 添加工具
agent.add_tool(CustomTool())

# ========================================
# 第5部分:功能演示
# ========================================

# 示例1:基础功能
print("=== 示例1:基础功能 ===")
result = agent.run("用户输入")
print(result)

# 示例2:复杂场景
print("\n=== 示例2:复杂场景 ===")
result = agent.run("复杂的用户输入")
print(result)

与 Python / Claude Code 手册的联系

• 使用Python进行项目开发，依赖管理(requirements.txt)
• 使用Claude Code进行代码审查和优化
• 结合HelloAgents框架构建智能体系统

初学者易错点

• 项目过大：保持项目总大小不超过5MB，避免直接提交视频文件、大型数据集、模型文件
• 文档不完整：README文档应包含项目介绍、核心功能、技术栈、快速开始等关键信息
• 代码不规范：遵循PEP 8规范，添加适当注释
• 忽略测试：确保代码能够正常运行，处理常见异常情况
• PR格式错误：PR标题必须遵循[毕业设计] 项目名称 - 简短描述的格式

相关词条

• ReAct：智能体推理与行动范式
• 工具系统：智能体使用工具扩展能力
• 记忆机制：智能体保存和利用历史信息
• 通信协议：智能体之间交换信息的方式
• HelloAgents框架：构建智能体的核心框架