是小鬏鬏啊1. 初识 Eino 框架中的 ChatModel 与 Message
作为一名长期从事 AI 应用开发的工程师，我深刻理解初学者在面对新框架时容易陷入的误区。Eino 框架中的 ChatModel 和 Message 这两个基础概念，看似简单却蕴含着整个框架的设计哲学。它们就像建筑的地基，虽然不如上层的 Agent、Tool 等功能炫目，但却是构建稳定 AI 应用的关键。
在 Go 语言生态中，Eino 提供了一种优雅的方式来处理大模型交互。不同于直接调用厂商 SDK 的粗放方式，Eino 通过 ChatModel 和 Message 建立了清晰的抽象层。这种设计让开发者能够专注于业务逻辑，而不必被不同模型提供商的 API 差异所困扰。
提示：理解 ChatModel 和 Message 的关键在于认识到它们分别解决了"如何调用模型"和"如何组织对话"这两个根本问题。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. ChatModel 的深层价值解析
2.1 统一模型调用边界
在实际项目中，模型供应商的更换是常有的事。可能因为成本、性能或政策原因，今天用 OpenAI，明天就要切换到千问或 Claude。如果没有 ChatModel 这样的抽象层，每次切换都意味着大量代码修改。
ChatModel 通过定义统一的接口，将模型调用的细节封装起来。作为开发者，你只需要关心：
- 输入一组结构化的 Message
- 获取模型返回的响应
这种抽象使得上层业务代码与具体模型实现解耦，大大提高了系统的可维护性。
2.2 为高级功能奠定基础
Eino 框架中的 Agent、Runner 等高级功能都建立在 ChatModel 的基础之上。正是因为有了这层稳定的抽象，上层的编排才能灵活组合。想象一下，如果每个工具调用都要直接处理不同模型的 API 差异，那代码很快就会变得难以维护。
2.3 测试友好性
在单元测试中，我们经常需要模拟外部依赖。ChatModel 的接口定义明确，使得创建测试用的 Mock 实现变得非常简单。你可以轻松模拟各种边界情况，而不必实际调用昂贵的模型 API。
go复制// 示例：创建一个测试用的 MockChatModel
type MockChatModel struct {
Response string
Error error
}
func (m *MockChatModel) Stream(ctx context.Context, messages []*schema.Message) (schema.ChatStream, error) {
if m.Error != nil {
return nil, m.Error
}
return &mockStream{content: m.Response}, nil
}
3. Message 的结构化设计哲学
3.1 超越简单的字符串拼接
许多初学者容易将对话简单地视为字符串拼接，这种认知在简单场景下可能够用，但在复杂交互中很快就会遇到瓶颈。Eino 的 Message 设计引入了角色(role)的概念，将对话视为一组有结构的消息序列。
主要的消息角色包括：
system: 系统指令，设定对话的背景和规则user: 用户输