mirror of
https://github.com/tvytlx/ai-agent-deep-dive.git
synced 2026-04-03 07:34:50 +08:00
1.5 KiB
1.5 KiB
AI Agent Deep Dive
Quick Links
PDF 下载 / PDF Report:
Notes
- 本仓库仅保留面向学习与评论的分析材料，不提供源码目录。
- 第二版 PDF 已完成。
Teaching Agent Code
这个仓库现在还包含一个教学用的最小 Python Agent 项目，用于演示一个 AI Agent 的核心结构应该怎么组织。
核心代码位置
- Agent 核心代码：
src/agt/agent.py - CLI 入口：
src/agt/cli.py - 教学文档：
docs/
这个教学项目的定位
这个最小 Agent 项目是为了教学而设计的，特点是：
- 尽量保持结构清晰
- 尽量减少不必要的工程复杂度
- 所有核心代码集中在一个很小的范围内，方便学习
- 当前重点放在：Agent 主循环、Fake LLM 接口、Skills 发现、CLI 骨架
如何运行最小 Agent
本项目使用 Poetry 管理依赖。
1. 安装依赖
poetry install
2. 运行最小 Agent CLI
poetry run agt "你好"
3. 查看 Skills
poetry run agt --skills-dir ./skills --list-skills
当前实现说明
当前版本是一个教学型最小实现，还没有接入真实远程模型 API。
目前内置的是一个可替换的 Fake LLM：
- 用户输入什么
- 它就会用流式文本块的方式返回一个测试响应
这样做的目的，是为了让后续接入真实模型时，只需要替换 LLM 调用层，而不需要重写整个 Agent 主体。