heaven999b/hello-agent-system

它解决了什么问题

大多数智能体教程只展示如何编写一个简单的循环来调用LLM并使用工具。但将智能体部署到有数千人使用的公司中会带来实际问题：模型返回速率限制错误，智能体陷入无限循环浪费资金，用户在文档中隐藏提示注入指令，一个租户的数据泄露到另一个租户的答案中，提示词更改破坏其他场景，或进程在运行中途崩溃。这个项目是一个结构化的培训系统，教你如何解决所有这些生产问题，而不仅仅是制作演示。

它是如何工作的

该项目是一个32节课的双语（中文/英文）训练营。它避免使用任何智能体框架，而是让你从头开始手写生产智能体的每一层。第1部分构建核心异步运行时：智能体循环、工具、上下文管理、架构和编排。第2部分涵盖企业问题卡片，每个问题有2-5个解决方案选项——可靠性、安全性、可观测性、评估、生产架构、高并发、成本、RAG和发布运维。第3部分深入探讨检索质量、记忆系统、MCP、框架比较、智能体数据、评估方法论、优化、编码智能体和主动智能体。第4部分将相同的内部接口替换为成熟的组件，如Postgres、Redis、Temporal、OpenTelemetry、LiteLLM和Cedar，用于实际部署。

每节课都有相同的流程：阅读讲义，运行演示，编写练习，并通过自动化离线确定性测试。从第2课开始，代码是异步的——一个进程服务数百个会话。从第12课开始，它使用真实的多进程执行，包括租约队列、围栏令牌、kill -9接管、SIGSTOP僵尸检测和优雅关闭，所有都在实际进程和信号上验证。最后，你将所有内容组装成一个顶点IT服务台智能体，还可以使用docker-compose或Kubernetes部署。

适合谁

这适合那些已经知道如何从代码调用LLM API，但希望学习如何设计、构建和运维在真实企业环境中可靠、安全且可控的智能体系统的开发者。它适合那些希望超越演示级示例，理解智能体每一层（包括故障模式及如何恢复）的工程师。

亮点

• 32节课，双语（中文/英文），每节都有练习和自动化离线确定性测试。
• 手写智能体运行时：约3,800行核心异步代码加上2,000行分布式模块，不使用任何智能体框架。
• 真实多进程执行：租约队列、围栏、崩溃接管、僵尸工作进程恢复、优雅关闭——全部通过实际进程和信号验证。
• 企业问题卡片：每个主要问题都有2-5个解决方案选项，比较优缺点和适用规模。
• 迁移路径：从SQLite和进程内状态开始，然后在不更改智能体代码的情况下切换到Postgres、Redis、Temporal、OpenTelemetry、LiteLLM和Cedar。
• 顶点项目（ITBuddy）将所有内容整合在一起，外加包含10个安全案例的24个案例评估套件。
• 广泛的参考文档：79个故障模式、199个设计审查清单项、76个面试问题、246个术语表条目，以及生产就绪指南。
• 适用于任何兼容OpenAI的端点（OpenAI、DeepSeek、Qwen、vLLM等），并包含使用脚本化LLM的--offline模式，实现零成本学习。