docs(eino): sync english translations

Author: shentongmartin

content/en/docs/eino/Eino: Cookbook.md content/en/docs/eino/Cookbook.mdcontent/en/docs/eino/Eino: Cookbook.md renamed to content/en/docs/eino/Cookbook.md

@@ -3,7 +3,7 @@ Description: ""
 date: "2026-03-02"
 lastmod: ""
 tags: []
-title: 'Eino: Cookbook'
+title: Cookbook
 weight: 3
 ---
 

content/en/docs/eino/FAQ.md

@@ -142,15 +142,12 @@ According to the previous community announcement plan [Migration from OpenAPI 3.
 
 For errors like undefined: schema.NewParamsOneOfByOpenAPIV3 in some eino-ext modules, upgrade the error-reporting eino-ext module to the latest version.
 
-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.
+If schema transformation is complex, you can use existing OpenAPI 3.0 → JSONSchema conversion tools to assist with conversion.
 
 # Q: Which models provided by Eino-ext ChatModel support Response API format calls?
 
 - 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.
-- In Eino-byted-ext, only bytedgpt supports creating Response API through **NewResponsesAPIChatModel**. Other chatmodels have not implemented Response API Client.
-  - 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.
-  - 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.
-  - 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.
+  - 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.
 
 # Q: How to troubleshoot ChatModel call errors? For example, [NodeRunError] failed to create chat completion: error, status code: 400, status: 400 Bad Request.
 
@@ -175,35 +172,3 @@ Use the `GraphCompileCallback` mechanism to export the topology structure during
 - 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)
 
 # Q: Gemini model error missing a `thought_signature`
-
-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:
-
-```
-cm, err := bytedgemini.NewChatModel(ctx, &bytedgemini.Config{
-    ClientConfig: genai.ClientConfig{
-        APIKey:  apiKey,
-        Backend: genai.BackendGeminiAPI,
-        // uncomment if you want to print the actual request in CURL format
-        // HTTPClient: &http.Client{Transport: NewCurlLogger(http.DefaultTransport, log.Printf)},
-        HTTPOptions: genai.HTTPOptions{
-            // this is base URL for cn, other regions:
-            // - sg: gpt-i18n.byteintl.net
-            // - sg from office network: genai-sg-og.tiktok-row.org
-            // - va: search-va.byteintl.net
-            // - va from office network: genai-va-og.tiktok-row.org
-            // - Non-TT: gpt-i18n.bd.byteintl.net
-            // - US-TTP: gpt.tiktokd.net
-            // - EU-TTP, GCP: gpt.tiktoke.org
-            // - JP: gpt-jp.byteintl.net
-            // see also: https://bytedance.larkoffice.com/wiki/wikcnUPXCY2idGyg2AXKPvay4pd
-            BaseURL:    "https://search.bytedance.net/gpt/openapi/online/multimodal/crawl/google/",
-            APIVersion: "v1",
-        },
-    },
-    Model: modelName,
-    ThinkingConfig: &genai.ThinkingConfig{
-        IncludeThoughts: true,
-        ThinkingBudget:  nil,
-    },
-})
-```

content/en/docs/eino/core_modules/components/chat_model_guide.md

@@ -336,9 +336,9 @@ result, err := runnable.Invoke(ctx, messages, compose.WithCallbacks(helper))
 
 ## **Existing Implementations**
 
-1. OpenAI ChatModel: Using OpenAI's GPT series models [ChatModel - OpenAI](https://bytedance.larkoffice.com/wiki/NguEw85n6iJjShkVtdQcHpydnld)
-2. Ollama ChatModel: Using Ollama local models [ChatModel - Ollama](https://bytedance.larkoffice.com/wiki/WWngw1XMViwgyYkNuZgcjZnxnke)
-3. ARK ChatModel: Using ARK platform model services [ChatModel - ARK](https://bytedance.larkoffice.com/wiki/WUzzwaX8ricGwZk1i1mcJHHNnEl)
+1. OpenAI ChatModel: Using OpenAI's GPT series models [ChatModel - OpenAI](https://github.com/cloudwego/eino-ext/blob/main/components/model/openai/README.md)
+2. Ollama ChatModel: Using Ollama local models [ChatModel - Ollama](https://github.com/cloudwego/eino-ext/blob/main/components/model/ollama/README.md)
+3. ARK ChatModel: Using ARK platform model services [ChatModel - ARK](https://github.com/cloudwego/eino-ext/blob/main/components/model/ark/README.md)
 4. More: [Eino ChatModel](https://www.cloudwego.io/docs/eino/ecosystem_integration/chat_model/)
 
 ## Implementation Reference

content/en/docs/eino/ecosystem_integration/_index.md

@@ -11,9 +11,9 @@ weight: 6
 
 ### ChatModel
 
-- openai: [ChatModel - OpenAI](https://bytedance.larkoffice.com/wiki/NguEw85n6iJjShkVtdQcHpydnld)
-- ark: [ChatModel - ARK](https://bytedance.larkoffice.com/wiki/WUzzwaX8ricGwZk1i1mcJHHNnEl)
-- ollama: [ChatModel - Ollama](https://bytedance.larkoffice.com/wiki/WWngw1XMViwgyYkNuZgcjZnxnke)
+- openai: [ChatModel - OpenAI](https://github.com/cloudwego/eino-ext/blob/main/components/model/openai/README.md)
+- ark: [ChatModel - ARK](https://github.com/cloudwego/eino-ext/blob/main/components/model/ark/README.md)
+- ollama: [ChatModel - Ollama](https://github.com/cloudwego/eino-ext/blob/main/components/model/ollama/README.md)
 
 ### Document
 

content/en/docs/eino/overview/_index.md

@@ -344,13 +344,6 @@ The Eino framework consists of several parts:
 - [Eino](https://github.com/cloudwego/eino): Contains type definitions, stream data processing mechanisms, component abstraction definitions, orchestration functionality, callback mechanisms, etc.
 - [EinoExt](https://github.com/cloudwego/eino-ext): Component implementations, callback handler implementations, component usage examples, and various tools such as evaluators, prompt optimizers, etc.
 
-> 💡
-> For components used internally at ByteDance, there are corresponding internal code repositories:
->
-> EinoBytedExt: [https://code.byted.org/flow/eino-byted-ext](https://code.byted.org/flow/eino-byted-ext)
->
-> Contains component implementations currently positioned for internal use, such as llmgateway, bytedgpt, fornax tracing, bytees, etc.
-
 - [Eino Devops](https://github.com/cloudwego/eino-ext/tree/main/devops): Visual development, visual debugging, etc.
 - [EinoExamples](https://github.com/cloudwego/eino-examples): A code repository containing example applications and best practices.
 

content/en/docs/eino/quick_start/simple_llm_application.md

@@ -120,7 +120,7 @@ chatModel, err := openai.NewChatModel(ctx, &openai.ChatModelConfig{
 })
 ```
 
-> For detailed information about OpenAI ChatModel, see: [ChatModel - OpenAI](https://bytedance.larkoffice.com/wiki/NguEw85n6iJjShkVtdQcHpydnld)
+> For detailed information about OpenAI ChatModel, see: [ChatModel - OpenAI](https://github.com/cloudwego/eino-ext/blob/main/components/model/openai/README.md)
 
 #### **Ollama (choose either this or OpenAI above)**
 
@@ -140,7 +140,7 @@ chatModel, err := ollama.NewChatModel(ctx, &ollama.ChatModelConfig{
 })
 ```
 
-> For Ollama related information, see: [ChatModel - Ollama](https://bytedance.larkoffice.com/wiki/WWngw1XMViwgyYkNuZgcjZnxnke)
+> For detailed information about Ollama ChatModel, see: [ChatModel - Ollama](https://github.com/cloudwego/eino-ext/blob/main/components/model/ollama/README.md)
 
 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.
 

content/en/docs/eino/release_notes_and_migration/Eino_v0.8._-adk_middlewares/Eino_v0.8_Breaking_Changes.md

@@ -1,19 +1,17 @@
 ---
 Description: ""
-date: "2026-03-02"
+date: "2026-03-10"
 lastmod: ""
 tags: []
 title: Eino v0.8 Breaking Changes
 weight: 1
 ---
 
-> This document records all breaking changes in the `v0.8.0.Beta` branch compared to the `main` branch.
-
 ## 1. API Breaking Changes
 
 ### 1.1 filesystem Shell Interface Renamed
 
-**Location**: `adk/filesystem/backend.go` **Change Description**: Shell-related interfaces have been renamed and no longer embed the `Backend` interface. **Before (main)**:
+**Location**: `adk/filesystem/backend.go` **Change Description**: Shell-related interfaces have been renamed and no longer embed the `Backend` interface. **Before (v0.7.x)**:
 
 ```go
 type ShellBackend interface {
@@ -27,7 +25,7 @@ type StreamingShellBackend interface {
 }
 ```
 
-**After (v0.8.0.Beta)**:
+**After (v0.8.0)**:
 
 ```go
 type Shell interface {
@@ -64,11 +62,11 @@ func (s *MyShell) Execute(...) {...}
 
 ### 2.1 AgentEvent Sending Mechanism Change
 
-**Location**: `adk/chatmodel.go` **Change Description**: `ChatModelAgent`'s `AgentEvent` sending mechanism changed from eino callback mechanism to Middleware mechanism. **Before (main)**:
+**Location**: `adk/chatmodel.go` **Change Description**: `ChatModelAgent`'s `AgentEvent` sending mechanism changed from eino callback mechanism to Middleware mechanism. **Before (v0.7.x)**:
 
 - `AgentEvent` was sent through eino's callback mechanism
 - 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
-- 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)**:
+- 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)**:
 - `AgentEvent` is sent through Middleware mechanism
 - `AgentEvent` is sent **outside** user-customized Decorator/Wrapper **Impact**:
 - Under normal circumstances, users won't notice this change
@@ -99,7 +97,7 @@ func (m *MyMiddleware) WrapModel(ctx context.Context, chatModel model.BaseChatMo
 
 ### 2.2 filesystem.ReadRequest.Offset Semantic Change
 
-**Location**: `adk/filesystem/backend.go` **Change Description**: `Offset` field changed from 0-based to 1-based. **Before (main)**:
+**Location**: `adk/filesystem/backend.go` **Change Description**: `Offset` field changed from 0-based to 1-based. **Before (v0.7.x)**:
 
 ```go
 type ReadRequest struct {
@@ -110,7 +108,7 @@ type ReadRequest struct {
 }
 ```
 
-**After (v0.8.0.Beta)**:
+**After (v0.8.0)**:
 
 ```go
 type ReadRequest struct {
@@ -140,7 +138,7 @@ req := &ReadRequest{Offset: 1, Limit: 100}
 
 ### 2.3 filesystem.FileInfo.Path Semantic Change
 
-**Location**: `adk/filesystem/backend.go` **Change Description**: `FileInfo.Path` field is no longer guaranteed to be an absolute path. **Before (main)**:
+**Location**: `adk/filesystem/backend.go` **Change Description**: `FileInfo.Path` field is no longer guaranteed to be an absolute path. **Before (v0.7.x)**:
 
 ```go
 type FileInfo struct {
@@ -149,7 +147,7 @@ type FileInfo struct {
 }
 ```
 
-**After (v0.8.0.Beta)**:
+**After (v0.8.0)**:
 
 ```go
 type FileInfo struct {
@@ -169,14 +167,14 @@ type FileInfo struct {
 
 ### 2.4 filesystem.WriteRequest Behavior Change
 
-**Location**: `adk/filesystem/backend.go` **Change Description**: `WriteRequest` write behavior changed from "error if file exists" to "overwrite if file exists". **Before (main)**:
+**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)**:
 
 ```go
 // WriteRequest comment:
 // The file will be created if it does not exist, or error if file exists.
 ```
 
-**After (v0.8.0.Beta)**:
+**After (v0.8.0)**:
 
 ```go
 // WriteRequest comment:
@@ -193,14 +191,14 @@ type FileInfo struct {
 
 ### 2.5 GrepRequest.Pattern Semantic Change
 
-**Location**: `adk/filesystem/backend.go` **Change Description**: `GrepRequest.Pattern` changed from literal matching to regular expression matching. **Before (main)**:
+**Location**: `adk/filesystem/backend.go` **Change Description**: `GrepRequest.Pattern` changed from literal matching to regular expression matching. **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.Beta)**:
+**After (v0.8.0)**:
 
 ```go
 // Pattern is the search pattern, supports full regular expression syntax.

content/en/docs/eino/release_notes_and_migration/v02_second_release.md

@@ -74,7 +74,7 @@ weight: 2
 
 ### BugFix
 
-- Fixed the SSTI vulnerability in the Jinja chat template [langchaingo has gonja template injection vulnerability](https://bytedance.larkoffice.com/docx/UvqxdlFfSoTIr1xtsQ5cIZTVn2b)
+- Fixed the SSTI vulnerability in the Jinja chat template（langchaingo gonja template injection）
 
 ## v0.2.0