vault backup: 2026-04-29 18:36:58
This commit is contained in:
@@ -0,0 +1,308 @@
|
||||
---
|
||||
Description: ""
|
||||
date: "2026-03-10"
|
||||
lastmod: ""
|
||||
tags: []
|
||||
title: Eino v0.8 不兼容更新
|
||||
weight: 1
|
||||
---
|
||||
|
||||
## 1. API 不兼容变更
|
||||
|
||||
### 1.1 filesystem Shell 接口重命名
|
||||
|
||||
**位置**: `adk/filesystem/backend.go` **变更描述**: Shell 相关接口被重命名，且不再嵌入 `Backend` 接口。**Before (v0.7.x)**:
|
||||
|
||||
```go
|
||||
type ShellBackend interface {
|
||||
Backend
|
||||
Execute(ctx context.Context, input *ExecuteRequest) (result *ExecuteResponse, err error)
|
||||
}
|
||||
|
||||
type StreamingShellBackend interface {
|
||||
Backend
|
||||
ExecuteStreaming(ctx context.Context, input *ExecuteRequest) (result *schema.StreamReader[*ExecuteResponse], err error)
|
||||
}
|
||||
```
|
||||
|
||||
**After (v0.8.0)**:
|
||||
|
||||
```go
|
||||
type Shell interface {
|
||||
Execute(ctx context.Context, input *ExecuteRequest) (result *ExecuteResponse, err error)
|
||||
}
|
||||
|
||||
type StreamingShell interface {
|
||||
ExecuteStreaming(ctx context.Context, input *ExecuteRequest) (result *schema.StreamReader[*ExecuteResponse], err error)
|
||||
}
|
||||
```
|
||||
|
||||
**影响**:
|
||||
|
||||
- `ShellBackend` 重命名为 `Shell`
|
||||
- `StreamingShellBackend` 重命名为 `StreamingShell`
|
||||
- 接口不再嵌入 `Backend`，如果你的实现依赖组合接口，需要分别实现**迁移指南**:
|
||||
|
||||
```go
|
||||
// Before
|
||||
type MyBackend struct {}
|
||||
func (b *MyBackend) Execute(...) {...}
|
||||
// MyBackend 实现 ShellBackend 需要同时实现 Backend 的所有方法
|
||||
|
||||
// After
|
||||
type MyShell struct {}
|
||||
func (s *MyShell) Execute(...) {...}
|
||||
// MyShell 只需要实现 Shell 接口的方法
|
||||
// 如果同时需要 Backend 功能，需要分别实现两个接口
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 1.2 Filesystem Backend：Read 返回值不兼容变更
|
||||
|
||||
- **位置** ： adk/filesystem/backend.go
|
||||
- **变更说明** ： Backend.Read 的返回值发生不兼容调整，由原先返回 string 修改为返回 *FileContent 结构体
|
||||
|
||||
**Before (v0.7.x)**:
|
||||
|
||||
```go
|
||||
type Backend interface {
|
||||
...
|
||||
Read(ctx context.Context, req *ReadRequest) (string, error)
|
||||
...
|
||||
}
|
||||
```
|
||||
|
||||
**After (v0.8.0)**:
|
||||
|
||||
```go
|
||||
type Backend interface {
|
||||
...
|
||||
Read(ctx context.Context, req *ReadRequest) (*FileContent, error)
|
||||
...
|
||||
}
|
||||
```
|
||||
|
||||
**影响：**
|
||||
|
||||
- v0.7.x 的 Read 接口返回 `string`。`v0.8.0` 的 Read 接口返回结构体 `FileContent`，属于不兼容变更。
|
||||
- 对 Backend 实现方：需要替换 Read 方法实现，从返回 String 改为返回 *FileContent。
|
||||
- 对 Backend 使用方：需要升级 Backend 实现为支持 v0.8 的版本。同时需要修改 Backend.Read 的调用，改为使用新返回的 *FileContent。
|
||||
|
||||
## 2. 行为不兼容变更
|
||||
|
||||
### 2.1 AgentEvent 发送机制变更
|
||||
|
||||
**位置**: `adk/chatmodel.go` **变更描述**: `ChatModelAgent` 的 `AgentEvent` 发送机制从 eino callback 机制改为 Middleware 机制。**Before (v0.7.x)**:
|
||||
|
||||
- `AgentEvent` 通过 eino 的 callback 机制发送
|
||||
- 如果用户自定义了 ChatModel 或 Tool 的 Decorator/Wrapper，且原始 ChatModel/Tool 内部埋入了 Callback 点位，则 `AgentEvent` 会在 Decorator/Wrapper 的**内部**发送
|
||||
- 这对 eino-ext 实现的所有 ChatModel 适用，但对大部分用户自行实现的 Tool 以及 eino 一方提供的 Tool 可能不适用 **After (v0.8.0)**:
|
||||
- `AgentEvent` 通过 Middleware 机制发送
|
||||
- `AgentEvent` 会在用户自定义的 Decorator/Wrapper 的**外部**发送**影响**:
|
||||
- 正常情况下用户不感知此变更
|
||||
- 如果用户之前自行实现了 ChatModel 或 Tool 的 Decorator/Wrapper，事件发送的相对位置会发生变化
|
||||
- 位置变化可能导致 `AgentEvent` 的内容也发生变化：之前的事件不包含 Decorator/Wrapper 做出的变更，现在的事件会包含**变更原因**:
|
||||
- 正常业务场景下，希望发出的事件包含 Decorator/Wrapper 做出的变更**迁移指南**:如果你之前通过 Decorator/Wrapper 包装了 ChatModel 或 Tool，需要改为实现 `ChatModelAgentMiddleware` 接口：
|
||||
|
||||
```go
|
||||
// Before: 通过 Decorator/Wrapper 包装 ChatModel
|
||||
type MyModelWrapper struct {
|
||||
inner model.BaseChatModel
|
||||
}
|
||||
|
||||
func (w *MyModelWrapper) Generate(ctx context.Context, input []*schema.Message, opts ...model.Option) (*schema.Message, error) {
|
||||
// 自定义逻辑
|
||||
return w.inner.Generate(ctx, input, opts...)
|
||||
}
|
||||
|
||||
// After: 实现 ChatModelAgentMiddleware 的 WrapModel 方法
|
||||
type MyMiddleware struct{}
|
||||
|
||||
func (m *MyMiddleware) WrapModel(ctx context.Context, chatModel model.BaseChatModel, mc *ModelContext) (model.BaseChatModel, error) {
|
||||
return &myWrappedModel{inner: chatModel}, nil
|
||||
}
|
||||
|
||||
// 对于 Tool 的 Wrapper，改为实现 WrapInvokableToolCall / WrapStreamableToolCall 等方法
|
||||
```
|
||||
|
||||
### 2.2 filesystem.ReadRequest.Offset 语义变更
|
||||
|
||||
**位置**: `adk/filesystem/backend.go` **变更描述**: `Offset` 字段从 0-based 改为 1-based。**Before (v0.7.x)**:
|
||||
|
||||
```go
|
||||
type ReadRequest struct {
|
||||
FilePath string
|
||||
// Offset is the 0-based line number to start reading from.
|
||||
Offset int
|
||||
Limit int
|
||||
}
|
||||
```
|
||||
|
||||
**After (v0.8.0)**:
|
||||
|
||||
```go
|
||||
type ReadRequest struct {
|
||||
|
||||
FilePath string
|
||||
// Offset specifies the starting line number (1-based) for reading.
|
||||
// Line 1 is the first line of the file.
|
||||
// Values < 1 will be treated as 1.
|
||||
Offset int
|
||||
Limit int
|
||||
}
|
||||
```
|
||||
|
||||
**迁移指南**:
|
||||
|
||||
```go
|
||||
// Before: 读取从第 0 行开始（即第一行）
|
||||
req := &ReadRequest{Offset: 0, Limit: 100}
|
||||
|
||||
// After: 读取从第 1 行开始（即第一行）
|
||||
req := &ReadRequest{Offset: 1, Limit: 100}
|
||||
|
||||
// 如果原来使用 Offset: 10 表示从第 11 行开始
|
||||
// 现在需要使用 Offset: 11
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2.3 filesystem.FileInfo.Path 语义变更
|
||||
|
||||
**位置**: `adk/filesystem/backend.go` **变更描述**: `FileInfo.Path` 字段不再保证是绝对路径。**Before (v0.7.x)**:
|
||||
|
||||
```go
|
||||
type FileInfo struct {
|
||||
// Path is the absolute path of the file or directory.
|
||||
Path string
|
||||
}
|
||||
```
|
||||
|
||||
**After (v0.8.0)**:
|
||||
|
||||
```go
|
||||
type FileInfo struct {
|
||||
// Path is the path of the file or directory, which can be a filename,
|
||||
// relative path, or absolute path.
|
||||
Path string
|
||||
// ...
|
||||
}
|
||||
```
|
||||
|
||||
**影响**:
|
||||
|
||||
- 依赖 `Path` 为绝对路径的代码可能会出现问题
|
||||
- 需要检查并处理相对路径的情况
|
||||
|
||||
---
|
||||
|
||||
### 2.4 filesystem.WriteRequest 行为变更
|
||||
|
||||
**位置**: `adk/filesystem/backend.go` **变更描述**: `WriteRequest` 的写入行为从"文件存在则报错"变更为"文件存在则覆盖"。**Before (v0.7.x)**:
|
||||
|
||||
```go
|
||||
// WriteRequest 注释说明:
|
||||
// The file will be created if it does not exist, or error if file exists.
|
||||
type WriteRequest struct {
|
||||
// FilePath is the absolute path of the file to write. Must start with '/'.
|
||||
// The file will be created if it does not exist, or error if file exists.
|
||||
FilePath string
|
||||
|
||||
...
|
||||
}
|
||||
```
|
||||
|
||||
**After (v0.8.0)**:
|
||||
|
||||
```go
|
||||
// WriteRequest 注释说明:
|
||||
// Creates the file if it does not exist, overwrites if it exists.
|
||||
type WriteRequest struct {
|
||||
// FilePath is the path of the file to write.
|
||||
FilePath string
|
||||
|
||||
....
|
||||
}
|
||||
```
|
||||
|
||||
**影响**:
|
||||
|
||||
- 原来依赖"文件存在报错"行为的代码将不再报错，而是直接覆盖
|
||||
- 可能导致意外的数据丢失**迁移指南**:
|
||||
- 如果需要保留原有行为，在写入前先检查文件是否存在
|
||||
- 原有 FilePath 代表 绝对路径，新版本未规定 FilePath 为绝对路径，原有依赖绝对路径的场景需要做对应 FilePath 的适配
|
||||
|
||||
---
|
||||
|
||||
### 2.5 GrepRequest.Pattern 语义变更
|
||||
|
||||
**位置**: `adk/filesystem/backend.go` **变更描述**: `GrepRequest.Pattern` 从字面量匹配变更为正则表达式匹配。**Before (v0.7.x)**:
|
||||
|
||||
```go
|
||||
// Pattern is the literal string to search for. This is not a regular expression.
|
||||
// The search performs an exact substring match within the file's content.
|
||||
```
|
||||
|
||||
**After (v0.8.0)**:
|
||||
|
||||
```go
|
||||
// Pattern is the search pattern, supports full regular expression syntax.
|
||||
// Uses ripgrep syntax (not grep).
|
||||
```
|
||||
|
||||
**影响**:
|
||||
|
||||
- 包含正则表达式特殊字符的搜索模式行为将发生变化
|
||||
- 例如，搜索 `interface{}` 现在需要转义为 `interface\{\}` **迁移指南**:
|
||||
|
||||
```go
|
||||
// Before: 字面量搜索
|
||||
req := &GrepRequest{Pattern: "interface{}"}
|
||||
|
||||
// After: 正则表达式搜索，需要转义特殊字符
|
||||
req := &GrepRequest{Pattern: "interface\\{\\}"}
|
||||
|
||||
// 或者如果要搜索包含 . * + ? 等的字面量，也需要转义
|
||||
// Before
|
||||
req := &GrepRequest{Pattern: "config.json"}
|
||||
// After
|
||||
req := &GrepRequest{Pattern: "config\\.json"}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2.6 EditRequest.FilePath 语义变更
|
||||
|
||||
**位置**: `adk/filesystem/backend.go` **变更描述**: EditRequest.FilePath 注释移除注释中的强制描述绝对路径。**Before (****v0.7.x****)**:
|
||||
|
||||
```go
|
||||
type EditRequest struct {
|
||||
// FilePath is the absolute path of the file to edit. Must start with '/'.
|
||||
FilePath string
|
||||
....
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**After (v0.8.0)**:
|
||||
|
||||
```go
|
||||
type EditRequest struct {
|
||||
// FilePath is the path of the file to edit.
|
||||
FilePath string
|
||||
}
|
||||
```
|
||||
|
||||
**影响**:
|
||||
|
||||
- 旧版本中 `FilePath` 默认表示绝对路径；新版本不再保证 `FilePath` 为绝对路径。 原先依赖 `FilePath` 为绝对路径的逻辑需要相应适配 。
|
||||
|
||||
## 迁移建议
|
||||
|
||||
1. **优先处理编译错误**: 类型变更（如 Shell 接口重命名）会导致编译失败，需要首先修复
|
||||
2. **关注语义变更**: `ReadRequest.Offset` 从 0-based 改为 1-based，`Pattern` 从字面量改为正则表达式，这些不会导致编译错误但会改变运行时行为
|
||||
3. **检查文件操作**: `WriteRequest` 的覆盖行为变更可能导致数据丢失，需要额外检查
|
||||
4. **迁移 Decorator/Wrapper**: 如有自定义的 ChatModel/Tool Decorator/Wrapper，改为实现 `ChatModelAgentMiddleware`
|
||||
5. **按需升级 backend 实现**：如果使用 eino-ext 提供的 local/ark agentkit backend，升级到对应的最新 版本：[adk/backend/local/v0.2.1](https://github.com/cloudwego/eino-ext/releases/tag/adk%2Fbackend%2Flocal%2Fv0.2.1) [adk/backend/agentkit/v0.2.1](https://github.com/cloudwego/eino-ext/releases/tag/adk%2Fbackend%2Fagentkit%2Fv0.2.1)
|
||||
6. **测试验证**: 迁移后进行全面的测试，特别是涉及文件操作和搜索功能的代码
|
||||
@@ -0,0 +1,276 @@
|
||||
---
|
||||
Description: ""
|
||||
date: "2026-03-24"
|
||||
lastmod: ""
|
||||
tags: []
|
||||
title: v0.8.*-adk middlewares
|
||||
weight: 8
|
||||
---
|
||||
|
||||
本文档介绍 Eino ADK v0.8.* 版本的主要新功能和改进。
|
||||
|
||||
## 版本亮点
|
||||
|
||||
v0.8 是一个重要的功能增强版本，引入了全新的中间件接口架构，新增多个实用中间件，并提供了增强的可观测性支持。
|
||||
|
||||
<table><tbody><tr>
|
||||
<td>
|
||||
<strong>🔧 灵活的中间件架构</strong>
|
||||
全新 ChatModelAgentMiddleware 接口</td><td>
|
||||
<strong>📊 增强的可观测性</strong>
|
||||
Agent 级别 Callback 支持</td></tr></tbody></table>
|
||||
|
||||
---
|
||||
|
||||
## 1. ChatModelAgentMiddleware 接口
|
||||
|
||||
> 💡
|
||||
> **核心更新**: 全新的中间件接口，提供更灵活的 Agent 扩展机制
|
||||
|
||||
`ChatModelAgentMiddleware` 是 v0.8 最重要的架构更新，为 `ChatModelAgent` 及基于它构建的 Agent（如 `DeepAgent`）提供统一的扩展点。
|
||||
|
||||
**相比 AgentMiddleware 的优势**:
|
||||
|
||||
<table>
|
||||
<tr><td>特性</td><td>AgentMiddleware</td><td>ChatModelAgentMiddleware</td></tr>
|
||||
<tr><td>扩展性</td><td>封闭</td><td>开放，可实现自定义 handler</td></tr>
|
||||
<tr><td>Context 传播</td><td>回调只返回 error</td><td>所有方法返回 (ctx, ..., error)</td></tr>
|
||||
<tr><td>配置管理</td><td>分散在闭包中</td><td>集中在结构体字段中</td></tr>
|
||||
</table>
|
||||
|
||||
**接口方法**:
|
||||
|
||||
- `BeforeAgent` - Agent 运行前修改配置
|
||||
- `BeforeModelRewriteState` - 模型调用前处理状态
|
||||
- `AfterModelRewriteState` - 模型调用后处理状态
|
||||
- `WrapInvokableToolCall` - 包装同步工具调用
|
||||
- `WrapStreamableToolCall` - 包装流式工具调用
|
||||
- `WrapModel` - 包装模型调用
|
||||
|
||||
**使用方式**:
|
||||
|
||||
```go
|
||||
agent, err := adk.NewChatModelAgent(ctx, &adk.ChatModelAgentConfig{
|
||||
Model: model,
|
||||
Handlers: []adk.ChatModelAgentMiddleware{mw1, mw2, mw3},
|
||||
})
|
||||
```
|
||||
|
||||
详见 [Eino ADK: ChatModelAgentMiddleware](/zh/docs/eino/core_modules/eino_adk/eino_adk_chatmodelagentmiddleware)
|
||||
|
||||
---
|
||||
|
||||
### 1.1 Summarization 中间件
|
||||
|
||||
> 💡
|
||||
> **功能**: 自动对话历史摘要，防止超出模型上下文窗口限制
|
||||
|
||||
📚 **详细文档**: [Middleware: FileSystem](/zh/docs/eino/core_modules/eino_adk/eino_adk_chatmodelagentmiddleware/middleware_filesystem)
|
||||
|
||||
当对话历史的 Token 数量超过阈值时，自动调用 LLM 生成摘要，压缩上下文。
|
||||
|
||||
**核心能力**:
|
||||
|
||||
- 可配置的触发条件（Token 阈值）
|
||||
- 支持保留最近的用户消息
|
||||
- 支持记录完整对话历史到文件
|
||||
- 提供前后处理钩子
|
||||
|
||||
**快速开始**:
|
||||
|
||||
```go
|
||||
mw, err := summarization.New(ctx, &summarization.Config{
|
||||
Model: chatModel,
|
||||
Trigger: &summarization.TriggerCondition{
|
||||
ContextTokens: 100000,
|
||||
},
|
||||
})
|
||||
```
|
||||
|
||||
### 1.2 ToolReduction 中间件
|
||||
|
||||
> 💡
|
||||
> **功能**: 工具结果压缩，优化上下文使用效率
|
||||
|
||||
📚 **详细文档**: [Middleware: ToolReduction](/zh/docs/eino/core_modules/eino_adk/eino_adk_chatmodelagentmiddleware/middleware_toolreduction)
|
||||
|
||||
提供两阶段的工具输出管理：
|
||||
|
||||
<table>
|
||||
<tr><td>阶段</td><td>触发时机</td><td>作用</td></tr>
|
||||
<tr><td>截断 (Truncation)</td><td>工具返回后</td><td>截断超长输出，保存到文件</td></tr>
|
||||
<tr><td>清理 (Clear)</td><td>模型调用前</td><td>清理历史工具结果，释放 Token</td></tr>
|
||||
</table>
|
||||
|
||||
**快速开始**:
|
||||
|
||||
```go
|
||||
mw, err := reduction.New(ctx, &reduction.Config{
|
||||
Backend: fsBackend,
|
||||
MaxLengthForTrunc: 30000,
|
||||
MaxTokensForClear: 50000,
|
||||
})
|
||||
```
|
||||
|
||||
### 1.3 Filesystem 中间件
|
||||
|
||||
> 💡
|
||||
> **功能**: 文件系统操作工具集
|
||||
|
||||
📚 **详细文档**: [Middleware: FileSystem](/zh/docs/eino/core_modules/eino_adk/eino_adk_chatmodelagentmiddleware/middleware_filesystem)
|
||||
|
||||
**新增能力**:
|
||||
|
||||
- **Grep 功能增强**: 支持完整正则表达式语法
|
||||
- **新增选项**: `CaseInsensitive`、`EnableMultiline`、`FileType` 过滤
|
||||
- **自定义工具名**: 所有 filesystem 工具支持自定义名称
|
||||
|
||||
### 1.4 Skill 中间件
|
||||
|
||||
> 💡
|
||||
> **功能**: 动态加载和执行 Skill
|
||||
|
||||
📚 **详细文档**: [Middleware: Skill](/zh/docs/eino/core_modules/eino_adk/eino_adk_chatmodelagentmiddleware/middleware_skill)
|
||||
|
||||
**新增能力**:
|
||||
|
||||
- **Context 模式**: 支持 `fork` 和 `isolate` 两种上下文模式
|
||||
- **自定义配置**: 支持自定义系统提示和工具描述
|
||||
- **FrontMatter 扩展**: 支持通过 FrontMatter 指定 agent 和 model
|
||||
|
||||
### 1.5 PlanTask 中间件
|
||||
|
||||
> 💡
|
||||
> **功能**: 任务规划和执行工具
|
||||
|
||||
📚 **详细文档**: [Middleware: PlanTask](/zh/docs/eino/core_modules/eino_adk/eino_adk_chatmodelagentmiddleware/middleware_plantask)
|
||||
|
||||
支持 Agent 创建和管理任务计划，适用于需要分步执行的复杂任务场景。
|
||||
|
||||
### 1.6 ToolSearch 中间件
|
||||
|
||||
> 💡
|
||||
> **功能**: 工具搜索，支持从大量工具中动态检索
|
||||
|
||||
📚 **详细文档**: [Middleware: ToolSearch](/zh/docs/eino/core_modules/eino_adk/eino_adk_chatmodelagentmiddleware/middleware_toolsearch)
|
||||
|
||||
当工具数量较多时，通过语义搜索动态选择最相关的工具，避免上下文过载。
|
||||
|
||||
### 1.7 PatchToolCalls 中间件
|
||||
|
||||
> 💡
|
||||
> **功能**: 修补悬空的工具调用，确保消息历史完整性
|
||||
|
||||
📚 **详细文档**: [Middleware: PatchToolCalls](/zh/docs/eino/core_modules/eino_adk/eino_adk_chatmodelagentmiddleware/middleware_patchtoolcalls)
|
||||
|
||||
扫描消息历史，为缺少响应的工具调用插入占位符消息。适用于工具调用被中断或取消的场景。
|
||||
|
||||
**快速开始**:
|
||||
|
||||
```go
|
||||
mw, err := patchtoolcalls.New(ctx, nil)
|
||||
```
|
||||
|
||||
## 2. Agent Callback 支持
|
||||
|
||||
> 💡
|
||||
> **功能**: Agent 级别的回调机制，用于观测和追踪
|
||||
|
||||
支持在 Agent 执行的全生命周期中注册回调，实现日志记录、追踪、监控等功能。
|
||||
|
||||
**核心类型**:
|
||||
|
||||
- `AgentCallbackInput` - 回调输入，包含 Agent 输入或恢复信息
|
||||
- `AgentCallbackOutput` - 回调输出，包含 Agent 事件流
|
||||
|
||||
**使用方式**:
|
||||
|
||||
```go
|
||||
agent.Run(ctx, input, adk.WithCallbacks(
|
||||
callbacks.NewHandler(
|
||||
callbacks.WithOnStart(func(ctx context.Context, info *callbacks.RunInfo, input callbacks.CallbackInput) context.Context {
|
||||
agentInput := adk.ConvAgentCallbackInput(input)
|
||||
// 处理 Agent 启动事件
|
||||
return ctx
|
||||
}),
|
||||
callbacks.WithOnEnd(func(ctx context.Context, info *callbacks.RunInfo, output callbacks.CallbackOutput) context.Context {
|
||||
agentOutput := adk.ConvAgentCallbackOutput(output)
|
||||
// 处理 Agent 完成事件
|
||||
return ctx
|
||||
}),
|
||||
),
|
||||
))
|
||||
```
|
||||
|
||||
详见 [Eino ADK: Agent Callback](/zh/docs/eino/core_modules/eino_adk/adk_agent_callback)
|
||||
|
||||
---
|
||||
|
||||
## 3. Language Setting
|
||||
|
||||
> 💡
|
||||
> **功能**: 全局语言设置
|
||||
|
||||
支持全局设置 ADK 的语言偏好，影响内置提示词和消息的语言。
|
||||
|
||||
**使用方式**:
|
||||
|
||||
```go
|
||||
adk.SetLanguage(adk.LanguageChinese) // 设置为中文
|
||||
adk.SetLanguage(adk.LanguageEnglish) // 设置为英文（默认）
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 中间件使用建议
|
||||
|
||||
> 💡
|
||||
> **推荐组合**: 以下中间件可组合使用，覆盖大部分长对话场景
|
||||
|
||||
```go
|
||||
handlers := []adk.ChatModelAgentMiddleware{
|
||||
patchMW, // 1. 修补悬空工具调用
|
||||
reductionMW, // 2. 压缩工具输出
|
||||
summarizationMW, // 3. 摘要对话历史
|
||||
}
|
||||
|
||||
agent, err := adk.NewChatModelAgent(ctx, &adk.ChatModelAgentConfig{
|
||||
Model: model,
|
||||
Handlers: handlers,
|
||||
})
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Breaking Changes
|
||||
|
||||
> 💡
|
||||
> 升级到 v0.8 前，请查阅 Breaking Changes 文档了解所有不兼容变更
|
||||
|
||||
📚 **完整文档**: [Eino v0.8 不兼容更新](/zh/docs/eino/release_notes_and_migration/eino_v0.8._-adk_middlewares/eino_v0.8_不兼容更新)
|
||||
|
||||
**变更概览**:
|
||||
|
||||
<table>
|
||||
<tr><td>类型</td><td>变更项</td></tr>
|
||||
<tr><td>API 变更</td><td><pre>ShellBackend</pre> → <pre>Shell</pre> 接口重命名</td></tr>
|
||||
<tr><td>行为变更</td><td><pre>AgentEvent</pre> 发送机制改为 Middleware</td></tr>
|
||||
<tr><td>行为变更</td><td><pre>ReadRequest.Offset</pre> 从 0-based 改为 1-based</td></tr>
|
||||
<tr><td>行为变更</td><td><pre>FileInfo.Path</pre> 不再保证为绝对路径</td></tr>
|
||||
<tr><td>行为变更</td><td><pre>WriteRequest</pre> 文件存在时从报错改为覆盖</td></tr>
|
||||
<tr><td>行为变更</td><td><pre>GrepRequest.Pattern</pre> 从字面量改为正则表达式</td></tr>
|
||||
</table>
|
||||
|
||||
## 升级指南
|
||||
|
||||
详细的迁移步骤和代码示例请参考：[Eino v0.8 不兼容更新](/zh/docs/eino/release_notes_and_migration/eino_v0.8._-adk_middlewares/eino_v0.8_不兼容更新)
|
||||
|
||||
**快速检查清单**:
|
||||
|
||||
1. 检查是否使用了 `ShellBackend` / `StreamingShellBackend` 接口（需重命名）
|
||||
2. 检查 `ReadRequest.Offset` 使用（0-based → 1-based）
|
||||
3. 检查 `GrepRequest.Pattern` 使用（字面量 → 正则表达式，特殊字符需转义）
|
||||
4. 检查是否依赖 `WriteRequest` 的"文件存在报错"行为
|
||||
5. 检查是否依赖 `FileInfo.Path` 为绝对路径
|
||||
6. 如有自定义 ChatModel/Tool Decorator/Wrapper，考虑迁移到 `ChatModelAgentMiddleware`
|
||||
7. 运行测试验证功能正常
|
||||
Reference in New Issue
Block a user