Eino: Cookbook
本文档为 eino-examples 项目的示例索引，帮助开发者快速找到所需的示例代码。
GitHub 仓库: https://github.com/cloudwego/eino-examples
📦 ADK (Agent Development Kit)
Hello World
| 目录 | 名称 | 说明 |
| adk/helloworld | Hello World Agent | 最简单的 Agent 示例，展示如何创建一个基础的对话 Agent |
入门示例 (Intro)
| 目录 | 名称 | 说明 |
| adk/intro/chatmodel | ChatModel Agent | 展示如何使用 ChatModelAgent 并配合 Interrupt 机制 |
| adk/intro/custom | 自定义 Agent | 展示如何实现符合 ADK 定义的自定义 Agent |
| adk/intro/workflow/loop | Loop Agent | 展示如何使用 LoopAgent 实现循环反思模式 |
| adk/intro/workflow/parallel | Parallel Agent | 展示如何使用 ParallelAgent 实现并行执行 |
| adk/intro/workflow/sequential | Sequential Agent | 展示如何使用 SequentialAgent 实现顺序执行 |
| adk/intro/session | Session 管理 | 展示如何通过 Session 在多个 Agent 之间传递数据和状态 |
| adk/intro/transfer | Agent 转移 | 展示 ChatModelAgent 的 Transfer 能力，实现 Agent 间的任务转移 |
| adk/intro/agent_with_summarization | 带摘要的 Agent | 展示如何为 Agent 添加对话摘要功能 |
| adk/intro/http-sse-service | HTTP SSE 服务 | 展示如何将 ADK Runner 暴露为支持 Server-Sent Events 的 HTTP 服务 |
Human-in-the-Loop (人机协作)
| 目录 | 名称 | 说明 |
| adk/human-in-the-loop/1_approval | 审批模式 | 展示敏感操作前的人工审批机制，Agent 执行前需用户确认 |
| adk/human-in-the-loop/2_review-and-edit | 审核编辑模式 | 展示工具调用参数的人工审核和编辑，支持修改、批准或拒绝 |
| adk/human-in-the-loop/3_feedback-loop | 反馈循环模式 | 多 Agent 协作，Writer 生成内容，Reviewer 收集人工反馈，支持迭代优化 |
| adk/human-in-the-loop/4_follow-up | 追问模式 | 智能识别信息缺失，通过多轮追问收集用户需求，完成复杂任务规划 |
| adk/human-in-the-loop/5_supervisor | Supervisor + 审批 | Supervisor 多 Agent 模式结合审批机制，敏感操作需人工确认 |
| adk/human-in-the-loop/6_plan-execute-replan | 计划执行重规划 + 审核编辑 | Plan-Execute-Replan 模式结合参数审核编辑，支持预订参数修改 |
| adk/human-in-the-loop/7_deep-agents | Deep Agents + 追问 | Deep Agents 模式结合追问机制，在分析前主动收集用户偏好 |
| adk/human-in-the-loop/8_supervisor-plan-execute | 嵌套多 Agent + 审批 | Supervisor 嵌套 Plan-Execute-Replan 子 Agent，支持深层嵌套中断 |
Multi-Agent (多 Agent 协作)
| 目录 | 名称 | 说明 |
| adk/multiagent/supervisor | Supervisor Agent | 基础的 Supervisor 多 Agent 模式，协调多个子 Agent 完成任务 |
| adk/multiagent/layered-supervisor | 分层 Supervisor | 多层 Supervisor 嵌套，一个 Supervisor 作为另一个的子 Agent |
| adk/multiagent/plan-execute-replan | Plan-Execute-Replan | 计划-执行-重规划模式，支持动态调整执行计划 |
| adk/multiagent/integration-project-manager | 项目管理器 | 使用 Supervisor 模式的项目管理示例，包含 Coder、Researcher、Reviewer |
| adk/multiagent/deep | Deep Agents (Excel Agent) | 智能 Excel 助手，分步骤理解和处理 Excel 文件，支持 Python 代码执行 |
| adk/multiagent/integration-excel-agent | Excel Agent (ADK 集成版) | ADK 集成版 Excel Agent，包含 Planner、Executor、Replanner、Reporter |
GraphTool (图工具)
| 目录 | 名称 | 说明 |
| adk/common/tool/graphtool | GraphTool 包 | 将 Graph/Chain/Workflow 封装为 Agent 工具的工具包 |
| adk/common/tool/graphtool/examples/1_chain_summarize | Chain 文档摘要 | 使用 compose.Chain 实现文档摘要工具 |
| adk/common/tool/graphtool/examples/2_graph_research | Graph 多源研究 | 使用 compose.Graph 实现并行多源搜索和流式输出 |
| adk/common/tool/graphtool/examples/3_workflow_order | Workflow 订单处理 | 使用 compose.Workflow 实现订单处理，结合审批机制 |
| adk/common/tool/graphtool/examples/4_nested_interrupt | 嵌套中断 | 展示外层审批和内层风控的双层中断机制 |
🔗 Compose (编排)
Chain (链式编排)
| 目录 | 名称 | 说明 |
| compose/chain | Chain 基础示例 | 展示如何使用 compose.Chain 进行顺序编排，包含 Prompt + ChatModel |
Graph (图编排)
| 目录 | 名称 | 说明 |
| compose/graph/simple | 简单 Graph | Graph 基础用法示例 |
| compose/graph/state | State Graph | 带状态的 Graph 示例 |
| compose/graph/tool_call_agent | Tool Call Agent | 使用 Graph 构建工具调用 Agent |
| compose/graph/tool_call_once | 单次工具调用 | 展示单次工具调用的 Graph 实现 |
| compose/graph/two_model_chat | 双模型对话 | 两个模型相互对话的 Graph 示例 |
| compose/graph/async_node | 异步节点 | 展示异步 Lambda 节点，包含报告生成和实时转录场景 |
| compose/graph/react_with_interrupt | ReAct + 中断 | 票务预订场景，展示 Interrupt 和 Checkpoint 实践 |
Workflow (工作流编排)
| 目录 | 名称 | 说明 |
| compose/workflow/1_simple | 简单 Workflow | 最简单的 Workflow 示例，等价于 Graph |
| compose/workflow/2_field_mapping | 字段映射 | 展示 Workflow 的字段映射功能 |
| compose/workflow/3_data_only | 纯数据流 | 仅数据流的 Workflow 示例 |
| compose/workflow/4_control_only_branch | 控制流分支 | 仅控制流的分支示例 |
| compose/workflow/5_static_values | 静态值 | 展示如何在 Workflow 中使用静态值 |
| compose/workflow/6_stream_field_map | 流式字段映射 | 流式场景下的字段映射 |
Batch (批处理)
| 目录 | 名称 | 说明 |
| compose/batch | BatchNode | 批量处理组件，支持并发控制、中断恢复，适用于文档批量审核等场景 |
🌊 Flow (流程模块)
ReAct Agent
| 目录 | 名称 | 说明 |
| flow/agent/react | ReAct Agent | ReAct Agent 基础示例，餐厅推荐场景 |
| flow/agent/react/memory_example | 短期记忆 | ReAct Agent 的短期记忆实现，支持内存和 Redis 存储 |
| flow/agent/react/dynamic_option_example | 动态选项 | 运行时动态修改 Model Option，控制思考模式和工具选择 |
| flow/agent/react/unknown_tool_handler_example | 未知工具处理 | 处理模型幻觉产生的未知工具调用，提高 Agent 鲁棒性 |
Multi-Agent
| 目录 | 名称 | 说明 |
| flow/agent/multiagent/host/journal | 日记助手 | Host Multi-Agent 示例，支持写日记、读日记、根据日记回答问题 |
| flow/agent/multiagent/plan_execute | Plan-Execute | 计划执行模式的 Multi-Agent 示例 |
完整应用示例
| 目录 | 名称 | 说明 |
| flow/agent/manus | Manus Agent | 基于 Eino 实现的 Manus Agent，参考 OpenManus 项目 |
| flow/agent/deer-go | Deer-Go | 参考 deer-flow 的 Go 语言实现，支持研究团队协作的状态图流转 |
🧩 Components (组件)
Model (模型)
| 目录 | 名称 | 说明 |
| components/model/abtest | A/B 测试路由 | 动态路由 ChatModel，支持 A/B 测试和模型切换 |
| components/model/httptransport | HTTP 传输日志 | cURL 风格的 HTTP 请求日志记录，支持流式响应和敏感信息脱敏 |
Retriever (检索器)
| 目录 | 名称 | 说明 |
| components/retriever/multiquery | 多查询检索 | 使用 LLM 生成多个查询变体，提高检索召回率 |
| components/retriever/router | 路由检索 | 根据查询内容动态路由到不同的检索器 |
Tool (工具)
| 目录 | 名称 | 说明 |
| components/tool/jsonschema | JSON Schema 工具 | 展示如何使用 JSON Schema 定义工具参数 |
| components/tool/mcptool/callresulthandler | MCP 工具结果处理 | 展示 MCP 工具调用结果的自定义处理 |
| components/tool/middlewares/errorremover | 错误移除中间件 | 工具调用错误处理中间件，将错误转换为友好提示 |
| components/tool/middlewares/jsonfix | JSON 修复中间件 | 修复 LLM 生成的格式错误 JSON 参数 |
Document (文档)
| 目录 | 名称 | 说明 |
| components/document/parser/customparser | 自定义解析器 | 展示如何实现自定义文档解析器 |
| components/document/parser/extparser | 扩展解析器 | 使用扩展解析器处理 HTML 等格式 |
| components/document/parser/textparser | 文本解析器 | 基础文本文档解析器示例 |
Prompt (提示词)
| 目录 | 名称 | 说明 |
| components/prompt/chat_prompt | Chat Prompt | 展示如何使用 Chat Prompt 模板 |
Lambda
| 目录 | 名称 | 说明 |
| components/lambda | Lambda 组件 | Lambda 函数组件的使用示例 |
🚀 QuickStart (快速开始)
| 目录 | 名称 | 说明 |
| quickstart/chat | Chat 快速开始 | 最基础的 LLM 对话示例，包含模板、生成、流式输出 |
| quickstart/eino_assistant | Eino 助手 | 完整的 RAG 应用示例，包含知识索引、Agent 服务、Web 界面 |
| quickstart/todoagent | Todo Agent | 简单的 Todo 管理 Agent 示例 |
🛠️ DevOps (开发运维)
| 目录 | 名称 | 说明 |
| devops/debug | 调试工具 | 展示如何使用 Eino 的调试功能，支持 Chain 和 Graph 调试 |
| devops/visualize | 可视化工具 | 将 Graph/Chain/Workflow 渲染为 Mermaid 图表 |
📚 相关资源
- Eino 框架: https://github.com/cloudwego/eino
- Eino 扩展组件: https://github.com/cloudwego/eino-ext
- 官方文档: https://www.cloudwego.io/zh/docs/eino/