You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/en/docs/eino/FAQ.md
+2-37Lines changed: 2 additions & 37 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -142,15 +142,12 @@ According to the previous community announcement plan [Migration from OpenAPI 3.
142
142
143
143
For errors like undefined: schema.NewParamsOneOfByOpenAPIV3 in some eino-ext modules, upgrade the error-reporting eino-ext module to the latest version.
144
144
145
-
If schema transformation is complex, you can use the tool methods in the [JSONSchema Conversion Methods](https://bytedance.larkoffice.com/wiki/ZMaawoQC4iIjNykzahwc6YOknXf) document to assist with conversion.
145
+
If schema transformation is complex, you can use existing OpenAPI 3.0 → JSONSchema conversion tools to assist with conversion.
146
146
147
147
# Q: Which models provided by Eino-ext ChatModel support Response API format calls?
148
148
149
149
- Currently in Eino-Ext, only ARK's Chat Model can create ResponsesAPI ChatModel through **NewResponsesAPIChatModel**. Other models currently do not support ResponsesAPI creation and usage.
150
-
- In Eino-byted-ext, only bytedgpt supports creating Response API through **NewResponsesAPIChatModel**. Other chatmodels have not implemented Response API Client.
151
-
- Version components/model/gemini/v0.1.16 already supports thought_signature passback. Check if the gemini version meets requirements. If using bytedgemini (code.byted.org/flow/eino-byted-ext/components/model/bytedgemini) chatmodel implementation, check if its dependent components/model/gemini is the latest version, or directly use go get to upgrade gemini.
152
-
- Replace the currently used bytedgpt package with the implementation from [code.byted.org/flow/eino-byted-ext/components/model/bytedgemini](http://code.byted.org/flow/eino-byted-ext/components/model/bytedgemini) and upgrade to the latest version. Refer to example code to confirm how to pass BaseURL.
153
-
- If you encounter this error, confirm whether the base url filled in when generating chat model is the chat completion URL or the ResponseAPI URL. In most cases, the Response API Base URL was incorrectly passed.
150
+
- If you encounter this error, confirm whether the base URL you used to create the chat model is the Chat Completions URL or the Responses API URL. In most cases, an incorrect Responses API base URL was passed.
154
151
155
152
# Q: How to troubleshoot ChatModel call errors? For example, [NodeRunError] failed to create chat completion: error, status code: 400, status: 400 Bad Request.
156
153
@@ -175,35 +172,3 @@ Use the `GraphCompileCallback` mechanism to export the topology structure during
175
172
- For obtaining intermediate structures in Flow/React Agent scenarios, refer to the document [Eino: ReAct Agent Manual](/docs/eino/core_modules/flow_integration_components/react_agent_manual)
176
173
177
174
# Q: Gemini model error missing a `thought_signature`
178
-
179
-
Gemini model protocol is not openai-compatible. Use the gemini wrapper [https://github.com/cloudwego/eino-ext/tree/main/components/model/gemini](https://github.com/cloudwego/eino-ext/tree/main/components/model/gemini). If using ModelHub platform models, use the internal gemini wrapper [https://code.byted.org/flow/eino-byted-ext/tree/master/components/model/bytedgemini](https://code.byted.org/flow/eino-byted-ext/tree/master/components/model/bytedgemini). Initialization reference code:
180
-
181
-
```
182
-
cm, err := bytedgemini.NewChatModel(ctx, &bytedgemini.Config{
183
-
ClientConfig: genai.ClientConfig{
184
-
APIKey: apiKey,
185
-
Backend: genai.BackendGeminiAPI,
186
-
// uncomment if you want to print the actual request in CURL format
Copy file name to clipboardExpand all lines: content/en/docs/eino/overview/_index.md
-7Lines changed: 0 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -344,13 +344,6 @@ The Eino framework consists of several parts:
344
344
-[Eino](https://github.com/cloudwego/eino): Contains type definitions, stream data processing mechanisms, component abstraction definitions, orchestration functionality, callback mechanisms, etc.
345
345
-[EinoExt](https://github.com/cloudwego/eino-ext): Component implementations, callback handler implementations, component usage examples, and various tools such as evaluators, prompt optimizers, etc.
346
346
347
-
> 💡
348
-
> For components used internally at ByteDance, there are corresponding internal code repositories:
> For detailed information about OpenAI ChatModel, see: [ChatModel - OpenAI](https://bytedance.larkoffice.com/wiki/NguEw85n6iJjShkVtdQcHpydnld)
123
+
> For detailed information about OpenAI ChatModel, see: [ChatModel - OpenAI](https://github.com/cloudwego/eino-ext/blob/main/components/model/openai/README.md)
124
124
125
125
#### **Ollama (choose either this or OpenAI above)**
> For Ollama related information, see: [ChatModel - Ollama](https://bytedance.larkoffice.com/wiki/WWngw1XMViwgyYkNuZgcjZnxnke)
143
+
> For detailed information about Ollama ChatModel, see: [ChatModel - Ollama](https://github.com/cloudwego/eino-ext/blob/main/components/model/ollama/README.md)
144
144
145
145
Eino provides a unified ChatModel abstraction for large models and offers ready-to-use implementations of various LLMs. Therefore, business code can focus on writing business logic without worrying about model implementation details. When model implementations are updated, they won't affect core business logic, meaning developers can easily switch between different models without modifying large amounts of code.
Copy file name to clipboardExpand all lines: content/en/docs/eino/release_notes_and_migration/Eino_v0.8._-adk_middlewares/Eino_v0.8_Breaking_Changes.md
+13-15Lines changed: 13 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,19 +1,17 @@
1
1
---
2
2
Description: ""
3
-
date: "2026-03-02"
3
+
date: "2026-03-10"
4
4
lastmod: ""
5
5
tags: []
6
6
title: Eino v0.8 Breaking Changes
7
7
weight: 1
8
8
---
9
9
10
-
> This document records all breaking changes in the `v0.8.0.Beta` branch compared to the `main` branch.
11
-
12
10
## 1. API Breaking Changes
13
11
14
12
### 1.1 filesystem Shell Interface Renamed
15
13
16
-
**Location**: `adk/filesystem/backend.go`**Change Description**: Shell-related interfaces have been renamed and no longer embed the `Backend` interface. **Before (main)**:
14
+
**Location**: `adk/filesystem/backend.go`**Change Description**: Shell-related interfaces have been renamed and no longer embed the `Backend` interface. **Before (v0.7.x)**:
17
15
18
16
```go
19
17
typeShellBackendinterface {
@@ -27,7 +25,7 @@ type StreamingShellBackend interface {
27
25
}
28
26
```
29
27
30
-
**After (v0.8.0.Beta)**:
28
+
**After (v0.8.0)**:
31
29
32
30
```go
33
31
typeShellinterface {
@@ -64,11 +62,11 @@ func (s *MyShell) Execute(...) {...}
64
62
65
63
### 2.1 AgentEvent Sending Mechanism Change
66
64
67
-
**Location**: `adk/chatmodel.go`**Change Description**: `ChatModelAgent`'s `AgentEvent` sending mechanism changed from eino callback mechanism to Middleware mechanism. **Before (main)**:
65
+
**Location**: `adk/chatmodel.go`**Change Description**: `ChatModelAgent`'s `AgentEvent` sending mechanism changed from eino callback mechanism to Middleware mechanism. **Before (v0.7.x)**:
68
66
69
67
-`AgentEvent` was sent through eino's callback mechanism
70
68
- If users customized ChatModel or Tool Decorator/Wrapper, and the original ChatModel/Tool had embedded Callback points, `AgentEvent` would be sent **inside** the Decorator/Wrapper
71
-
- This applied to all ChatModels implemented in eino-ext, but may not apply to most user-implemented Tools and Tools provided by eino **After (v0.8.0.Beta)**:
69
+
- This applied to all ChatModels implemented in eino-ext, but may not apply to most user-implemented Tools and Tools provided by eino **After (v0.8.0)**:
72
70
-`AgentEvent` is sent through Middleware mechanism
73
71
-`AgentEvent` is sent **outside** user-customized Decorator/Wrapper **Impact**:
74
72
- Under normal circumstances, users won't notice this change
**Location**: `adk/filesystem/backend.go`**Change Description**: `FileInfo.Path` field is no longer guaranteed to be an absolute path. **Before (main)**:
141
+
**Location**: `adk/filesystem/backend.go`**Change Description**: `FileInfo.Path` field is no longer guaranteed to be an absolute path. **Before (v0.7.x)**:
144
142
145
143
```go
146
144
typeFileInfostruct {
@@ -149,7 +147,7 @@ type FileInfo struct {
149
147
}
150
148
```
151
149
152
-
**After (v0.8.0.Beta)**:
150
+
**After (v0.8.0)**:
153
151
154
152
```go
155
153
typeFileInfostruct {
@@ -169,14 +167,14 @@ type FileInfo struct {
169
167
170
168
### 2.4 filesystem.WriteRequest Behavior Change
171
169
172
-
**Location**: `adk/filesystem/backend.go`**Change Description**: `WriteRequest` write behavior changed from "error if file exists" to "overwrite if file exists". **Before (main)**:
170
+
**Location**: `adk/filesystem/backend.go`**Change Description**: `WriteRequest` write behavior changed from "error if file exists" to "overwrite if file exists". **Before (v0.7.x)**:
173
171
174
172
```go
175
173
// WriteRequest comment:
176
174
// The file will be created if it does not exist, or error if file exists.
177
175
```
178
176
179
-
**After (v0.8.0.Beta)**:
177
+
**After (v0.8.0)**:
180
178
181
179
```go
182
180
// WriteRequest comment:
@@ -193,14 +191,14 @@ type FileInfo struct {
193
191
194
192
### 2.5 GrepRequest.Pattern Semantic Change
195
193
196
-
**Location**: `adk/filesystem/backend.go`**Change Description**: `GrepRequest.Pattern` changed from literal matching to regular expression matching. **Before (main)**:
194
+
**Location**: `adk/filesystem/backend.go`**Change Description**: `GrepRequest.Pattern` changed from literal matching to regular expression matching. **Before (v0.7.x)**:
197
195
198
196
```go
199
197
// Pattern is the literal string to search for. This is not a regular expression.
200
198
// The search performs an exact substring match within the file's content.
201
199
```
202
200
203
-
**After (v0.8.0.Beta)**:
201
+
**After (v0.8.0)**:
204
202
205
203
```go
206
204
// Pattern is the search pattern, supports full regular expression syntax.
Copy file name to clipboardExpand all lines: content/en/docs/eino/release_notes_and_migration/v02_second_release.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -74,7 +74,7 @@ weight: 2
74
74
75
75
### BugFix
76
76
77
-
- Fixed the SSTI vulnerability in the Jinja chat template[langchaingo has gonja template injection vulnerability](https://bytedance.larkoffice.com/docx/UvqxdlFfSoTIr1xtsQ5cIZTVn2b)
77
+
- Fixed the SSTI vulnerability in the Jinja chat template（langchaingo gonja template injection）
0 commit comments