用途:ai-agent-deep-dive 是一个教学导向的 Python 项目,从零演示如何构建最小化 AI Agent,适合在学习 Agent 架构、构建生产系统之前理解其必要组件。
主要能力:包含核心 Agent 循环实现、可替换的 LLM 接口(当前使用假 LLM 用于教学)、技能发现与加载系统、CLI 交互界面,以及关于 AI Agent 架构的教学文档与报告。项目结构含 src/agt/agent.py(核心循环与执行逻辑)、src/agt/cli.py(命令行入口)、skills/ 技能模块目录、docs/ 教学文档。
使用方式:项目用 Poetry 管理依赖。安装命令为 git clone https://github.com/tvytlx/ai-agent-deep-dive.git、cd ai-agent-deep-dive、poetry install,验证用 poetry run agt --help。基本用法:poetry run agt "hello world";列出技能:poetry run agt --skills-dir ./skills --list-skills;指定技能目录:poetry run agt --skills-dir /path/to/skills "your query"。CLI 选项包括位置参数 query、--skills-dir(默认 ./skills)、--list-skills。也可通过代码调用 Agent 类,如 from agt.agent import Agent 后 agent.run(query)。技能为放入技能目录的 Python 模块,可附带 SKILL_METADATA 元数据。
适用场景:学习 Agent 架构、教学演示、作为生产 Agent 的架构基础参考。
限制:当前使用假 LLM,仅演示结构,不产生真实模型输出;要用于生产需自行替换为真实 API 调用、补充错误处理与重试、记忆/上下文管理、函数调用、日志与监控等。文档提及的 PDF 报告与部分配置项(如 verbose、max_iterations)的具体行为暂未提供更多细节。