{"id":36647179,"url":"https://github.com/taishan1994/agent-handbook","last_synced_at":"2026-01-12T10:01:50.596Z","repository":{"id":323461732,"uuid":"1093307943","full_name":"taishan1994/Agent-Handbook","owner":"taishan1994","description":"Agent学习笔记。","archived":false,"fork":false,"pushed_at":"2025-12-29T07:52:12.000Z","size":21486,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-01T05:16:32.390Z","etag":null,"topics":["agent-2-agent","cot","mcp","pocketflow","react","reflection"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/taishan1994.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-10T07:40:25.000Z","updated_at":"2025-12-29T07:52:15.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/taishan1994/Agent-Handbook","commit_stats":null,"previous_names":["taishan1994/agent-handbook"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/taishan1994/Agent-Handbook","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taishan1994%2FAgent-Handbook","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taishan1994%2FAgent-Handbook/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taishan1994%2FAgent-Handbook/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taishan1994%2FAgent-Handbook/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/taishan1994","download_url":"https://codeload.github.com/taishan1994/Agent-Handbook/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taishan1994%2FAgent-Handbook/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28337870,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T06:09:07.588Z","status":"ssl_error","status_checked_at":"2026-01-12T06:05:18.301Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-2-agent","cot","mcp","pocketflow","react","reflection"],"created_at":"2026-01-12T10:01:50.439Z","updated_at":"2026-01-12T10:01:50.581Z","avatar_url":"https://github.com/taishan1994.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Agent-Handbook\nAgent学习笔记。\n\n- pocketflow-handbook：使用Pocketflow的官方仓库及示例，构建基础的学习课程。基本上如果对pocketflow比较了解了，后续再去学习langchain或者langgraph等其它的框架就会更简单。\n- pocketflow-adp：基于google的书籍《agentic-design-patterns》，使用pocketflow实现书中不同章节的代码。\n- pocketflow-leetcode：构建一个可以自动写leetcode和测试i的智能体。\n- anthropic-article：学习anthropic发布的有关智能体的文章。\n- pocketflow-law-tag-agent：一个基础的RAG框架，后续优化方法可以基于这个框架进行尝试。\n- mini-agents：对Minimax的Mini-Agents进行拆解，包括工具的使用、mcp的使用、skills的使用以及构建一个可以执行工具、mcp和skills的agent。\n\n# 配套文章\n\n- [一份全面的Agent学习资料，看完了我不信你还不会](https://mp.weixin.qq.com/s/acJA87ciZqxXh07y5cf8Bg)\n- [从零开始构建一个会写leetcode的Agent](https://mp.weixin.qq.com/s/CONB6qRcgYD_RhXzMS_eqw)\n- [终于弄懂了提示词，提示工程和上下文工程](https://mp.weixin.qq.com/s/iAR5EuMqYpMU-BRK3nNjqQ)\n- [25种LLM部署框架你知道多少？](https://mp.weixin.qq.com/s/XEOFUt7wXZm7ZtDcVDls2A)\n- [Agent评测之使用opencompass评测大模型的基础能力](https://mp.weixin.qq.com/s/I3s3Fei0wA-TsRnpSogDtQ)\n- [Agent评测之使用大海捞针评估大模型的上下文长度](https://mp.weixin.qq.com/s/QSQDkLI0xECZeE0yHJiQjQ)\n- [基于大语言模型的智能体优化综述](https://mp.weixin.qq.com/s/FZl2l47TQ98U53MLZA4z6Q)\n- [基于大语言模型的智能体评估综述](https://mp.weixin.qq.com/s/YalQ1xrfpMRKPZUeFrvnag)\n- [【search-o1】大模型的推理](https://mp.weixin.qq.com/s/ISE2k87aiBi4i67wXH1how)\n- [【search-o1】利用RAG进行检索问答](https://mp.weixin.qq.com/s/Eucfjn99wDpcmFmACgywUQ)\n- [【search-o1】利用Agent结合搜索引擎进行问答](https://mp.weixin.qq.com/s/MHc3BdigVvd-oW3Szm2zrQ?poc_token=HJWiz2ijBMxKCEMq2xkCyo8jRJap4chTd0k5vHct)\n- [【search-o1】使用search-o1方法进行智能检索问答](https://mp.weixin.qq.com/s/Um6NKMtypvF2cq7-D_Ya1A)\n- [mini-langchain-chatglm：五分钟实现基于知识的问答](https://mp.weixin.qq.com/s/8qUv2XIzeK36RO9QEUJA3A)\n\n# Agent框架对比\n**主流 AI Agent 框架优缺点对比（截至 2025 年 11 月）**\n\n| 框架 | 优点 | 缺点 |\n|------|------|------|\n| **OpenAI Agents SDK** | - 轻量级、设计简洁\u003cbr\u003e- 原语清晰（Agent 与 Handoff）\u003cbr\u003e- 支持全面的跟踪功能\u003cbr\u003e- 适合快速构建生产级多智能体系统\u003cbr\u003e- 拥有活跃社区（GitHub 1.1万星） | - 对非 OpenAI 模型（如开源或竞品）支持有限\u003cbr\u003e- 生态目前不如 LangChain 等成熟 |\n| **AutoGen（Microsoft Research）** | - 开创了多智能体“群聊”模式\u003cbr\u003e- 支持高度灵活的协作模式\u003cbr\u003e- 适合研究与原型开发 | - 缺乏原生记忆支持\u003cbr\u003e- 扩展性弱\u003cbr\u003e- 企业级部署需额外集成\u003cbr\u003e- 更适合小规模研究项目，不适合大规模生产 |\n| **Microsoft Agent Framework (MAF)** | - 融合 AutoGen 与 Semantic Kernel 的长处\u003cbr\u003e- 提供图式工作流、强类型接口\u003cbr\u003e- 支持企业级功能（安全、可观测性）\u003cbr\u003e- 支持 .NET 与 Python | - 相对较新，社区生态尚在建设中\u003cbr\u003e- 学习曲线略陡 |\n| **CrewAI** | - 完全从零构建、轻量快速\u003cbr\u003e- 强调“角色-目标-任务”驱动的协作\u003cbr\u003e- 可独立于 LangChain\u003cbr\u003e- 适合构建结构化团队式智能体 | - 生态较新，工具链和可视化支持较少\u003cbr\u003e- 不适合需要复杂流程编排的场景 |\n| **Google ADK（Agent Development Kit）** | - 提供开发者 UI、CLI、调试工具链完整\u003cbr\u003e- 支持 Google Agent Protocol\u003cbr\u003e- 便于集成 Google 生态（如 Search、Gemini） | - 内置工具限制多（如每个 Agent 只能绑定一个内置工具）\u003cbr\u003e- 深度绑定 Gemini，跨模型迁移困难 |\n| **MetaGPT** | - 模拟软件公司工作流\u003cbr\u003e- 擅长从单行需求生成完整项目代码\u003cbr\u003e- 适合工程类多智能体协作 | - 依赖 asyncio\u003cbr\u003e- 缺乏可视化构建器\u003cbr\u003e- 对非技术用户不友好 |\n| **Haystack Agents（deepset）** | - 围绕 RAG 构建\u003cbr\u003e- 模块化强\u003cbr\u003e- 适合企业级 NLP 应用（如智能搜索、文档处理） | - 通用智能体编排能力较弱\u003cbr\u003e- 不如 AutoGen / CrewAI 等专为多智能体设计的框架灵活 |\n| **Claude Agent SDK（Anthropic）** | - 专为 Claude 模型优化\u003cbr\u003e- 支持 MCP 工具协议\u003cbr\u003e- 适合构建生产级编码智能体 | - 仅支持 Claude 系列模型\u003cbr\u003e- 目前仅提供 Python 版本\u003cbr\u003e- 长上下文需手动压缩 |\n| **Crawl4AI / Crawl4AI** | - 专为 LLM 优化的网页抓取框架\u003cbr\u003e- 异步高性能\u003cbr\u003e- 输出结构化 Markdown\u003cbr\u003e- 适合构建 Web 数据摄入管道 | - 并非通用智能体框架\u003cbr\u003e- 是特定于数据采集的工具，需与其他框架配合使用 |\n| **LlamaIndex（Agents \u0026 LlamaAgents）** | - 在 RAG 场景下表现卓越\u003cbr\u003e- 数据连接器丰富\u003cbr\u003e- 文档和社区活跃 | - 聚焦数据检索而非通用智能体协作\u003cbr\u003e- 扩展性和通用编排能力有限 |\n| **Semantic Kernel – Agent Orchestration（Microsoft）** | - 多语言支持（.NET / Python / Java）\u003cbr\u003e- 模型无关\u003cbr\u003e- 适合企业级工作流编排\u003cbr\u003e- 支持 Group Chat 等高级模式 | - 抽象层级高，初学者门槛略高\u003cbr\u003e- 需结合其他组件构建完整智能体系统 |\n| **PydanticAI** | - 强类型安全\u003cbr\u003e- 与 Pydantic 深度集成\u003cbr\u003e- 调试能力强（支持 Logfire）\u003cbr\u003e- 适合构建可靠生产应用 | - 较新，生态和工具链尚不成熟\u003cbr\u003e- 社区规模较小 |\n| **Griptape** | - 模块化设计\u003cbr\u003e- 支持记忆、工具、多智能体协作\u003cbr\u003e- 适合构建 LLM 工作流与智能体应用 | - 文档和示例相对较少\u003cbr\u003e- 社区活跃度不如头部框架 |\n| **Flowise Agents** | - 低代码可视化编排\u003cbr\u003e- 适合快速构建 LLM 工作流和简单智能体系统 | - 动态多智能体能力有限\u003cbr\u003e- 不适合复杂协作场景\u003cbr\u003e- 企业集成能力较弱 |\n| **LangChain** | - 快速原型开发能力强\u003cbr\u003e- 支持海量工具与模型集成（包括本地/私有模型）\u003cbr\u003e- 成熟的 RAG 与 Agent 支持\u003cbr\u003e- 拥有最广泛的社区与教程资源 | - 抽象层级高，学习曲线陡峭\u003cbr\u003e- 调优与性能优化较复杂\u003cbr\u003e- 在大型项目中带来治理和调试负担 |\n| **LangGraph** | - 提供状态化、可持久记忆的多智能体工作流\u003cbr\u003e- 基于图结构，支持循环、分支、暂停/恢复等高级控制流\u003cbr\u003e- 与 LangChain 深度集成，适合构建复杂代理系统\u003cbr\u003e- 支持节点级超时、重试等生产级特性 | - 需要熟悉图式编程范式\u003cbr\u003e- 对简单任务而言可能过度设计\u003cbr\u003e- 部分高级功能需依赖 LangSmith 等商业组件 |\n| **DeepAgents** | - 基于 LangChain/LangGraph 构建的高级代理框架\u003cbr\u003e- 内置规划、待办事项（TODOs）、文件系统支持\u003cbr\u003e- 支持子代理（subagents）与中间件，实现职责隔离\u003cbr\u003e- 支持真实 Web 搜索与上下文卸载 | - 相对新，生态和文档仍在完善\u003cbr\u003e- 强依赖 LangChain 技术栈，学习成本叠加\u003cbr\u003e- 更适合“深度推理”场景，不适合轻量级任务 |\n| **PocketFlow** | - 极简设计（约 100 行核心代码）\u003cbr\u003e- 无依赖、无厂商锁定\u003cbr\u003e- 基于图结构，支持多智能体、RAG、任务分解等\u003cbr\u003e- 非常适合教学、原型验证与 AI 编码代理辅助开发 | - 功能高度精简，缺少企业级特性（如可观测性、安全控制）\u003cbr\u003e- 社区规模小，扩展能力有限\u003cbr\u003e- 需自行实现高级功能（如记忆、评估） |\n| **smolagents（Hugging Face）** | - 轻量级（核心代码约 1000 行）\u003cbr\u003e- 首类支持“代码即动作”的 Code Agent\u003cbr\u003e- 与 Hugging Face 生态无缝集成（模型、数据集、Space）\u003cbr\u003e- 开发体验简洁，适合快速部署 | - 功能聚焦特定范式（代码生成型代理）\u003cbr\u003e- 缺乏复杂的多智能体协调机制\u003cbr\u003e- 企业级部署能力尚未成熟 |\n| **HelloAgents** | - 专为教学与学习设计，代码透明、结构清晰\u003cbr\u003e- 基于 OpenAI 原生 API 从零构建，深入讲解 Agent 核心原理\u003cbr\u003e- 包含完整教程（《从零开始构建智能体》），适合入门者 | - 非生产级框架，功能有限\u003cbr\u003e- 仅支持 OpenAI 模型，扩展性弱\u003cbr\u003e- 社区主要用于教育，不适合工业部署 |\n\n\u003e **具体使用**：  \n\u003e - **企业级复杂系统**推荐：Microsoft Agent Framework、LangGraph、DeepAgents、Semantic Kernel。  \n\u003e - **研究与快速原型**推荐：AutoGen、CrewAI、LangChain、smolagents。  \n\u003e - **极简/教学用途**推荐：PocketFlow、HelloAgents。  \n\u003e - **特定能力突出**：Crawl4AI（数据抓取）、Claude SDK（编码代理）、Haystack（RAG 智能体）。  \n\u003e 实际选型应结合模型生态、团队技能栈、部署环境与可维护性综合评估。","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaishan1994%2Fagent-handbook","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftaishan1994%2Fagent-handbook","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaishan1994%2Fagent-handbook/lists"}