---
tags: [eino, llm-framework, golang, agent, ai]
create time: 2026-04-29 21:30
---

# Eino 知识索引

## 概述

Eino 是字节跳动（CloudWeGo）开源的大模型应用开发框架，基于 Go 语言。覆盖从组件定义、流程编排到 DevOps 工具链的全流程。本文档作为知识索引，列举 Eino 的关键概念与使用入口，后续可基于此构建知识问答。

---

## 一、是什么 —— Eino 核心定位

| 维度 | 说明 |
|------|------|
| **语言** | Go（强类型，编译时类型检查） |
| **定位** | 大模型应用开发框架，覆盖全流程 |
| **仓库** | [github.com/cloudwego/eino](https://github.com/cloudwego/eino) + [eino-ext](https://github.com/cloudwego/eino-ext) |
| **特色** | 组件抽象 → 图编排 → ADK Agent → DevOps 工具链，层层递进 |
| **适用场景** | 从简单对话到复杂 Multi-Agent 系统，均可应对 |

> [!question] 思考：为什么选 Go 而不是 Python？强类型在大模型应用规模化后能带来什么收益？

---

## 二、怎么分层 —— Eino 架构分层

```mermaid
graph TD
    A["Eino 框架"] --> B["组件层 Components"]
    A --> C["编排层 Orchestration"]
    A --> D["ADK 层 Agent 开发套件"]
    A --> E["工具层 DevOps"]

    B --> B1["ChatModel"]
    B --> B2["ChatTemplate"]
    B --> B3["Tool / ToolsNode"]
    B --> B4["Retriever"]
    B --> B5["Document Loader"]
    B --> B6["Embedding / Indexer"]
    B --> B7["Lambda 自定义"]

    C --> C1["Chain 链式"]
    C --> C2["Graph 有向图"]
    C --> C3["Workflow 字段映射"]
    C --> C4["Stream 流处理"]
    C --> C5["Callback 横切面"]

    D --> D1["Agent 接口"]
    D --> D2["ChatModelAgent ReAct"]
    D --> D3["WorkflowAgents"]
    D --> D4["Multi-Agent 范式"]
    D --> D5["Middleware 中间件"]

    E --> E1["Tracing 链路追踪"]
    E --> E2["IDE 插件 / 可视化"]
    E --> E3["Debug 调试"]
```

---

## 三、怎么用 —— 快速上手路径

### 3.1 入门四步走

| 步骤 | 主题 | 入口文档 |
|------|------|----------|
| **Step 1** | ChatModel 与 Message：学会调模型 | [[Eino/quick_start/chapter_01_chatmodel_and_message]] |
| **Step 2** | ChatModelAgent + Runner + AgentEvent：学会跑 Agent | [[Eino/quick_start/chapter_02_chatmodelagent_runner_agentevent]] |
| **Step 3** | Memory & Session：让 Agent 有记忆 | [[Eino/quick_start/chapter_03_memory_and_session]] |
| **Step 4** | Tool & FileSystem：让 Agent 能干活 | [[Eino/quick_start/chapter_04_tool_and_filesystem]] |

### 3.2 进阶专题

| 主题 | 关键内容 | 入口文档 |
|------|----------|----------|
| **Middleware** | 横切面注入，PlanTask / Summarization / Skill 等内置中间件 | [[Eino/quick_start/chapter_05_middleware]] |
| **Callback & Trace** | 执行过程可观测、可追踪 | [[Eino/quick_start/chapter_06_callback_and_trace]] |
| **Interrupt & Resume** | Human-in-the-loop，断点续跑 | [[Eino/quick_start/chapter_07_interrupt_resume]] |
| **Graph & Tool** | 低代码编排，图即是工具 | [[Eino/quick_start/chapter_08_graph_tool]] |
| **A2UI Protocol** | Agent 生成 UI 协议 | [[chapter_10_a2ui_protocol]] |
| **Skill Console** | 技能注册与管理 | [[Eino/quick_start/chapter_09_skill_console]] |

---

## 四、关键概念清单

### 4.1 组件 Component

| 组件 | 职责 | 为什么需要 |
|------|------|-----------|
| **ChatModel** | 与大模型交互的核心接口 | 统一不同模型（OpenAI / Ark / Gemini）的调用方式 |
| **ChatTemplate** | 构造 Prompt 模板 | 将变量注入系统/用户消息，结构化管理 |
| **Tool / ToolsNode** | 可被模型调用的工具 | 让 LLM 从"只会说"变成"能执行" |
| **Retriever** | 检索外部知识 | RAG 的核心，给模型注入上下文 |
| **Document Loader** | 加载各类文档 | 将 PDF / Markdown / 网页等转为可处理文本 |
| **Embedding / Indexer** | 向量化 + 索引 | 语义检索基础 |
| **Lambda** | 自定义函数作为组件 | 当现有组件不满足需求时，自由扩展 |

> [!question] 思考：Lambda 和 Tool 的区别是什么？什么场景用哪个？

### 4.2 编排 Orchestration

| 编排方式 | 特点 | 适用场景 |
|----------|------|----------|
| **Chain** | 简单的顺序执行，有向无环 | 线性 Pipeline |
| **Graph** | 有向图（可含环），灵活分支控制 | ReAct Agent 等复杂路由 |
| **Workflow** | 字段级别的数据映射与传递 | 抖音场景：字段粒度的图映射 |

额外能力：
- **Stream 流处理**：自动处理流式输入输出，支持流的复制、合并、拼接
- **Callback 横切面**：在组件执行前后注入逻辑（日志、追踪、统计）
- **编译时类型检查**：Graph Compile 时验证节点类型对齐，而非运行时才发现

### 4.3 ADK —— Agent 开发套件

#### Agent 接口（统一抽象）

```go
type Agent interface {
    Name(ctx context.Context) string
    Description(ctx context.Context) string
    Run(ctx context.Context, input *AgentInput, options ...AgentRunOption) *AsyncIterator[*AgentEvent]
}
```

三个核心要素：**身份（Name）** + **职责（Description）** + **标准化执行（Run → AsyncIterator）**

#### Agent 类型全景

```mermaid
graph LR
    A["Agent 接口"] --> B["ChatModelAgent\nReAct 模式"]
    A --> C["WorkflowAgents\n流程编排"]
    A --> D["Multi-Agent\n协作范式"]
    A --> E["自定义 Agent\n实现接口"]

    C --> C1["Sequential\n顺序执行"]
    C --> C2["Parallel\n并发执行"]
    C --> C3["Loop\n循环执行"]

    D --> D1["Supervisor\n集中式协调"]
    D --> D2["Plan-Execute\n规划-执行-反思"]
    D --> D3["DeepAgents\n规划驱动集中协作"]
```

| Agent 类型 | 一句话描述 | 典型场景 |
|------------|-----------|----------|
| **ChatModelAgent** | 基于 ReAct 的思考-行动循环 | 需要模型自主决策和工具调用的场景 |
| **SequentialAgent** | 按顺序依次执行子 Agent | ETL 流水线、CI/CD |
| **ParallelAgent** | 多个子 Agent 并发执行 | 多源数据采集、多渠道推送 |
| **LoopAgent** | 循环执行直到满足退出条件 | 数据同步、迭代优化 |
| **Supervisor** | 中心调度，统一分配与汇总 | 科研项目管理、客服流程 |
| **Plan-Execute** | Planner → Executor → Replanner 闭环 | Excel 处理、多步骤推理 |
| **DeepAgents** | Main Agent + WriteTodos + TaskTool | 长流程阶段性管理、多角色协作 |

#### Agent 协作机制

| 机制 | 使用方式 | 适用场景 |
|------|---------|----------|
| **History** | 框架自动传递前序 Agent 输出 | Agent 间默认信息流 |
| **Shared Session** | KV 存储，`GetSessionValue` / `AddSessionValue` | 跨 Agent 共享状态 |
| **Transfer（移交）** | `NewTransferToAgentAction` 将任务移交子 Agent | 边界清晰的层级式分工 |
| **ToolCall（工具调用）** | `NewAgentTool` 将 Agent 封装为 Tool | 仅需参数、无需完整上下文时 |

#### 中断与恢复

- Agent 运行时通过 `Interrupt Action` 主动中断
- `CheckPointStore` 保存断点状态
- `Resume` 方法携带新信息从断点恢复
- 适用场景：需要外部输入、人工审批、长时等待

#### Middleware 中间件体系

| 内置中间件 | 功能 |
|------------|------|
| **PlanTask** | 任务规划与拆解 |
| **Summarization** | 上下文摘要压缩 |
| **ToolSearch** | 动态工具搜索与选择 |
| **ToolReduction** | 工具调用结果精简 |
| **Skill** | 技能注册与匹配 |
| **FileSystem** | 文件读写能力注入 |
| **PatchToolCalls** | 工具调用修正 |

---

## 五、实战案例索引

| 案例 | 核心知识点 | 入口文档 |
|------|-----------|----------|
| **ReAct Agent** | Graph 编排 + Tool 调用 | [[Eino/docs/overview/eino_open_source]] |
| **Excel Agent** | Plan-Execute + Multi-Agent + CodeAgent | [[Eino/docs/overview/eino_adk_excel_agent]] |
| **项目管理 Agent** | Supervisor + 中断恢复 + Transfer | [[Eino/docs/overview/eino_adk0_1]] |
| **字节内部实践** | 豆包、抖音等真实场景 | [[Eino/docs/overview/bytedance_eino_practice]] |

---

## 六、进阶对比与选型

| 对比维度 | Eino | LangChain / LlamaIndex |
|----------|------|------------------------|
| **语言** | Go（强类型） | Python（动态类型） |
| **类型安全** | 编译时校验 | 运行时才发现 |
| **长期维护** | 类型系统天然可维护 | 动态语言大型项目维护成本高 |
| **并发模型** | goroutine 原生并发 | asyncio / 多线程 |
| **编排能力** | Graph + Workflow 双模式 | LCEL + Graph |
| **Agent 框架** | ADK 统一抽象 + 多种范式 | LangGraph Agent |

> [!question] 思考：Eino 的 Graph vs Agent，什么时候直接用 Graph，什么时候用 ADK Agent？

---

## 七、版本演进速览

| 版本 | 关键变化 |
|------|----------|
| **v0.1** | 首个开源版本，核心组件 + Chain/Graph |
| **v0.2** | Callback 体系完善 |
| **v0.3** | 小幅 break change |
| **v0.4** | Compose 优化 |
| **v0.5** | ADK 实现 |
| **v0.6** | JSON Schema 优化 |
| **v0.7** | Interrupt/Resume 重构 |
| **v0.8** | ADK Middleware 体系 |

---

## 八、外部资源

- 项目主页：[https://www.cloudwego.io](https://www.cloudwego.io)
- GitHub：[https://github.com/cloudwego/eino](https://github.com/cloudwego/eino)
- 扩展库：[https://github.com/cloudwego/eino-ext](https://github.com/cloudwego/eino-ext)
- 示例：[https://github.com/cloudwego/eino-examples](https://github.com/cloudwego/eino-examples)
- 文档：[https://www.cloudwego.io/zh/docs/eino/](https://www.cloudwego.io/zh/docs/eino/)

---

## 关联笔记

- [[Eino/docs/overview/eino_open_source]] — 开源发布文
- [[Eino/docs/overview/eino_adk0_1]] — ADK 设计模式详解
- [[Eino/docs/overview/eino_adk_excel_agent]] — Excel Agent 实战
- [[Eino/quick_start/README]] — 快速开始总览