ai-agent-deep-dive README

The project's README from github.com/tvytlx/ai-agent-deep-dive. As one markdown file: README.md.

AI Agent Deep Dive

Star History Chart

PDF 下载 / PDF Report:

Notes

Teaching Agent Code

这个仓库现在还包含一个教学用的最小 Python Agent 项目,用于演示一个 AI Agent 的核心结构应该怎么组织。

核心代码位置

这个教学项目的定位

这个最小 Agent 项目是为了教学而设计的,特点是:

如何运行最小 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 主体。

ai-agent-deep-dive (tvytlx/ai-agent-deep-dive)

Searching Database…

这是什么?一个包含深度研究报告(PDF)的合集,分析 ClaudeCode、Hermes Agent 等 AI Agent 的内部源代码;同一仓库中还新增了一个以教学为目的的小型 Python Agent 项目。
这只是一份可以阅读的报告,还是也有可以运行的代码?两者都有:仓库的大部分内容是 PDF 分析报告,但现在也附带了一个精简、可运行的 Python Agent(src/agt/),使用 Poetry 构建,纯粹用于讲解 AI Agent 的核心结构是如何组织的。
怎样运行这个教学用的 Agent?先用 Poetry 安装项目依赖,然后通过 src/agt/cli.py 这个 CLI 入口启动这个最小化的 Agent。
要试用这个教学 Agent,需要真正的大模型 API 密钥吗?不需要。当前版本只是用于教学的最小化实现,尚未接入真实的远程模型 API;它附带的是一个可替换的 Fake LLM(模拟大模型)。
仓库是否包含被分析的原始源代码(例如 ClaudeCode 自身的代码)?不包含。仓库只保留供学习和研讨使用的分析与评注材料,不包含被分析项目自身的源代码目录。
这些研究具体覆盖了哪些 AI Agent?报告深入分析了 ClaudeCode(v2 和 v2.1,其中 v2.1 增加了一章关于其记忆系统的内容),并包括一篇较新的 Hermes Agent 深度解析。
这个最小化教学 Agent 目前重点讲解什么?它围绕 Agent 的主循环、Fake LLM 接口、Skills 发现机制以及基础的 CLI 骨架展开,为了便于阅读而刻意保持精简。
教学项目为什么用 Fake LLM,而不直接用真实模型?这样以后接入真实模型时,只需替换大模型调用层,而无需重写 Agent 的其余部分。
所有研究内容都可以免费下载吗?仓库中的大多数 PDF 报告都直接提供下载链接,但至少有一篇最新的报告(关于 Hermes Agent)仅在作者的付费知识星球社区“矩阵之外”内分享。
Creator
tvytlx
Size
14.4 MB
Stars
5.8K
Updated
CommitSep 16
Age
6mo
Commits · 90 Days