对话与会话

已发布 Agent 提供完整聊天页；编辑器右侧预览用于构建期调试。会话在第一条消息发送时创建，并保存变量、消息数和 Token 用量。

开始对话

从应用页开始

1. 前往应用（/app/apps）。
2. 选择 Agent 标签，找到要使用的 Agent。
3. 打开 Agent 卡片菜单，选择对话。
4. Agent 聊天页打开于 /chat/{agent_id}，发送第一条消息即创建会话。

从现有聊天页继续

1. 打开 Agent 的聊天页。
2. 使用该页的会话控件继续最近会话或开始新会话。
3. 输入消息并发送。

聊天界面

布局

┌─────────────────────────────────────────────────┐
│  Agent 名称                    [设置] [...]      │
├─────────────────────────────────────────────────┤
│                                                  │
│  Agent: 你好！我能为你做些什么？                   │
│                                                  │
│  你: Clouisle 是什么？                            │
│                                                  │
│  Agent: Clouisle 是一个企业级...                  │
│  [来源: doc1.pdf, doc2.md]                        │
│                                                  │
├─────────────────────────────────────────────────┤
│  [📎] 输入消息...            [发送]              │
└─────────────────────────────────────────────────┘

关键元素

发送消息

文本消息

基本消息：

1. 在输入框输入消息
2. 按 Enter 或点击发送
3. 等待 Agent 回复（流式）

多行消息：

1. 输入消息
2. 按 Shift+Enter 换行
3. 按 Enter 发送

文件上传

若 Agent 启用附件：

1. 点击 📎 附件按钮
2. 从电脑选择文件
3. 支持的格式取决于 Agent 配置（PDF、DOCX、TXT、MD、CSV、XLSX、PPTX、图片等）
4. 等待文件上传/解析
5. 添加关于文件的提问
6. 点击发送

上传限制：

• 所有聊天上传单文件限制 10 MB（服务端强制）
• 每条消息最大文件数由 Agent 配置决定（默认 5）

详细文件支持与安全说明请参阅附件与媒体。

理解回复

流式响应

Agent 实时流式输出回复：

• 文本逐词出现，Agent 仍在生成时即可阅读
• 点击停止按钮中断生成

回复组成

回复可能包含以下部分：

• 正文：以流式增量显示。
• 思考过程：仅当模型提供且 Agent 未隐藏时显示。
• 参考文档：RAG 返回的分块、文档名和相关度。
• 工具调用：参数、结果、日志和产物；可由 Agent 隐藏详情。
• 媒体结果：图片或视频直接渲染到助手正文。
• 消息操作栏：复制、版本、Token、速度等；可由 Agent 隐藏。

思考时间线与来源引用

进度事件按实际发出顺序显示。检索、上下文压缩、推理、工具调用、媒体结果和正文可能交错出现，界面不会固定把检索放在最前面。

检索来源可能带有稳定的 citation_id。引用事实时使用精确的 [[cite:SOURCE_ID]] 标记，并将 SOURCE_ID 替换为来源返回的原值。

回复质量

高质量回复包括：

• 直接回答问题
• 相关上下文与细节
• 来源引用（使用知识库时）
• 清晰的结构与格式

若回复质量不佳：

• 更清晰地重述问题
• 提供更多上下文
• 将复杂问题拆分为简单部分
• 检查 Agent 是否关联了相关知识库

附件与媒体

附件为 Agent 提供用户资产（文档、图片）；媒体生成让 Agent 调用已授权的图片或视频模型。两者都需在 Agent 编排中显式启用。

默认附件限制：单文件 10 MB（1KB-50MB），每条消息 5 个（1-10）。图片只有在聊天模型支持视觉时才直接进入模型。

详细配置请参阅附件与媒体。

变量与表单

若 Agent 定义了必填变量，发送消息前需先完成变量表单。变量在提示词中以 {变量名} 引用，{query} 为当前用户消息。

1. 聊天页顶部显示变量表单
2. 填写必填字段
3. 输入消息并发送

停止、中途引导与重新生成

• 停止（Stop）：流式生成时点击停止按钮，客户端会立即中止 SSE 连接并通知 Worker 终止当前运行，消息状态标记为手动停止。
• 中途引导（Steering / User Guidance）：在 Agent 流式生成或思考的过程中，无需强行停止，用户可直接在输入框输入补充说明或修正意图并发送。系统会在输入框上方显示浮动胶囊（Floating Capsule）提示排队中的引导指令，并在思考时间线中以「用户引导（User Guidance）」步骤直观展示，将该轮次引导实时合流注入给大模型上下文。
• 编辑（Edit）：编辑历史用户消息会从该节点创建新分支，并以此上下文流式生成新回复。
• 重新生成（Regenerate）：重新生成助手消息会创建该轮次的新版本。多版本之间通过左右箭头切换活动分支，系统完整保留历史所有生成记录。
• 删除（Delete）：删除消息会递归清理其后续活动分支；删除会话会物理删除该会话及其全部历史消息。

滚动跟随与交互优化

• 发送即置底锁屏：点击发送后界面立即锁定并平滑滚动到最新用户气泡，无需等待流式首包，杜绝界面冻结与首词跳动。
• 思考过程折叠条：支持展开/收起思考链路（Chain of Thought），流式推送时自动跟踪滚动状态；工具调用卡片支持实时参数折叠、日志查看与生成文件一键下载。
• 追问与排队：在上轮运行完成瞬间或流式末尾输入追问（Follow-up），系统自动持久化该消息并继续驱动下一轮推理。

消息分支

对话可包含多个分支：

主对话:
你: 告诉我关于 AI
Agent: AI 是...

分支 1（编辑消息）:
你: 告诉我关于 ML
Agent: ML 是...

分支 2（重新生成）:
Agent: AI，即人工智能...

使用箭头按钮在分支间导航。

管理会话

会话侧栏支持新建、选择、重命名和删除自己的会话。标题最多 200 字符，也是会话唯一可编辑的设置。

新建

点击侧栏顶部的**新建对话（SquarePen）**按钮开始一个新会话；发送第一条消息时才会真正创建会话。

重命名

在会话侧栏打开某条会话的 ... 菜单，选择重命名。

删除

打开会话的 ... 菜单，选择删除并确认。删除会移除会话及其消息，且不可恢复。

搜索

两处会话搜索都以关键词匹配会话标题或会话 ID（title / id 的模糊匹配），不搜索消息正文：

日志页

Agent 的日志页（Agent 侧边栏的日志）按时间和搜索词列出会话，选中会话后展示变量、模型、Token 用量、响应耗时、思考过程与知识来源。

最佳实践

编写有效的提示词

✅ 推荐：

好的：「在管理面板中重置密码的步骤是什么？」
好的：「总结 Q3 报告中关于营收增长的关键点」
好的：「以表格形式比较方案 A 和方案 B 的功能」

❌ 避免：

差的：「密码？」
差的：「告诉我一切」
差的：「帮忙」

技巧：

• 明确表达需求
• 需要时指定格式（表格、列表、总结）
• 提供相关上下文
• 复杂话题一次问一个

管理上下文

开始新会话：

• 切换到无关话题
• Agent 似乎对上下文感到困惑
• 想要重新开始

继续会话：

• 提出后续问题
• 基于之前的回答继续
• 需要保持上下文

有效使用知识库

✅ 推荐：

• 针对文档提出具体问题
• 请求来源：「根据手册...」
• 已知文档名时提及
• 跟进澄清

❌ 避免：

• 询问知识库中不存在的信息
• 期望 Agent 知道实时信息
• 假设所有文档都已索引

详细上下文管理请参阅记忆与上下文。

故障排查

Agent 无响应

问题：发送消息后没有回复

解决方案：

1. 检查网络连接
2. 刷新页面
3. 检查 Agent 是否已发布
4. 尝试其他 Agent
5. 联系管理员

响应缓慢

问题：Agent 回复耗时过长

解决方案：

1. 检查网速
2. 简化问题
3. 避开高峰时段
4. 联系管理员了解服务负载

回复不相关

问题：Agent 给出无关回答

解决方案：

1. 更清晰地重述问题
2. 提供更多上下文
3. 开始新会话（清除上下文）
4. 检查 Agent 是否关联相关知识库
5. 尝试其他更专业的 Agent

来源不显示

问题：RAG 模式下没有来源引用

解决方案：

1. 确认 Agent 已关联知识库
2. 检查 Agent 的 RAG 模式不是「关闭」
3. 提出更具体的问题
4. 确认文档已索引（状态：completed）

文件上传失败

问题：无法上传文件

解决方案：

1. 检查文件大小（须小于 10 MB）
2. 确认文件格式受支持
3. 检查 Agent 是否允许文件上传
4. 尝试其他文件
5. 联系管理员

相关内容：流式事件、会话 API、附件与媒体、记忆与上下文。