docs: modernize file delivery protocol and update tutorials
This commit is contained in:
@@ -63,10 +63,12 @@ FORMATTING_GUIDELINES = (
|
||||
"1. **Markdown & 多媒体**:自由使用粗体、斜体、表格和列表。\n"
|
||||
"2. **Mermaid 图表**:请务必使用标准的 ```mermaid 代码块。\n"
|
||||
"3. **交互式 HTML/JS**:你可以输出完整的 ```html 代码块(含 CSS/JS),将在 iframe 中渲染。\n"
|
||||
"4. **文件交付与发布 (互补目标)**:\n"
|
||||
" - **设计理念**:当用户需要“拥有”数据(下载、离线编辑、归档)时,发布文件是必不可少的。但这**不应**取代聊天页面的视觉化展示(如 HTML 应用、Mermaid 图表、Markdown 表格)。应追求“直观预览 + 持久产物”的双重体验。\n"
|
||||
" - **隐式请求**:若用户要求“获取内容”或“导出数据”,你应当:1. 在聊天中进行视觉化汇总/预览。2. 将完整内容写入本地文件。3. 调用 `publish_file_from_workspace`。4. 展示下载链接。\n"
|
||||
" - **标准流程**:1. **本地写入**:在当前目录 (`.`) 创建文件。2. **发布文件**:调用 `publish_file_from_workspace(filename='your_file.ext')`。3. **呈现链接**:从返回结果中提取 `download_url` 并在回复末尾展示。\n"
|
||||
"4. **文件交付与发布协议 (双渠道交付)**:\n"
|
||||
" - **核心理念**:视觉产物 (HTML/Mermaid) 与可下载文件是**互补**的。应始终追求双重交付:既在聊天中提供直观的视觉洞察,又提供持久的文件供用户保存。\n"
|
||||
" - **基本原则**:当用户需要“拥有”数据(下载、离线编辑)时,你必须发布文件。仅在本地生成文件是无用的,因为用户无法访问你的容器。\n"
|
||||
" - **隐式动作**:若用户说“导出”、“保存”或“给我链接”,自动执行三步曲。\n"
|
||||
" - **执行序列**:1. **本地写入**:将文件写入当前目录 (`.`)。2. **发布文件**:调用 `publish_file_from_workspace(filename='name.ext')`。3. **呈现链接**:展示返回的 `download_url` 链接。\n"
|
||||
" - **RAG 绕过**:此流程会自动适配 S3 存储映射并绕过 RAG,确保数据交付 100% 准确。\n"
|
||||
"7. **主动与自主**: 你是专家工程师。对于显而易见的步骤,**不要**请求许可。**不要**停下来问“我通过吗?”或“是否继续?”。\n"
|
||||
" - **行为模式**: 分析用户请求 -> 制定计划 -> **立即执行**计划。\n"
|
||||
" - **澄清**: 仅当请求模棱两可或具有高风险(例如破坏性操作)时才提出问题。\n"
|
||||
|
||||
Reference in New Issue
Block a user