eino-examples/quickstart/chatwithdoc/docs/ch01_chatmodel_agent_console.md

title
第一章：ChatModel 与 Message（Console）

本章目标：用最小代码调用一次 ChatModel（支持流式输出），并掌握 schema.Message 的基本用法。

代码位置

• 入口代码：cmd/ch01/main.go

前置条件

• Go 版本：与本目录 go.mod 一致
• 一个可调用的 ChatModel（默认使用 OpenAI；也支持 Ark）

本 quickstart 复用 github.com/cloudwego/eino-examples/adk/common/model.NewChatModel() 来创建模型，它会读取环境变量选择不同 provider：

方式 A：OpenAI（默认）

需要配置（最小集合）：

• OPENAI_API_KEY
• OPENAI_MODEL

可选：

• OPENAI_BASE_URL（例如走代理或兼容 OpenAI 协议的服务）
• OPENAI_BY_AZURE=true（如使用 Azure OpenAI）

示例：

export OPENAI_API_KEY="..."
export OPENAI_MODEL="gpt-4.1-mini"

方式 B：Ark

需要配置：

• MODEL_TYPE=ark
• ARK_API_KEY
• ARK_MODEL

可选：

• ARK_BASE_URL

示例：

export MODEL_TYPE="ark"
export ARK_API_KEY="..."
export ARK_MODEL="..."

关键概念（只讲本章用到的）

• schema.Message：对话消息。常见角色为 system/user/assistant/tool。本章使用 system + user 作为输入。
• ChatModel：模型组件，负责基于一组 messages 生成回复。示例中用 model.NewChatModel() 创建。

运行

在本章里我们用 Console 直接运行，不启动 Web 服务。

cd /Users/bytedance/github/eino/examples/quickstart/chatwithdoc
go run ./cmd/ch01 -- "用一句话解释 Eino 的 Component 设计解决了什么问题？"

你会看到类似输出（流式逐步打印）：

[assistant] ...

入口代码做了什么

按执行顺序：

1. NewChatModel() 创建 ChatModel（从环境变量选择 OpenAI/Ark）
2. 构造输入 messages：SystemMessage(instruction) + UserMessage(query)
3. 优先尝试 ChatModel.Stream(...) 并打印流式输出；若不支持则回退到 ChatModel.Generate(...)