[!IMPORTANT] 版本说明：本文档基于作者开发实战经验创作，将不定期持续更新。作者母语为中文，目前主要面向中国大陆、港澳台地区，以及新加坡等国家的技术人士；若国际读者需求较多，后续再考虑推出完整英文版。

🌐 English readers: start from the English landing page.

项目简介

这是一个纯文档项目，专注于 AI Agent 后端开发的核心知识点。每章都是一篇独立成文的技术文章，覆盖：

这本手册和其他教程的区别：

🎯 目标读者：具备一定编程基础的开发者。全书以 「工业界标准 → 为什么课堂不教 → 你应该怎么写」 为叙事线。

学习路线

flowchart LR
    subgraph DEV ["🛠️ 开发篇"]
        direction LR
        A["🏗️ 第1章<br/>技术选型"] --> B["📐 第2章<br/>开发基本要求"] --> C["🧩 第3章<br/>模块开发"] --> D["🤖 第4章<br/>Agent 通路"]
    end
    subgraph OPS ["🚀 测试与运维篇"]
        direction LR
        E["🧪 第5章<br/>系统测试"] --> F["🖥️ 第6章<br/>AI Infra 基座"]
    end
    D --> E

快速开始

# 克隆项目
git clone https://github.com/ADW-19/build_a_product_agent.git
cd build_a_product_agent

# 阅读顺序建议（按上图路线）
# 1. 第1章：技术选型（了解整体技术栈）
# 2. 第2章：开发基本要求（编码规范）
# 3. 第3章：模块开发（深入实现细节）
# 4. 第4章：Agent通路（单Agent与多Agent协作）
# 5. 第5章：系统测试（上线前的测试体系）
# 6. 第6章：AI Infra 基座（模型部署与选型）

内容总览

技术栈

版本是"校对当日的基线快照"，不是下限声明。 生态半年就会前移一代（LangChain 1.x 已把 chains/retrievers 迁到 langchain-classic，create_react_agent 已弃用，pymilvus 3.x 要求改用 MilvusClient），请对照自己的锁定版本核对 API，不要只看版本号。

基线（校对于 2026-09）

领域	选型	基线	备注
语言		3.14（3.13 亦可）	3.13 的 bugfix 窗口 2026-10 结束，之后仅安全修复
Web 框架		0.141
Agent 编排		1.2	set_entry_point、create_react_agent 均已弃用
LLM 工具层		1.4	新 Agent 用 langchain.agents.create_agent
数据校验		2.13	v2 写法（model_dump()）
业务数据库		16+
缓存 / 会话 / 限流		8+ / Stack	checkpointer 依赖 RediSearch + RedisJSON
向量库（长期记忆）		2.6+ / pymilvus 3.x	新代码用 MilvusClient，不用已弃用的 ORM 写法
消息队列		4.x	quorum 队列不支持 x-max-priority

协议层（第 1 章）：

• MCP（Model Context Protocol）——Agent 连工具与上下文，2025-12 起由 Linux Foundation 的 Agentic AI Foundation 托管；
• A2A（Agent2Agent）——Agent 连 Agent，规范基线 1.0.0（校对 2026-09）。

两者互补而非竞品："MCP 连工具、A2A 连 Agent"。

[!NOTE] 示例中的模型与单价只作占位。 模型生命周期很短——例如 gpt-4o 已于 2026-02 从 ChatGPT 退役、Azure 侧 2026-10-01 退役——手册里的模型 ID（gpt-5.1 / gpt-5-mini / claude-sonnet-4-6）与价格请在上线前对照厂商的模型生命周期页核对，并把模型 ID 收敛到配置里，不要散落在业务代码中。

目录结构

docs/
├── 01-首页/
│   ├── README.md
│   └── README-en.md
│
├── 02-生产级开发-通用知识/
│   ├── 第1章：技术选型/
│   │   ├── 01-技术选型.md
│   │   ├── 02-中间件选型.md
│   │   ├── 03-协议与架构模式选型.md
│   │   └── 04-运维架构选型.md
│   │
│   ├── 第2章：开发基本要求/
│   │   └── 01-开发习惯.md
│   │
│   ├── 第3章：模块开发/
│   │   ├── 01-对话接口（流式+非流式参数切换，session_id隔离，接口异步高性能处理）.md
│   │   ├── 02-长期记忆与短期记忆.md
│   │   ├── 03-工具开发.md
│   │   ├── 04-工作流.md
│   │   └── 05-RAG系统.md
│   │
│   └── 第4章：Agent通路/
│       ├── 01-单Agent系统通路.md
│       └── 02-Multi-Agent协作机制（A2A协议）.md
│
├── 03-生产级测试-系统测试/
│   └── 第5章：系统测试/
│       ├── 01-Agent上线前常用的系统测试方法.md
│       └── 02-RAG系统测试.md
│
└── 04-生产级AI Infra-基座与运维/
    └── 第6章：AI Infra基础知识/
        ├── 01-模型底座运维基础知识与架构选型.md
        └── 02-模型选型-不同智能体如何搭配底层模型.md

👤 作者与社区

欢迎通过 Issue 提出建议、勘误，或直接提交 PR。

许可证