Skip to content

Commit 14cd757

Browse files
chore(eino): sync english docs
1 parent 5033b29 commit 14cd757

25 files changed

+729
-90
lines changed

content/en/docs/eino/FAQ.md

Lines changed: 18 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
Description: ""
3-
date: "2025-12-01"
3+
date: "2025-12-11"
44
lastmod: ""
55
tags: []
66
title: FAQ
@@ -9,7 +9,7 @@ weight: 6
99

1010
# Q: cannot use openapi3.TypeObject (untyped string constant "object") as *openapi3.Types value in struct literal; cannot use types (variable of type string) as *openapi3.Types value in struct literal
1111

12-
Ensure the `github.com/getkin/kin-openapi` dependency version does not exceed `v0.118.0`.
12+
Ensure the `github.com/getkin/kin-openapi` dependency version does not exceed `v0.118.0`. Starting from Eino `v0.6.0`, Eino no longer depends on the `kin-openapi` library.
1313

1414
# Q: During agent streaming, it never reaches ToolsNode, or streaming is lost and appears non-streaming.
1515

@@ -111,15 +111,26 @@ Check whether the model supports image input (for Doubao models, only variants w
111111

112112
# Q: How to access Reasoning Content / “thinking” output from a chat model?
113113

114-
If a model implementation supports Reasoning Content (deep thinking), it is stored in the `Extra` field of the output `Message`. The provider package usually offers helpers like `GetReasoningContent`/`GetThinking` to extract it.
114+
If the model implementation supports Reasoning Content, it is stored in the `ReasoningContent` field of the output `Message`.
115115

116116
# Q: Errors include `context deadline exceeded`, `timeout`, or `context canceled`
117117

118-
This indicates a timeout or that the `ctx` was canceled by a service/framework or manually. Adjust timeouts or investigate your code. If model/component latency seems abnormally high, contact the provider directly. Eino only passes through.
118+
Cases:
119+
120+
1. `context.canceled`: While executing a graph or agent, the user code passed a cancelable context and triggered cancellation. Investigate your application’s context-cancel logic. This is unrelated to the Eino framework.
121+
2. `context deadline exceeded`: Two common possibilities:
122+
1. During graph or agent execution, the user code passed a context with a timeout, which was reached.
123+
2. A `ChatModel` or other external resource has its own timeout configured (or its HTTP client does), which was reached.
124+
125+
Inspect the thrown error for `node path: [node name x]`. If the node name is not a `ChatModel` or any node that performs external calls, it is likely case 2-a; otherwise, it is likely case 2-b.
126+
127+
If you suspect 2-a, trace upstream to find where a timeout was set on the context (common sources include FaaS platforms, gateways, etc.).
128+
129+
If you suspect 2-b, check whether the node itself configures a timeout (e.g., Ark ChatModel `Timeout`, or OpenAI ChatModel via an `HttpClient` with `Timeout`). If none are configured but timeouts still occur, it may be the SDK’s default timeout. Known defaults: Ark SDK 10 minutes; Deepseek SDK 5 minutes.
119130

120131
# Q: How to access parent graph `State` within a subgraph?
121132

122-
If both parent and subgraph have `state`, the subgraph’s state overrides the parent’s. Define a custom context key. Before invoking the subgraph, call `compose.ProcessState()` to retrieve the parent state and pass it via your custom context key.
133+
If the subgraph and parent graph have different `State` types, use `ProcessState[ParentStateType]()` to process the parent’s state. If they share the same `State` type, make the types distinct (for example, with a type alias: `type NewParentStateType StateType`).
123134

124135
# Q: How does `eino-ext` adapt multimodal input/output for supported models?
125136

@@ -137,7 +148,6 @@ If `eino-ext` modules error with `undefined: schema.NewParamsOneOfByOpenAPIV3`,
137148

138149
If schema migration is complex, use the helper tooling in the [JSONSchema conversion guide](https://bytedance.larkoffice.com/wiki/ZMaawoQC4iIjNykzahwc6YOknXf).
139150

140-
# Q: `context canceled` / `context deadline exceeded`
141-
142-
The `ctx` passed to Eino was canceled or timed out; this is unrelated to the framework itself.
151+
# Q: Which ChatModels in `eino-ext` support the Responses API form?
143152

153+
By default, ChatModels generated by `eino-ext` do not support the Responses API; they support only the Chat Completions API. A special case is the Ark Chat Model, which implicitly supports the Responses API when you set `Cache.APIType = ResponsesAPI`.

content/en/docs/eino/_index.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
Description: Eino is a Golang-based AI application development framework
3-
date: "2025-11-20"
3+
date: "2025-12-09"
44
lastmod: ""
55
linktitle: Eino
66
menu:
@@ -12,4 +12,3 @@ title: Eino User Manual
1212
weight: 6
1313
---
1414

15-

0 commit comments

Comments
 (0)