docs(eino): update eino adk documents

content/zh/docs/eino/core_modules/eino_adk/agent_extension.md

@@ -1,23 +1,35 @@
 ---
 Description: ""
-date: "2025-08-06"
+date: "2025-09-30"
 lastmod: ""
 tags: []
-title: 'Eino ADK: Agent 扩展'
-weight: 3
+title: 'Eino ADK: Agent Runner 与扩展'
+weight: 6
 ---
 
-# Agent Runner
+## Agent Runner
 
-Runner 是 Eino ADK 中负责执行 Agent 的核心引擎。它的主要作用是管理和控制 Agent 的整个生命周期，如处理多 Agent 协作，保存传递上下文等，interrupt、callback 等切面能力也均依赖 Runner 实现。任何 Agent 都应通过 Runner 来运行。
+### 定义
 
-# Interrupt & Resume
+Runner 是 Eino ADK 中负责执行 Agent 的核心引擎。它的主要作用是管理和控制 Agent 的整个生命周期，如处理多 Agent 协作，保存传递上下文等，interrupt、callback 等切面能力也均依赖 Runner 实现。
 
-该功能允许一个正在运行的 Agent 主动中断其执行，保存当前状态，并在稍后从中断点恢复执行。这对于处理需要外部输入、长时间等待或可暂停的任务流非常有用。
+任何 Agent 都应通过 Runner 来运行。
 
-## Interrupted Action
+### Interrupt & Resume
 
-在 Agent 的执行过程中，可以通过产生包含 Interrupted Action 的 AgentEvent 来主动中断 Runner 的运行：
+Agent Runner 提供运行时中断与恢复的功能，该功能允许一个正在运行的 Agent 主动中断其执行并保存当前状态，支持从中断点恢复执行。该功能常用于 Agent 处理流程中需要外部输入、长时间等待或可暂停等场景。
+
+下面将对一次中断到恢复过程中的三个关键点进行介绍：
+
+1. Interrupted Action：由 Agent 抛出中断事件，Agent Runner 拦截
+2. Checkpoint：Agent Runner 拦截事件后保存当前运行状态
+3. Resume：运行条件重新 ready 后，由 Agent Runner 从断点恢复运行
+
+### Interrupted Action
+
+在 Agent 的执行过程中，可以通过产生包含 Interrupted Action 的 AgentEvent 来主动中断 Runner 的运行。
+
+当 Event 中的 Interrupted 不为空时，Agent Runner 便会认为发生中断：
 
 ```go
 // github.com/cloudwego/eino/adk/interface.go
@@ -38,7 +50,16 @@ type InterruptInfo struct {
 1. 会被传递给调用者，可以通过该信息向调用者说明中断原因等
 2. 如果后续需要恢复 Agent 运行，InterruptInfo 会在恢复时重新传递给中断的 Agent，Agent 可以依据该信息恢复运行
 
-## 状态持久化 (Checkpoint)
+```go
+// 例如 ChatModelAgent 中断时，会发送如下的 AgentEvent：
+h.Send(&AgentEvent{AgentName: h.agentName, Action: &AgentAction{
+    Interrupted: &InterruptInfo{
+       Data: &ChatModelAgentInterruptInfo{Data: data, Info: info},
+    },
+}})
+```
+
+### 状态持久化 (Checkpoint)
 
 当 Runner 捕获到这个带有 Interrupted Action 的 Event 时，会立即终止当前的执行流程。 如果：
 
@@ -70,7 +91,7 @@ Runner 在终止运行后会将当前运行状态（原始输入、对话历史
 > 💡
 > 为了保存 interface 中数据的原本类型，Eino ADK 使用 gob（[https://pkg.go.dev/encoding/gob](https://pkg.go.dev/encoding/gob)）序列化运行状态。因此在使用自定义类型时需要提前使用 gob.Register 或 gob.RegisterName 注册类型（更推荐后者，前者使用路径加类型名作为默认名字，因此类型的位置和名字均不能发生变更）。Eino 会自动注册框架内置的类型。
 
-## Resume
+### Resume
 
 运行中断，调用 Runner 的 Resume 接口传入中断时的 CheckPointID 可以恢复运行：
 
@@ -97,7 +118,3 @@ type ResumeInfo struct {
 ```
 
 Resume 如果向 Agent 传入新信息，可以定义 AgentRunOption，在调用 Runner.Resume 时传入。
-
-# Callback
-
-TODO

content/zh/docs/eino/core_modules/eino_adk/agent_implementation/_index.md

@@ -1,12 +1,12 @@
 ---
 Description: ""
-date: "2025-08-06"
+date: "2025-09-30"
 lastmod: ""
 tags: []
 title: 'Eino ADK: Agent 实现'
-weight: 4
+weight: 5
 ---
 
 用户可以通过实现 Agent 接口自定义 Agent。自定义 Agent 建议严格遵守上述规则，在应用、迭代、合作中可以带来便利。
 
-简单自定义 Agent 可以参考： github.com/cloudwego/eino-examples/adk/intro/custom/myagent.go
+简单自定义 Agent 可以参考： [https://github.com/cloudwego/eino-examples/blob/main/adk/intro/custom/myagent.go](https://github.com/cloudwego/eino-examples/blob/main/adk/intro/custom/myagent.go)