aliyun/ai-agent-handbook

选用指南

AI 根据 README 整理 · 2026/10/16 21:16:46

目标用户

面向企业级Agent构建与落地场景，适合Agent开发者、架构师、技术负责人、产品与业务负责人、安全质量运维人员及研究者。

查看 README 依据

2025年9月，我们发布了[《AI 原生应用架构白皮书》](https://developer.aliyun.com/ebook/8479)，围绕 AI 原生应用的 DevOps 全生命周期，从架构设计、技术选型、工程实践到运维优化，对概念和重难点进行体系化的拆解，并尝试提供一些解题思路。但随着模型和智能体技术的快速发展，我们发现，市场的关注度已经从快速构建智能体，转向以下三大新挑战： * 工程化挑战：从概率智能到可靠生产力，Agent 能够承担关键任务。 * 规模化挑战：稳定、安全、性能、成本，从单点试验到智能基础设施，Agent 能够被大规模部署。 * 组织化挑战：从 Agent 孤岛到智能组织，Agent 能够进入核心业务流程。 去年的那本白皮书，显然难以应对这些新的诉求。 因此，我们重新梳理了白皮书的架构，希望通过更与时俱进的内容，更高的实践篇幅占比，以及更社区化的协作，为企业选型和内部立项提供参考，并通过开源的方式长期维护该白皮书，持续呈现 AI 原生应用架构的前沿思考和落地实践。 ## 2. 目标读者与收获 本白皮书主要面向企业级 Agent 构建与落地场景。它既适合关注 Agent 开发的工程人员，也适合用于企业内部的技术选型、架构评审、项目立项和跨团队共识建设。 | 读者 | 建议关注 | 你将获得 |

| --- | --- | --- | | Agent / AI 应用开发者 | 构建篇、运行篇、调优篇 | 掌握 Harness、上下文、状态、工具、沙箱、轨迹与评估闭环等核心工程方法。 | | 架构师与平台工程师 | 架构篇、运行篇、治理篇 | 建立从组件、平台责任到生命周期的完整架构视图，形成可扩展的 Agent 基础设施设计。 | | 技术负责人和研发管理者 | 架构篇、治理篇、实践篇 | 判断应用形态、成熟度、投入边界与生产风险，支撑选型、立项和组织协同。 | | 产品与业务负责人 | 调研报告、架构篇、实践篇 | 理解适合 Agent 的任务、人与 Agent 的责任边界，以及从试点走向核心流程的条件。 | | 安全、质量与运维人员 | 运行篇、治理篇、调优篇 | 建立可观测、审计、安全授权、上线验证、持续评估和故障归因机制。 | | 研究者与生态贡献者 | 全书与实践篇 | 了解企业一线问题、工程抽象和开放议题，并参与共同完善行业知识体系。 | 完整阅读后，你将能够： - 从业务目标、任务确定性和风险出发，选择最低充分的 Agent 架构； - 理解 Model 与 Harness 的责任边界，不把所有问题都归因于模型能力； - 设计可持续推进、可中断恢复、可验证完成的 Agent 任务系统；

使用方式

提供在线阅读网站，支持章节导航、搜索、图表放大、明暗主题和阅读位置记忆；本地预览需Node.js 22执行npm命令。

查看 README 依据

# AI Agent Handbook 中文 | [English](./README_EN.md) 按照 Agent 的架构、构建、运行、治理和调优应用生命周期，总结了我们在企业级 Agent 落地过程中的实践经验和体会，若白皮书能对个人学习和企业落地 Agent 起到一点点的促进作用，将是我们莫大的荣幸。 谨以此项目，献给参与 AI 建设的所有同行者们。 [在线阅读](https://aliyun.github.io/ai-agent-handbook/) · [全书目录](https://aliyun.github.io/ai-agent-handbook/contents.html) · [阅读指南](https://aliyun.github.io/ai-agent-handbook/reading-guide.html) 阅读站提供章节导航、中文搜索、图表与图片放大、明暗主题和阅读位置记忆。本地预览可使用 Node.js 22 执行 `npm ci`、`npm run dev`；站点维护与 GitHub Pages 发布方法见[维护说明](https://github.com/aliyun/ai-agent-handbook/blob/main/WEBSITE.md)。 --- ## 1. 白皮书架构与写作背景

部署要求

本地预览需要Node.js 22。

查看 README 依据

# AI Agent Handbook 中文 | [English](./README_EN.md) 按照 Agent 的架构、构建、运行、治理和调优应用生命周期，总结了我们在企业级 Agent 落地过程中的实践经验和体会，若白皮书能对个人学习和企业落地 Agent 起到一点点的促进作用，将是我们莫大的荣幸。 谨以此项目，献给参与 AI 建设的所有同行者们。 [在线阅读](https://aliyun.github.io/ai-agent-handbook/) · [全书目录](https://aliyun.github.io/ai-agent-handbook/contents.html) · [阅读指南](https://aliyun.github.io/ai-agent-handbook/reading-guide.html) 阅读站提供章节导航、中文搜索、图表与图片放大、明暗主题和阅读位置记忆。本地预览可使用 Node.js 22 执行 `npm ci`、`npm run dev`；站点维护与 GitHub Pages 发布方法见[维护说明](https://github.com/aliyun/ai-agent-handbook/blob/main/WEBSITE.md)。 --- ## 1. 白皮书架构与写作背景