aliyun/ai-agent-handbook

这是什么？

核心功能

• 01覆盖 Agent 从架构、构建到运行、治理和调优的全生命周期。
• 02讲解 Harness 设计、上下文与状态管理、基于 MCP 和 A2A 的工具接入以及权限控制。
• 03介绍运行时与沙箱、AI 网关流量治理以及多 Agent 通信。
• 04包含可观测性、安全、AI 资产管理和上线前模拟验证等章节。
• 05收录汽车、零售、研发效能和互联网等行业的企业实践案例。
• 06提供带章节导航和中文搜索的在线阅读站点。

适用场景

• 架构师在确定企业 Agent 平台设计前参考整体架构与取舍。
• 工程师将 Agent 原型推向生产环境时查阅状态管理、网关和可观测性方面的做法。
• 团队为内部 AI Agent 建立治理、安全审查和评估流程。
• 高校或培训机构希望获取中文企业 Agent 工程参考教材。

快速上手

1. 1

   克隆仓库

2. 2

   使用 Node.js 22 安装依赖

   npm ci
3. 3

   启动本地预览服务

   npm run dev

使用前须知

• !这是一本中文手册，大部分内容为中文。
• !它是阅读材料而非可直接调用的软件库或应用程序。

收录于专题

标签

常见问题

ai-agent-handbook 是什么？

阿里云出品的中文企业级 AI Agent 实践手册，覆盖构建、运行、治理与调优全生命周期。 这是一本开源的企业级 AI Agent 长篇手册，按架构、构建、运行、治理、调优五个阶段组织内容，覆盖 Agent 从设计到上线运维的完整生命周期。内容汇集了阿里云、云上企业客户和开源社区开发者在 Agent 落地中的实践经验与教训。

ai-agent-handbook 可以免费使用吗？用的什么许可证？

ai-agent-handbook 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

ai-agent-handbook 还在维护吗？

活跃维护中。ai-agent-handbook 最近一次提交是在 2026年11月6日。

ai-agent-handbook 适合用来做什么？

架构师在确定企业 Agent 平台设计前参考整体架构与取舍。 工程师将 Agent 原型推向生产环境时查阅状态管理、网关和可观测性方面的做法。 团队为内部 AI Agent 建立治理、安全审查和评估流程。 高校或培训机构希望获取中文企业 Agent 工程参考教材。

ai-agent-handbook 怎么安装和运行？

克隆仓库 使用 Node.js 22 安装依赖: npm ci 启动本地预览服务: npm run dev

在哪里获取 ai-agent-handbook？

源代码和安装说明在 GitHub 上：https://github.com/aliyun/ai-agent-handbook