Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -120,7 +120,7 @@ For scenarios requiring multi-turn interaction (chat applications, continuous co
- **Stop**: Stop the event loop
- **Declarative Checkpoint/Resume**: TurnLoop automatically manages input bookkeeping; the application layer only needs to declare the recovery strategy

See: [Agent Cancel and TurnLoop Quickstart](/docs/eino/core_modules/eino_adk/eino_adk_agent_cancel_and_turnloop_quickstart)
See: [Agent Cancel and TurnLoop Quickstart](/docs/eino/core_modules/eino_adk/agent_cancel_and_turnloop_quickstart)

# Agent Cancel

Expand All @@ -130,4 +130,4 @@ Runtime cancellation capability added in v0.9, supporting:
- **CancelHandle.Wait()**: Wait for cancellation to complete
- **Integration with TurnLoop**: Automatically triggers Cancel on Preempt

See: [Agent Cancel and TurnLoop Quickstart](/docs/eino/core_modules/eino_adk/eino_adk_agent_cancel_and_turnloop_quickstart)
See: [Agent Cancel and TurnLoop Quickstart](/docs/eino/core_modules/eino_adk/agent_cancel_and_turnloop_quickstart)
Original file line number Diff line number Diff line change
Expand Up @@ -294,7 +294,7 @@ agent, _ := adk.NewChatModelAgent(ctx, &adk.ChatModelAgentConfig{

# Cancel

New runtime cancellation capability added in v0.9. See [Agent Cancel and TurnLoop](/docs/eino/core_modules/eino_adk/eino_adk_agent_cancel_and_turnloop_quickstart) for details.
New runtime cancellation capability added in v0.9. See [Agent Cancel and TurnLoop](/docs/eino/core_modules/eino_adk/agent_cancel_and_turnloop_quickstart) for details.

```go
cancelOpt, cancelFn := adk.WithCancel()
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,7 @@ Request-level Agent configuration. ADK built-in options:

- `WithSessionValues(map[string]any)`: Inject KV data shared across Agents
- `WithCallbacks(...callbacks.Handler)`: Add callback handlers
- `WithCancel()`: Enable Agent Cancel capability (see [Cancel and TurnLoop](/docs/eino/core_modules/eino_adk/eino_adk_agent_cancel_and_turnloop_quickstart))
- `WithCancel()`: Enable Agent Cancel capability (see [Cancel and TurnLoop](/docs/eino/core_modules/eino_adk/agent_cancel_and_turnloop_quickstart))

Custom Options:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -77,4 +77,4 @@ runner := adk.NewRunner(ctx, adk.RunnerConfig{
iter := runner.Query(ctx, "Your question")
```

See: [Agent Runner and Extension](/docs/eino/core_modules/eino_adk/agent_extension) | [Agent Cancel and TurnLoop](/docs/eino/core_modules/eino_adk/eino_adk_agent_cancel_and_turnloop_quickstart)
See: [Agent Runner and Extension](/docs/eino/core_modules/eino_adk/agent_extension) | [Agent Cancel and TurnLoop](/docs/eino/core_modules/eino_adk/agent_cancel_and_turnloop_quickstart)
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ go get github.com/cloudwego/eino@latest
<tr><td><strong>ChatModelAgent</strong></td><td>ReAct Loop: Reasoning → Action → Feedback, autonomous decision-making</td><td><a href="/docs/eino/overview/eino_adk_quickstart">ChatModelAgent Introduction</a></td></tr>
<tr><td><strong>Middleware</strong></td><td>Inject behavior at lifecycle points of the ReAct Loop (compression, search, retry, etc.)</td><td><a href="/docs/eino/core_modules/eino_adk/eino_adk_chatmodelagentmiddleware">ChatModelAgentMiddleware</a></td></tr>
<tr><td><strong>Runner</strong></td><td>Single Agent run entry: Query / Run → event stream</td><td><a href="/docs/eino/core_modules/eino_adk/agent_extension">Agent Runner and Extension</a></td></tr>
<tr><td><strong>TurnLoop</strong></td><td>Multi-turn runtime: Push / Preempt / Stop + declarative checkpoint/resume</td><td><a href="/docs/eino/core_modules/eino_adk/eino_adk_agent_cancel_and_turnloop_quickstart">Agent Cancel and TurnLoop</a></td></tr>
<tr><td><strong>TurnLoop</strong></td><td>Multi-turn runtime: Push / Preempt / Stop + declarative checkpoint/resume</td><td><a href="/docs/eino/core_modules/eino_adk/agent_cancel_and_turnloop_quickstart">Agent Cancel and TurnLoop</a></td></tr>
<tr><td><strong>DeepAgents</strong></td><td>Pre-built Agent: task planning (PlanTask) + subtask delegation (TaskTool)</td><td><a href="/docs/eino/core_modules/eino_adk/agent_implementation/deepagents">DeepAgents</a></td></tr>
</table>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ V0.9 systematically enhances `ChatModelAgent`'s execution control, model call re
- Introduces Agent Cancel capability for externally terminating a running Agent.
- Supports safe-point cancellation, recursive cancellation, cancel timeout escalation, and checkpoint persistence during cancellation.
- Interrupts that occur during cancellation are unified under cancel semantics; callers can distinguish active cancellation from normal business failures via `CancelError`.
- [Eino ADK: Agent Cancel and TurnLoop Quick Start](/docs/eino/core_modules/eino_adk/eino_adk_agent_cancel_and_turnloop_quickstart)
- [Eino ADK: Agent Cancel and TurnLoop Quick Start](/docs/eino/core_modules/eino_adk/agent_cancel_and_turnloop_quickstart)

### Model Retry

Expand Down Expand Up @@ -63,7 +63,7 @@ V0.9 introduces `TurnLoop` to elevate a one-shot Agent run into a continuously r
- Supports input merging: `GenInput` decides at the turn boundary which inputs to consume in this turn and which to continue waiting for, enabling applications to implement batching, deduplication, merging of consecutive user inputs, and other strategies.
- Supports preemption: `Push` with a preempt option atomically writes new input and requests cancellation of the current turn, allowing high-priority input to interrupt a running Agent.
- Supports declarative checkpoint/resume: on recovery, applications don't need to manually restore the input queue; `TurnLoop` distinguishes between interrupted inputs, unprocessed inputs, and newly arrived inputs after recovery—applications only need to declare how these inputs re-enter subsequent turns.
- [Eino ADK: Agent Cancel and TurnLoop Quick Start](/docs/eino/core_modules/eino_adk/eino_adk_agent_cancel_and_turnloop_quickstart)
- [Eino ADK: Agent Cancel and TurnLoop Quick Start](/docs/eino/core_modules/eino_adk/agent_cancel_and_turnloop_quickstart)

## Upgrade Guide

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -120,7 +120,7 @@ type TypedResumableAgent[M MessageType] interface {
- **Stop**:停止事件循环
- **声明式 Checkpoint/Resume**:TurnLoop 自动管理输入 bookkeeping,应用层只需声明恢复策略

详见:[Agent Cancel 与 TurnLoop 快速入门](/zh/docs/eino/core_modules/eino_adk/eino_adk_agent_cancel_and_turnloop_quickstart)
详见:[Agent Cancel 与 TurnLoop 快速入门](/zh/docs/eino/core_modules/eino_adk/agent_cancel_and_turnloop_quickstart)

# Agent Cancel

Expand All @@ -130,4 +130,4 @@ v0.9 新增的运行时取消能力,支持:
- **CancelHandle.Wait()**:等待取消完成
- **与 TurnLoop 集成**:Preempt 时自动触发 Cancel

详见:[Agent Cancel 与 TurnLoop 快速入门](/zh/docs/eino/core_modules/eino_adk/eino_adk_agent_cancel_and_turnloop_quickstart)
详见:[Agent Cancel 与 TurnLoop 快速入门](/zh/docs/eino/core_modules/eino_adk/agent_cancel_and_turnloop_quickstart)
Original file line number Diff line number Diff line change
Expand Up @@ -294,7 +294,7 @@ agent, _ := adk.NewChatModelAgent(ctx, &adk.ChatModelAgentConfig{

# Cancel

v0.9 新增的运行时取消能力。详见 [Agent Cancel 与 TurnLoop](/zh/docs/eino/core_modules/eino_adk/eino_adk_agent_cancel_and_turnloop_quickstart)。
v0.9 新增的运行时取消能力。详见 [Agent Cancel 与 TurnLoop](/zh/docs/eino/core_modules/eino_adk/agent_cancel_and_turnloop_quickstart)。

```go
cancelOpt, cancelFn := adk.WithCancel()
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,7 @@ type AgentAction struct {

- `WithSessionValues(map[string]any)`:注入跨 Agent 共享的 KV 数据
- `WithCallbacks(...callbacks.Handler)`:添加回调处理器
- `WithCancel()`:启用 Agent Cancel 能力(详见 [Cancel 与 TurnLoop](/zh/docs/eino/core_modules/eino_adk/eino_adk_agent_cancel_and_turnloop_quickstart))
- `WithCancel()`:启用 Agent Cancel 能力(详见 [Cancel 与 TurnLoop](/zh/docs/eino/core_modules/eino_adk/agent_cancel_and_turnloop_quickstart))

自定义 Option:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -77,4 +77,4 @@ runner := adk.NewRunner(ctx, adk.RunnerConfig{
iter := runner.Query(ctx, "你的问题")
```

详见:[Agent Runner 与扩展](/zh/docs/eino/core_modules/eino_adk/agent_extension) | [Agent Cancel 与 TurnLoop](/zh/docs/eino/core_modules/eino_adk/eino_adk_agent_cancel_and_turnloop_quickstart)
详见:[Agent Runner 与扩展](/zh/docs/eino/core_modules/eino_adk/agent_extension) | [Agent Cancel 与 TurnLoop](/zh/docs/eino/core_modules/eino_adk/agent_cancel_and_turnloop_quickstart)
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ go get github.com/cloudwego/eino@latest
<tr><td><strong>ChatModelAgent</strong></td><td>ReAct Loop:推理 → 行动 → 反馈,自主决策</td><td><a href="/zh/docs/eino/overview/eino_adk_quickstart">ChatModelAgent 介绍</a></td></tr>
<tr><td><strong>Middleware</strong></td><td>在 ReAct Loop 的生命周期点位注入行为(压缩、搜索、重试等)</td><td><a href="/zh/docs/eino/core_modules/eino_adk/eino_adk_chatmodelagentmiddleware">ChatModelAgentMiddleware</a></td></tr>
<tr><td><strong>Runner</strong></td><td>单次 Agent 运行入口:Query / Run → 事件流</td><td><a href="/zh/docs/eino/core_modules/eino_adk/agent_extension">Agent Runner 与扩展</a></td></tr>
<tr><td><strong>TurnLoop</strong></td><td>多轮运行时:Push / Preempt / Stop + 声明式 checkpoint/resume</td><td><a href="/zh/docs/eino/core_modules/eino_adk/eino_adk_agent_cancel_and_turnloop_quickstart">Agent Cancel 与 TurnLoop</a></td></tr>
<tr><td><strong>TurnLoop</strong></td><td>多轮运行时:Push / Preempt / Stop + 声明式 checkpoint/resume</td><td><a href="/zh/docs/eino/core_modules/eino_adk/agent_cancel_and_turnloop_quickstart">Agent Cancel 与 TurnLoop</a></td></tr>
<tr><td><strong>DeepAgents</strong></td><td>预构建 Agent:任务规划(PlanTask)+ 子任务委派(TaskTool)</td><td><a href="/zh/docs/eino/core_modules/eino_adk/agent_implementation/deepagents">DeepAgents</a></td></tr>
</table>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ V0.9 对 `ChatModelAgent` 的运行控制、模型调用可靠性和 middleware
- 新增 Agent Cancel 能力,用于从外部主动终止正在运行的 Agent。
- 支持安全点取消、递归取消、取消超时升级,以及取消过程中的 checkpoint 持久化。
- 取消期间发生的 interrupt 会统一进入取消语义,调用方可以通过 `CancelError` 区分主动取消与普通业务失败。
- [Eino ADK: Agent Cancel 与 TurnLoop 快速入门](/zh/docs/eino/core_modules/eino_adk/eino_adk_agent_cancel_and_turnloop_quickstart)
- [Eino ADK: Agent Cancel 与 TurnLoop 快速入门](/zh/docs/eino/core_modules/eino_adk/agent_cancel_and_turnloop_quickstart)

### Model Retry

Expand Down Expand Up @@ -63,7 +63,7 @@ V0.9 新增 `TurnLoop`,用于把一次性的 Agent run 提升为可持续运
- 支持输入合并:`GenInput` 在 turn 边界决定本轮消费哪些输入、哪些继续等待,应用可以实现批处理、去重、合并用户连续输入等策略。
- 支持抢占:带 preempt option 的 `Push` 会原子地写入新输入并请求取消当前 turn,使高优先级输入可以打断正在运行的 Agent。
- 支持声明式 checkpoint/resume:恢复时,应用不需要自行还原输入队列;`TurnLoop` 会区分被中断的输入、尚未处理的输入和恢复后新到达的输入,应用只需声明这些输入如何重新进入后续 turn。
- [Eino ADK: Agent Cancel 与 TurnLoop 快速入门](/zh/docs/eino/core_modules/eino_adk/eino_adk_agent_cancel_and_turnloop_quickstart)
- [Eino ADK: Agent Cancel 与 TurnLoop 快速入门](/zh/docs/eino/core_modules/eino_adk/agent_cancel_and_turnloop_quickstart)

## 升级方式

Expand Down
Loading