按理说，

再看Eino框架，Agent驱动多轮对话实践

在传统的 ChatModel 方式中。每一次调用都像是一次全新的 HTTP 请求，导致模型无法记住之前的上下文。这种“记忆缺失”往往让开发者在实现多轮对话时频繁手动拼接历史消息，既繁琐又容易出错。

再看痛点一。模型无法持久化上下文

当我们仅使用 ChatModel 时每次调用都是独立的，对话历史需要自己维护并手工传递。

再看痛点二。代码重复且难以

同一段逻辑要在不同场景下复用，比如开启流式输出、添加工具调用等，都需要额外改动。按理说，

痛点三的观点是。错误处理与监控分散

直接调用模型后错误捕获、日志记录还有后续监控往往散落在业务层，缺乏统一管理。

用 Agent 实现多轮对话

这里通过 Agent + Runner 的组合来解决上述痛点，实现真正意义上的多轮连续对话。

区别概览

从打个比方来看，ChatModel 像直接发 HTTP 请求；Agent 则像一个 SDK，帮你完成 system prompt、输出格式等常规工作。

主要代码示例

// 创建 Agent
agent,_ := adk.NewChatModelAgent(ctx,&adk.ChatModelAgentConfig{
Instruction: "你是个助手",Model: cm,})
// 创建 Runner
runner := adk.NewRunner(ctx。adk.RunnerConfig{
说到Agent，agent,EnableStreaming: true,})
// 多轮对话
history := *schema.Message{}
for {
history = append)
events := runner.Run
reply := collectReply
history = append)
}

Agent 封装了什么？

• 自动加 system prompt：`Instruction` 字段会自动变成 SystemMessage,无需手工构造。
• 统一输出格式：无论流式还是非流式。都走事件流模式，处理逻辑保持一致。
• 预留 点：ID 后期可插入工具调用、中间件等，而接口保持不变。
• // 等价写法示例：
• 传统写法：  

  messages := *schema.Message{
  schema.SystemMessage,schema.UserMessage,}
  stream,_ := cm.Stream
  }

• 使用 Agent 自动加 SystemMessage：  

  agent。_ := adk.NewChatModelAgent(ctx,&adk.ChatModelAgentConfig{
  Instruction: "你是个助手",Model: cm,})
  // Run 时只传 UserMessage 即可
  events := runner.Run
  }

A Runner is executor of an Agent. 给它一个 Agent 和输入，它会返回一个事件流，而不是直接返回文本。这样做能把生命周期管理、状态维护和事件分发集中起来让业务层更专注于业务逻辑而不是细节。

// 示例
runner := adk.NewRunner(ctx,adk.RunnerConfig{
Agent的观点是，agent,EnableStreaming: true。})
events := runner.Run // 返回事件流
}

A Agent 本身并不存储历史。实现多轮会把完整历史作为参数传进去。从例如来看，

// 第一轮
history =
// 模型回复："你好！"
// 第二轮
history =
// 模型能看到完整上下文。回复："你说了你好"
}

从关键要点来看，每次调用都带上完整历史；因为历史增长，上下文也随之丰富。

事件流怎么读？

A Runner 返回的是一个事件流而非直接文本。此事件流像管道一样，将每一步结果实时推送给使用者。

events := runner.Run
for {
event,ok := events.Next
if!ok { break } // 流结束
if event.Err!= nil { /* 处理错误 */ }
mv := event.Output.MessageOutput
if mv.Role!= schema.Assistant { continue }
if mv.IsStreaming {
for {
frame,err := mv.MessageStream.Recv
if errors.Is { break }
fmt.Print
}
} else {
fmt.Print
}
}
}

为什么要事件流？因为以后加入工具调用，只需在同一条流水线中插入工具事件，不必改业务逻辑；所有输出统一从同一源读取.

AgentEvent 里有什么？

# Struct Overview: AgentEvent{ ├── Err // 错误 ├── Output { └── MessageOutput { ├── Role // Assistant / User / System / Tool ├── IsStreaming // 是否流式 ├── Message // 非流式时完整消息 └── MessageStream // 流式时 StreamReader {

`ToolCall` / `Action` fields for tool invocation and control directives.

什么时候用 Agent？

• - 简单问答可以直接使用
• - 若计划加入以下功能则选择 Agent：
• 工具调用;
• 中断恢复。
<\/ul> <\/ul>