深度研究助手项目启动与配置教程

1. 项目目录结构及介绍

本项目是基于文档驱动的深度研究助手，旨在通过持久的上下文管理和工具集成来进行全面的分析。以下是项目的目录结构及其说明：

deep_research_agent/
├── examples/                # 存放示例分析和脚本
├── .deep_research_rules/    # 存放研究规则定义文件
├── executorrules/           # 执行器规则定义文件
├── .executor_agent.py       # 执行器代理模块
├── .planner_agent.py        # 计划器代理模块
├── common.py                # 公共模块，包含通用函数和工具
├── deep_research_agent.py   # 项目主程序文件
├── requirements.txt         # 项目依赖的Python包列表
├── tool_definitions.py      # 工具定义模块
├── tools.py                 # 工具模块，提供各种工具功能
└── README.md                # 项目说明文件

• examples/：包含了一些示例输出，如分析报告、价格趋势图表和分析脚本。
• .deep_research_rules/：存储深度研究规则定义，用于指导研究过程。
• executorrules/：执行器规则定义，用于指导执行器的行为。
• .executor_agent.py：执行器代理模块，负责执行具体任务。
• .planner_agent.py：计划器代理模块，负责生成研究计划。
• common.py：公共模块，提供一些通用的函数和工具。
• deep_research_agent.py：项目的主程序文件，用于启动研究任务。
• requirements.txt：列出项目所需的Python包，用于安装依赖。
• tool_definitions.py：定义了项目中使用的工具。
• tools.py：实现了项目中定义的工具的具体功能。
• README.md：项目说明文件，介绍了项目的目的和使用方法。

2. 项目的启动文件介绍

项目的启动文件是deep_research_agent.py，它是整个研究系统的入口。以下是启动文件的基本功能：

• 初始化研究环境。
• 解析用户输入的研究查询。
• 根据查询生成研究计划。
• 调用执行器代理模块来执行研究任务。
• 输出分析报告。

启动文件的执行通常需要提供一个研究查询字符串，例如：

python3 deep_research_agent.py "Perform a detailed analysis on the recent trend of NVDA stock."

3. 项目的配置文件介绍

项目的配置文件主要包括requirements.txt和.executorrules/、.deep_research_rules/中的规则文件。

• requirements.txt：此文件列出了项目运行所需的Python包，可以使用以下命令安装：

  pip install -r requirements.txt
  

• .executorrules/和.deep_research_rules/：这些目录下的文件定义了执行器和研究过程中的规则，它们用于指导研究系统的行为。根据项目需求，可能需要修改这些规则文件以适应特定的研究场景。