03｜ChatModel 實(shí)戰(zhàn)：消息、參數(shù)與多輪對(duì)話《Eino 實(shí)戰(zhàn)：用 Go 構(gòu)建 AI 應(yīng)用與智能體》· 第 03 篇關(guān)鍵詞：schema.Message、角色、Generate、Stream、生成參數(shù)、多輪對(duì)話、上下文前置條件：已完成 [02｜搭建開(kāi)發(fā)環(huán)境](02｜搭建開(kāi)發(fā)環(huán)境：創(chuàng)建第一個(gè) Eino 項(xiàng)目.md)，項(xiàng)目能夠成功調(diào)用模型。上一篇我們跑通了第一次調(diào)用，但那只是一個(gè)單次問(wèn)答。真實(shí)的工單助手需要記住上下文：“這單”“剛才那個(gè)用戶”指的都是前幾輪說(shuō)過(guò)的內(nèi)容。要把它做對(duì)，必須先回答一個(gè)基礎(chǔ)問(wèn)題：模型到底收到了什么？答案是：一份消息列表。模型本身沒(méi)有記憶，你看到的“多輪對(duì)話”，其實(shí)是你每次把歷史記錄一起發(fā)過(guò)去的結(jié)果。這一篇就圍繞消息列表、生成參數(shù)和多輪組織方式展開(kāi)。一、消息列表就是模型的全部輸入調(diào)用Generate時(shí)，你傳的是一個(gè)[]*schema.Message：typeMessagestruct{Role RoleType// system / user / assistant / toolContentstring// 文本內(nèi)容ToolCalls[]ToolCall// 僅 assistant 消息使用ToolCallIDstring// 僅 tool 消息使用ToolNamestring// 僅 tool 消息使用ReasoningContentstring// 模型的推理內(nèi)容（若返回）ResponseMeta*ResponseMeta// 結(jié)束原因、Token 用量等Extramap[string]any// 實(shí)現(xiàn)相關(guān)的附加信息}（以上摘自 Eino v0.9.21 的schema.Message，省略了多模態(tài)等字段，稍后會(huì)單獨(dú)說(shuō)明。）其中有兩點(diǎn)值得強(qiáng)調(diào)：Role決定這條消息是誰(shuí)說(shuō)的。模型依據(jù)角色理解對(duì)話結(jié)構(gòu)，寫(xiě)錯(cuò)角色會(huì)直接改變模型行為。ResponseMeta是模型的“回執(zhí)”。結(jié)束原因和 Token 用量都在這里，而不是在Content里。四種角色角色常量用途systemschema.System整體行為約束、角色設(shè)定、輸出要求userschema.User用戶輸入assistantschema.Assistant模型此前的回復(fù)toolschema.Tool工具調(diào)用結(jié)果（第 11 篇展開(kāi)）對(duì)應(yīng)有便捷構(gòu)造函數(shù)：system:=schema.SystemMessage("你是工單助手。")user:=schema.UserMessage("打印機(jī)連不上網(wǎng)。")// assistant 消息需要傳入 toolCalls，無(wú)工具調(diào)用時(shí)傳 nilassistant:=schema.AssistantMessage("已記錄，請(qǐng)?zhí)峁┚唧w樓層。",nil)也可以直接構(gòu)造結(jié)構(gòu)體，兩種方式等價(jià)：msg:=schema.Message{Role:schema.User,Content:"打印機(jī)連不上網(wǎng)。"}日常建議用構(gòu)造函數(shù)，可讀性更好，也不容易把Role寫(xiě)錯(cuò)。二、Generate 與 Stream：同一份輸入，兩種輸出兩者的輸入完全相同，差別只在返回方式：// 非流式：等模型輸出完整內(nèi)容后一次返回msg,err:=cm.Generate(ctx,messages)// 流式：立即返回讀取器，逐片接收sr,err:=cm.Stream(ctx,messages)defersr.Close()選擇哪一種，取決于交互形態(tài)：場(chǎng)景建議后臺(tái)批處理、只關(guān)心最終結(jié)果Generate面向用戶、需要逐步展示