3.1 从空白到会话：创建聊天助手

3.1 从空白到会话：创建聊天助手

创建聊天助手的全部动作：工作室点"创建空白应用"，选聊天助手，命名，进入编排界面。真正值得学的是创建之后那块画布的分区逻辑，以及调试面板与真实发布行为的差异——理解这两点，后续每一章的界面操作都不再需要教程手把手。

开台完毕（第 2 章），现在兑现产品经理的第一个里程碑。本节是四拍里的第一拍，产出是一个能出话的应用骨架；它直接把接力棒交给 3.2 的提示词编排。

五分钟完成创建

工作室右上角"创建空白应用"，弹出的对话框就是 1.2 节那张选型表的界面形态：选择"聊天助手"，给应用起名"小艺-电商客服"，可选填一段描述（这是给团队成员看的，不给终端用户看）。确认后直接进入编排界面。

第一个动作不是写提示词，而是右上角确认模型：默认取系统推理模型（2.2 节设的那个），此刻可以不动。然后在调试面板发一句：

你好，请问你们支持七天无理由退货吗？
​

收到模型的一段通用回答——恭喜，骨架已经活了。此刻的小艺还没有人设，回答全凭模型本能在编。这正好是第一拍的完成判据：调试面板能出话。别急着打磨回答质量，先把画布的布局看明白。

编排面板三块分区

聊天助手的编排界面横向切成三块，职责严格分离：

左边，提示词与变量区。系统提示词（人设的家）、前缀提示词（历史之前插入的引导语）、用户输入表单变量。第 3.2 节的主战场。

中间偏右，功能配置区，以折叠分组的形式组织。逐项点开扫一眼，混个脸熟即可，用到再回来精读：

最右，调试面板。嵌在页面里的对话窗口，所有改动即时生效。它和发布后的真实行为高度一致，但有一个关键差异要记在心里：调试面板的会话属于搭建者本人，不会进入正式的日志统计；发布后的用户会话才进。所以验收数据要看日志面板，不要只看调试感觉。

用变量记住用户是谁

聊天助手支持"用户输入表单"：在会话开始前向用户收集几个字段，之后注入提示词。小艺的用法是问一句身份——会员等级不同，退换货政策确实不同。

在变量区添加一个文本变量 member_level，显示名"你的会员等级"，然后在系统提示词里引用它（写法 3.2 节详解）。发布后的 WebApp 首屏会出现这个输入项，用户填一次，整轮会话都带着这个身份。

变量清单（首搭定稿）
member_level   文本   显示名：你的会员等级   必填：是
​

克制提醒：变量每加一个，用户首屏就多一道坎。首搭一个足够，多了等真实用户数据来证明必要性。

开场白与建议问题

功能配置区里把开场白写上。开场白不是欢迎词，是任务引导——告诉用户这个助手能干什么、怎么问效率最高：

开场白：你好，我是小艺。可以问我退换货政策、运费规则、
发票开具等售后问题。描述越具体，回答越准确。

建议问题（最多三条）：
1. 七天无理由退货的具体条件是什么？
2. 退货运费谁来承担？
3. 电子发票怎么开？
​

建议问题还有个隐藏作用：它是你的测试用例。第 3.3 节验收时，就把这三条连同它们的变体（换个问法、加错别字）跑一遍——用户会怎么问，你就先怎么问。

保存、版本与 DSL 导出

界面右上方的操作里有两件跟"工程化"有关的事值得现在养成习惯。其一是导出 DSL：把应用配置（提示词、变量、模型设置，含或不含密钥自选）导出成 YAML 文件，提交进版本库。改坏界面配置时，一份 DSL 就是回滚点——这是 1.1 节"DSL 是分水岭"的日常兑现。其二是复制应用：大改之前复制一份当沙盒，改废了直接删，主线应用毫发无损。

从空白到骨架的完整操作回放

把本节动作压缩成一张操作卡，第一次搭建时照着走，五分钟完事：

创建应用操作卡
1. 工作室右上角：创建空白应用
2. 选"聊天助手"，名称填"小艺-电商客服"，描述可空（给团队看的备注）
3. 进入编排界面，右上角确认模型为系统默认推理模型（2.2 设过）
4. 调试面板发一句"你好，请问你们支持七天无理由退货吗" → 收到回复即达标
5. 变量区添加 member_level：文本 / 显示名"你的会员等级" / 必填
6. 功能区写开场白与三条建议问题（内容见上文）
7. 右上角导出 DSL，文件提交进团队文档或版本库
​

第七步最容易被省略，但它的价值在第 7 章会兑现成"十分钟回滚"的底气。养成"每完成一个里程碑就导一份"的节奏，比事后补记可靠得多——DSL 之外，界面没有自动的历史版本。

问题：空白应用和模板应用怎么选？

创建入口旁边通常还有一批官方模板（客服、翻译、代码助手等）。我的建议：学习期用模板拆解，交付期从空白搭。模板是别人做好的成品，拆两个能快速看到"好的开场白、变量、提示词长什么样"；但它也自带一堆你不需要的配置，删干净比从零搭更费神，而且模板的提示词掩盖了你本该经历的迭代过程。本教程主线全部从空白起步，正是要把每一步配置的"为什么"都过一遍手。

# 导出的 DSL 片段：首搭结束时的应用形态快照
app:
  mode: chat-app
  name: 小艺-电商客服
model:
  provider: openai
  name: gpt-4o-mini
  completion_params:
    temperature: 0.3        # 3.3 节会解释为什么是 0.3
​

⚠️ 常见坑：把调试面板当成发布环境用——自己在调试里问了几十轮，感觉良好就宣布上线。调试面板不产生用户日志，首屏变量行为也和 WebApp 有细微差别。发布验收必须在真实 WebApp 里、用非本人账号走一遍。

本节要点回顾

• 第一拍判据：创建后调试面板能出话，骨架即告成立，不急于打磨内容；
• 三块分区：提示词变量区、功能配置区、调试区，职责分离，后续章节按图索骥；
• 变量克制：首搭只收 member_level 一个，每多一个变量就多一分流失；
• 开场白即任务引导：建议问题同时是你的第一批测试用例；
• 工程习惯从第一天开始：DSL 导出入库、大改前复制沙盒。

骨架已立、能出话但没人设。下一节写系统提示词——给小艺装上大脑里最重要的一段话。