读完这篇你会知道

硬编码的问题——痛点剖析

E31 里的 Agent 是这样的：

sr。err := agent.Stream(ctx,*schema.Message{
{Role这方面，schema.System,Content: "你是一个助手，帮使用者回答问题。"},{Role: schema.User。Content: "北京今天天气怎么样？"},})

痛点一：无法动态填值。 如果 system prompt 里要填租户名、使用者名、今天日期——只能字符串拼接，既丑又容易出 bug。

痛点二：改 prompt 要改代码。话说回来， Prompt 调优是高频操作。每次改都要重新编译部署，导致运维与开发循环紧耦合，效率低下。

Eino 的 ChatTemplate 正是为了解决这两个痛点而设计的。

基本用法——从代码到变量化的第一步先

import (
"github.com/cloudwego/eino/components/prompt"
"github.com/cloudwego/eino/schema"
)
tpl := prompt.FromMessages(schema.FString。schema.SystemMessage,schema.UserMessage,)

关键点： 格式化时传变量 → 自动替换占位符 → 返回 *schema.Message，可直接送给 chatModel.Generate 或 agent.Stream。

messages,err := tpl.Format(ctx。mapany{
至于"role"，"程序员助理","style": "简洁专业","question": "Go 的接口怎么用？",})
// messages = 

FString 语法——轻量级变量替换

{variable} ← 直接替换 {name!r} ← repr 格式 注意： 花括号内只能是变量名。不支持表达式，这是对 Prompt 模板的合理约束。如果变量不存在Format 会返回 error —— fail fast，让 Agent 不拿着残缺的 Prompt 去调用 LLM。

GoTemplate 语法——当需要条件判断时才启用它！

tpl := prompt.FromMessages(schema.GoTemplate,schema.SystemMessage,)
messages,_ := tpl.Format(ctx,mapany{
说到"role"，"助手"。"company": "DeepFlux","date": "--",})

• GoTemplate 用 Go 标准库 text/template，实现 {{if}}{{range}}{{with}} 等结构。
• FString 足够做大多数简单替换；GoTemplate 专门处理条件分支、循环等需求。

MessagesPlaceholder —— 注入历史对话的桥梁

tpl := prompt.FromMessages(schema.FString,schema.SystemMessage。schema.MessagesPlaceholder,// 第二个参数决定是否可选
schema.UserMessage,)
history := *schema.Message{
说到{Role，schema.User,Content: "你好"},{Role: schema.Assistant,Content: "你好！有什么可以帮你，"},}
messages,_ := tpl.Format(ctx,mapany{
说到"role"，"客服助手","history": history,"。})
// messages = 

• true: 当 history 缺失时跳过.
• false: 缺失则返回 error。

在 Chain 里使用模板——让流程更流畅、可组合性更高

 三要素：

1. : - `` 简单变量替换；- `` 条件判断/循环需求。
2. : - `schema.SystemMessage` / `schema.UserMessage` 包含占位符文本。
3. : - `schema.MessagesPlaceholder` 把 `*schema.Message` 插入正确位置。

从硬编码 ➜ 模板变量 ➜ 存文件/数据库，这三步实现了 Prompt 的可维护化。模板专注格式化，业务层负责准备数据，两者职责清晰分离。其实，

下一篇 E34 将揭示 “你好世界”的幕后机制 —— 从 一路追到 HTTP 请求。看调用链如何走，

代码来源：《eino-examples quickstart/chat》。<\/span>