Skip to content

n3xtchen/nAgent

Repository files navigation

nAgent

个人智能代理项目。

项目结构

项目采用 uv workspace 进行管理,分为应用 (apps/) 和库 (libs/)。

核心库 (libs/)

  • nagent-core: 核心代理逻辑,包含 ReActAgent 和工具基类。
  • nagent-rag: RAG 相关组件,包含各类 Retriever 和检索工具封装。

应用 (apps/)

  • agentic-rag: 基于智能体循环的 RAG 应用,支持自主检索决策。
  • nagent: (旧版/其他) 代理应用。

文档与规范 (docs/)

  • docs/: 存放项目设计文档、API 参考和迁移指南。
  • devlogs/: 存放每日开发日志和复盘记录(不进入版本控制)。

快速开始

  1. 安装依赖:

    uv sync
  2. 运行测试:

    uv run pytest

Agentic RAG 验证工具

项目包含通用的验证框架,用于支持配置文件驱动的验证工作流。

快速验证

# 运行默认验证程序(使用 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

更多信息

文档目录

About

个人智能代理

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors