# 知识文档与 AI Agent 工程实践库 本目录汇总了 AI Agent 企业级应用落地、架构规范、机制原理等核心学习资料，并配套了 12 周实战学习计划与验证代码。 --- ## 核心资料与在线阅读站 ### 1. 《AI Agent Handbook · 企业级智能体架构与工程实践》 - **出品方**：阿里云智能团队（Alibaba Cloud） - **官方在线阅读站**：[https://aliyun.github.io/ai-agent-handbook/](https://aliyun.github.io/ai-agent-handbook/) *(推荐优先查阅，体验完整排版与交互)* - **GitHub 开源仓库**：[aliyun/ai-agent-handbook](https://github.com/aliyun/ai-agent-handbook)（开源协议：Apache-2.0） - **说明**：正文只维护在仓库 Markdown 中，由 VitePress 发布到阅读站。2026-10-19 的 396 页本地 PDF 已删除，不再作为离线存档。 ### 2. 《深入理解 AI Agent：设计原理与工程实践》 - **作者**：李博杰 - **开源仓库**：[bojieli/ai-agent-book](https://github.com/bojieli/ai-agent-book) - **本地文件**：`./深入理解 AI Agent - 设计原理与工程实践.pdf`（306 页） - **定位**：机制原理深潜材料，侧重上下文工程、模型决策、工具协议、记忆检索、评估与后训练等底层机理。 --- ## 在线访问 学习看板与文档已过备案并启用 HTTPS：****（HTTP 自动 301 跳转 HTTPS）。 | 入口 | 地址 | | --- | --- | | 学习看板首页 | | | 12 周学习计划 | | | 资料索引 | | | 行迹名录 | | 服务端由 `xu`（120.46.25.185）上的 nginx 托管，根目录 `/var/www/ai-agent-learn`，证书由 certbot 自动续期（certbot.timer）。 --- ## 目录结构索引 ```text docs/ ├── README.md # 本索引说明文件 ├── AI-Agent-企业应用学习计划.md # 12 周企业级应用工程实践学习路线（紧贴大厂岗位技能信号） ├── 深入理解 AI Agent - 设计原理与工程实践.pdf # 李博杰著 Agent 机制设计参考书 ├── 水务行业用户画像分析子系统技术规范书.docx # 业务实战规范文档（对接 ../water/ 项目） ├── code/ # 学习计划配套实践与消融实验代码库 │ ├── README.md # 代码库环境与运行说明 │ └── week01/ # 第 1 周实战：原生 ReAct 循环与上下文消融实验 └── traces/ # 可视化展示前端模块（行迹名录页面） ``` --- ## 使用与学习建议 1. **学习主线**：以 `AI-Agent-企业应用学习计划.md` 为核心驱动，覆盖“业务任务 → Contract → 执行编排 → 上下文与能力 → 受控行动 → 治理 → 评估调优 → 规模化交付”全链路。 2. **理论对照**： - 宏观工程架构与生命周期参考阿里《AI Agent Handbook》：[在线阅读站](https://aliyun.github.io/ai-agent-handbook/)，[仓库](https://github.com/aliyun/ai-agent-handbook)。 - 机制细节与算法原理解析参考李博杰《深入理解 AI Agent》。 3. **动手实践**： - 实践代码位于 `code/` 目录下，建议在独立 Python 3.10+ 虚拟环境下运行。 - 每周实验遵循“修改前后对比”的消融实验原则（可参考 `code/week01/day04/`）。