从零实战项目

本目录给出 6 个可从零实现的 Agent 项目。每个项目都按工程交付物来写：目标、最小可行版本、目录结构、关键组件、工具 schema、状态/记忆/RAG 设计、评测、安全和迭代路线。

1. 项目索引

项目	练习重点	建议前置章节
01-个人知识库 Agent	RAG、引用、权限、反馈	06-RAG与知识系统
02-MCP 工具型 Agent	MCP server、工具 schema、审批	04-工具调用体系
03-企业文档问答 Agent	多租户文档、ACL、评测	05-记忆系统
04-代码审查 Agent	仓库读取、diff 分析、PR 评论	09-Agent工程化
05-数据分析 Agent	SQL、Notebook、图表、权限	10-Agent评测体系
06-多 Agent 研究助手	Supervisor、研究、评审、引用	08-多Agent系统

2. 推荐统一技术骨架

agent-app/
  app/
    agents/          # Agent 编排和提示词
    tools/           # 工具实现和 schema
    policies/        # 权限、审批、护栏
    stores/          # 状态、记忆、索引、数据库
    evals/           # 评测样本、评审器、报告
    api/             # Web/API 层
  tests/
  docs/

3. 通用验收标准

• 能完成明确的端到端任务，而不是只有聊天界面。
• 每个工具都有 schema、风险等级、错误处理和 trace。
• 关键动作能回放，失败能定位到模型、工具、检索、权限或状态。
• 至少有 20 条离线评测样本，包含正常、边界和安全样例。
• 写操作默认需要预览或确认。

4. 权威资料

• OpenAI Agents SDK: https://platform.openai.com/docs/guides/agents-sdk/ （核对日期：2026-05-09）
• Model Context Protocol documentation: https://modelcontextprotocol.io/docs （核对日期：2026-05-09）
• LangGraph documentation: https://langchain-ai.github.io/langgraph/ （核对日期：2026-05-09）
• LlamaIndex documentation: https://docs.llamaindex.ai
• OWASP Top 10 for LLM Applications: https://owasp.org/www-project-top-10-for-large-language-model-applications/ （核对日期：2026-05-09）