Skip to content

Commit 9278a8d

Browse files
docs(eino): sync chinese docs from feishu
1 parent e4884cf commit 9278a8d

68 files changed

Lines changed: 271 additions & 240 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ Description: ""
33
date: "2026-03-02"
44
lastmod: ""
55
tags: []
6-
title: 'Eino: Cookbook'
6+
title: Cookbook
77
weight: 3
88
---
99

content/zh/docs/eino/FAQ.md

Lines changed: 2 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -142,13 +142,12 @@ eino-ext 支持的多模态输入输出场景,可以查阅 [https://www.cloudw
142142

143143
eino-ext 部分 module 报错 undefined: schema.NewParamsOneOfByOpenAPIV3 等问题,升级报错的 eino-ext module 到最新版本即可。
144144

145-
如果 schema 改造比较复杂,可以使用 [JSONSchema 转换方法](https://bytedance.larkoffice.com/wiki/ZMaawoQC4iIjNykzahwc6YOknXf)文档中的工具方法辅助转换
145+
如果 schema 改造比较复杂,可以使用现有的 OpenAPI 3.0 → JSONSchema 转换工具方法辅助转换
146146

147147
# Q: Eino-ext 提供的 ChatModel 有哪些模型是支持 Response API 形式调用嘛?
148148

149149
- Eino-Ext 中目前只有 ARK 的 Chat Model 可通过 **NewResponsesAPIChatModel **创建 ResponsesAPI ChatModel,其他模型目前不支持 ResponsesAPI 的创建与使用,
150-
- Eino-byted-ext 中 只有 bytedgpt 支持创建 Response API 通过 **NewResponsesAPIChatModel 创建, **其他 chatmodel 没有实现 Response API Client
151-
- 版本 components/model/gemini/v0.1.16 已经支持 thought_signature 回传,检查 gemini 版本是否符合,如果使用的是 bytedgemini (code.byted.org/flow/eino-byted-ext/components/model/bytedgemini) 的 chatmodel 实现,请检查其依赖的 components/model/gemini 是否为最新版本,或者直接 go get 升级 gemini - 将目前使用的 bytedgpt 的包换成使用 [code.byted.org/flow/eino-byted-ext/components/model/bytedgemini](http://code.byted.org/flow/eino-byted-ext/components/model/bytedgemini) 这个包的实现,并升级到最新版本,查看示例代码 确认 BaseURL 如何传递 。 - 遇到这个报错请确认咱们生成 chat model 是填写的 base url 是 chat completion 的 URL 还是 ResponseAPI 的 URL,绝大多数场景是错误传递了 Response API 的 Base URL
150+
- 遇到这个报错请确认咱们生成 chat model 是填写的 base url 是 chat completion 的 URL 还是 ResponseAPI 的 URL,绝大多数场景是错误传递了 Response API 的 Base URL
152151

153152
# Q: 如何排查 ChatModel 调用报错?比如[NodeRunError] failed to create chat completion: error, status code: 400, status: 400 Bad Request。
154153

@@ -173,35 +172,3 @@ ChatModel 产生的 Tool Call 中,Argument 字段是 string。Eino 框架在
173172
- Flow/React Agent 场景下获取中间结构参考文档 [Eino: ReAct Agent 使用手册](/zh/docs/eino/core_modules/flow_integration_components/react_agent_manual)
174173

175174
# Q: Gemini 模型报错 missing a `thought_signature`
176-
177-
Gemini 模型协议不是 openai-compatible,应使用 gemini 封装 [https://github.com/cloudwego/eino-ext/tree/main/components/model/gemini](https://github.com/cloudwego/eino-ext/tree/main/components/model/gemini), 如果使用 ModelHub 平台的模型,使用内场 gemini 封装 [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),初始化参考代码:
178-
179-
```
180-
cm, err := bytedgemini.NewChatModel(ctx, &bytedgemini.Config{
181-
ClientConfig: genai.ClientConfig{
182-
APIKey: apiKey,
183-
Backend: genai.BackendGeminiAPI,
184-
// uncomment if you want to print the actual request in CURL format
185-
// HTTPClient: &http.Client{Transport: NewCurlLogger(http.DefaultTransport, log.Printf)},
186-
HTTPOptions: genai.HTTPOptions{
187-
// this is base URL for cn, other regions:
188-
// - sg: gpt-i18n.byteintl.net
189-
// - sg from office network: genai-sg-og.tiktok-row.org
190-
// - va: search-va.byteintl.net
191-
// - va from office network: genai-va-og.tiktok-row.org
192-
// - Non-TT: gpt-i18n.bd.byteintl.net
193-
// - US-TTP: gpt.tiktokd.net
194-
// - EU-TTP, GCP: gpt.tiktoke.org
195-
// - JP: gpt-jp.byteintl.net
196-
// see also: https://bytedance.larkoffice.com/wiki/wikcnUPXCY2idGyg2AXKPvay4pd
197-
BaseURL: "https://search.bytedance.net/gpt/openapi/online/multimodal/crawl/google/",
198-
APIVersion: "v1",
199-
},
200-
},
201-
Model: modelName,
202-
ThinkingConfig: &genai.ThinkingConfig{
203-
IncludeThoughts: true,
204-
ThinkingBudget: nil,
205-
},
206-
})
207-
```

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ Description: ""
33
date: "2025-07-21"
44
lastmod: ""
55
tags: []
6-
title: 'Eino: 核心模块'
6+
title: 核心模块
77
weight: 4
88
---
99

content/zh/docs/eino/core_modules/chain_and_graph_orchestration/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ Description: ""
33
date: "2025-07-21"
44
lastmod: ""
55
tags: []
6-
title: 'Eino: Chain & Graph & Workflow 编排功能'
6+
title: Chain & Graph & Workflow 编排功能
77
weight: 2
88
---
99

content/zh/docs/eino/core_modules/chain_and_graph_orchestration/call_option_capabilities.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ Description: ""
33
date: "2025-11-20"
44
lastmod: ""
55
tags: []
6-
title: 'Eino: CallOption 能力与规范'
6+
title: CallOption 能力与规范
77
weight: 6
88
---
99

content/zh/docs/eino/core_modules/chain_and_graph_orchestration/callback_manual.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ Description: ""
33
date: "2026-03-02"
44
lastmod: ""
55
tags: []
6-
title: 'Eino: Callback 用户手册'
6+
title: Callback 用户手册
77
weight: 5
88
---
99

content/zh/docs/eino/core_modules/chain_and_graph_orchestration/chain_graph_introduction.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ Description: ""
33
date: "2026-01-20"
44
lastmod: ""
55
tags: []
6-
title: 'Eino: Chain/Graph 编排介绍'
6+
title: Chain/Graph 编排介绍
77
weight: 1
88
---
99

content/zh/docs/eino/core_modules/chain_and_graph_orchestration/checkpoint_interrupt.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ Description: ""
33
date: "2026-03-02"
44
lastmod: ""
55
tags: []
6-
title: 'Eino: Interrupt & CheckPoint使用手册'
6+
title: Interrupt & CheckPoint使用手册
77
weight: 7
88
---
99

content/zh/docs/eino/core_modules/chain_and_graph_orchestration/orchestration_design_principles.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
22
Description: ""
3-
date: "2026-03-02"
3+
date: "2026-03-09"
44
lastmod: ""
55
tags: []
6-
title: 'Eino: 编排的设计理念'
6+
title: 编排的设计理念
77
weight: 2
88
---
99

content/zh/docs/eino/core_modules/chain_and_graph_orchestration/stream_programming_essentials.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -101,7 +101,7 @@ Collect 和 Transform 两种流式范式,目前只在编排场景有用到。
101101
上面的 Concat message stream 是 Eino 框架自动提供的能力,即使不是 message,是任意的 T,只要满足特定的条件,Eino 框架都会自动去做这个 StreamReader[T] 到 T 的转化,这个条件是:**在编排中,当一个组件的上游输出是 StreamReader[T],但是组件只提供了 T 作为输入的业务接口时,框架会自动将 StreamReader[T] concat 成 T,再输入给这个组件。**
102102

103103
> 💡
104-
> 框架自动将 StreamReader[T] concat 成 T 的过程,可能需要用户提供一个 Concat function。详见 [Eino: 编排的设计理念](/zh/docs/eino/core_modules/chain_and_graph_orchestration/orchestration_design_principles#share-FaVnd9E2foy4fAxtbTqcsgq3n5f) 中关于“合并帧”的章节。
104+
> 框架自动将 StreamReader[T] concat 成 T 的过程,可能需要用户提供一个 Concat function。详见 [Eino: 编排的设计理念](/zh/docs/eino/core_modules/chain_and_graph_orchestration/orchestration_design_principles) 中关于“合并帧”的章节。
105105
106106
另一方面,考虑一个相反的例子。还是 React Agent,这次是一个更完整的编排示意图:
107107

0 commit comments

Comments
 (0)