个人智能代理项目。
项目采用 uv workspace 进行管理,分为应用 (apps/) 和库 (libs/)。
nagent-core: 核心代理逻辑,包含ReActAgent和工具基类。nagent-rag: RAG 相关组件,包含各类 Retriever 和检索工具封装。
agentic-rag: 基于智能体循环的 RAG 应用,支持自主检索决策。nagent: (旧版/其他) 代理应用。
docs/: 存放项目设计文档、API 参考和迁移指南。devlogs/: 存放每日开发日志和复盘记录(不进入版本控制)。
-
安装依赖:
uv sync
-
运行测试:
uv run pytest
项目包含通用的验证框架,用于支持配置文件驱动的验证工作流。
# 运行默认验证程序(使用 examples/validation/calculator.json)
uv run python -m agentic_rag.validation_runner
# 指定自定义配置文件
uv run python -m agentic_rag.validation_runner --config examples/validation/calculator.json
# 指定输出目录和 RAG 类型 (agentic 或 simple)
uv run python -m agentic_rag.validation_runner --output my_output_dir --rag_type simple# 运行框架验证脚本
uv run python verify_validation.py