打开 Demo
会话配置决定所有用户的全局聊天行为：默认模型与任务模型、系统提示词与生成提示词、上下文压缩、内置 Prompts / Skills / 组件、参数透传和对话导出。

使用入口#

打开 管理端 → 会话配置。页面包含五个区域：

  • 会话配置
  • 上下文管理
  • 提示词库
  • 参数透传
  • 数据导出

每个区域都有独立的保存按钮，仅在该区域有改动时可用。这些是平台级设置，不是单个用户的聊天设置。修改只影响之后的会话，已生成的标题、标签和消息不会重写。

DEEIX Chat 管理端会话配置

选择默认模型与任务模型#

打开会话配置。

字段行为
新会话默认模型用户选择系统推荐或未设置个人默认模型时优先使用。选项为系统推荐和所有可路由的聊天模型。保持系统推荐时回退到第一个可用模型。
任务执行模型生成会话标题和标签时使用的聊天模型。选项为跟随当前模型和所有可路由的聊天模型。

如果用户常用高成本模型，建议指定一个稳定、低成本的任务模型，而不要选择跟随当前模型。这样标题和标签生成的开销更低，风格也更一致。

编写全局默认系统提示词#

打开会话配置 → 全局默认系统提示词。

该文本会作为所有聊天模型的平台级行为指令注入。留空表示不注入。模型级提示词会在其后追加。适合写准确性、清晰度、组织安全等通用要求。不要把某个项目、某个用户或某次任务的临时要求写在这里，这类内容应放入项目提示词、模型级提示词或内置 Skill。

自定义标题与标签提示词#

打开会话配置 → 生成标题提示词和生成标签提示词。两者都支持 {{MESSAGES}} 占位符，并要求返回 JSON：

  • 标题提示词：{ "title": "你归纳的标题" }
  • 标签提示词：{ "labels": ["标签1", "标签2"] }

留空使用内置默认提示词。编辑时保持 JSON 结构不变，否则标题或标签可能无法解析。

配置上下文压缩#

打开上下文管理。开关与阈值需要配合使用。

字段默认值说明
Token 预算保护—根据模型上下文窗口自动裁剪超出预算的历史消息。
默认上下文窗口128000无法识别模型上下文窗口时使用的默认值。
上下文压缩—将较早的对话整理为滚动摘要。开启后用户仍可在聊天设置中选择是否使用。
压缩触发轮次—对话超过该轮次数时触发压缩；设为 0 表示关闭按轮次触发。开启上下文压缩后显示。
压缩触发比例80累计上下文达到当前模型有效输入预算的该比例时触发压缩；设为 0 表示关闭按 Token 触发。开启上下文压缩后显示。
原文保留轮次—压缩时保留的最近原始轮次数量，其余较早内容写入摘要。开启上下文压缩后显示。
每角色摘要条数—模板压缩时，用户和助手各自最多保留的摘要条数。开启上下文压缩后显示。
片段字符上限—模板压缩时单条消息片段允许保留的最大字符数。开启上下文压缩后显示。
证据保留天数90上下文证据的保留时长，包含 RAG 结果、历史证据和工具结果；0 表示不自动过期。开启上下文压缩后显示。
后台执行压缩—在当前回复完成后执行模板或 LLM 压缩；结果写入消息处理记录，并记录后端开始、完成或失败日志。开启上下文压缩后显示。
LLM 压缩—调用模型生成语义摘要；关闭后仅使用模板摘要。开启上下文压缩后显示。
压缩模型跟随当前模型生成压缩摘要时使用的模型。跟随当前模型在活动模型不支持聊天时回退到默认聊天模型。开启 LLM 压缩后显示。
熔断阈值—LLM 压缩的连续失败阈值，达到后自动降级为模板摘要。开启 LLM 压缩后显示。
全量摘要提示词—自定义全量压缩时发送给 LLM 的指令；留空使用内置默认值。开启 LLM 压缩后显示。
轻量摘要提示词—自定义轻量压缩时发送给 LLM 的指令；留空使用内置默认值。开启 LLM 压缩后显示。

关闭上下文压缩会降低后台成本，但长会话更容易丢失早期上下文或触达模型上下文上限。

管理内置 Prompts、Skills 和组件#

打开提示词库，使用 Skills、Prompts 和交互式组件页签。每个页签都有独立的搜索框、新建按钮、表格和分页。

页签管理员维护用户侧效果
Skills名称、说明、SKILL.md、启用状态用户在 / 选择后作为本轮上下文装载，不会运行命令。
Prompts名称、说明、内容、启用状态用户在 / 选择后把内容插入输入框。
交互式组件名称、说明、入参摘要、入参 Schema、渲染代码、启用状态模型可在回复中内联渲染。选择入口位于输入区的输出面板。

删除内置项后它不再对用户展示，不影响用户自己创建的 Prompts、Skills 或组件。

Skills 调用提示词#

在 Skills 页签中，Skills 调用提示词控制模型如何理解和使用已装载的 Skills。留空使用内置默认提示词。该字段有自己的保存按钮。

新建内置 Prompt 或 Skill#

  1. 打开 Prompts 或 Skills 页签。
  2. 点击新建（或新建 Skill）。
  3. 填写名称。名称同时作为 / 触发词，开头的 / 会被去掉。
  4. 填写说明。
  5. Prompt 填写内容，Skill 填写 SKILL.md 正文。
  6. 设置启用。
  7. 点击保存。

限制：名称 64 个字符，说明 256 个字符，内容或 SKILL.md 10000 个字符。超出时提示名称最多 64 个字符，说明最多 256 个字符，内容最多 10000 个字符。（Skill 对应 SKILL.md 的提示）。

新建组件#

交互式组件页签用于维护组件目录。一个组件由名称、说明、入参摘要、可选的入参 Schema 和沙箱 HTML 渲染代码组成。

  1. 点击新建组件。
  2. 填写组件名。只能使用小写字母、数字与连字符，例如 stock-glance。
  3. 填写说明：一句话告诉模型该组件适合展示什么内容。
  4. 填写入参摘要：给模型看的紧凑入参说明，例如 {symbol, name?}。
  5. 编辑渲染代码。HTML 与脚本在沙箱 iframe 中运行，无网络访问；通过 deeix.onProps 接收数据，通过 deeix.onTheme 接收主题变量。
  6. 可选填写入参 Schema，前端据此校验模型输出；留空则不校验。
  7. 在预览面板中用示例数据测试渲染，点击应用当前代码刷新预览。
  8. 设置启用并点击保存。

限制：组件名 64，说明 256，入参摘要 1024，入参 Schema 16 KB，渲染代码 256 KB。Schema 非法时提示入参 Schema 必须是合法的 JSON 对象；必填项缺失时提示请填写组件名、说明、入参摘要与渲染代码。

内置组件由代码定义，只能启用或停用，不能编辑或删除：

  • 卡片网格 — 新闻、搜索结果、候选方案等同构条目；可按 tag 筛选。
  • 数据图表 — 折线、柱状、面积、散点、饼图、雷达、漏斗等；图例切换序列显隐。
  • 函数图像 — 编辑、增删表达式实时重绘；缩放、拖动、显隐曲线。
  • 指标卡片 — 并列的 KPI、涨跌幅；迷你走势线可悬停读数。
  • 甘特图 — 排期、里程碑、依赖；刻度切换、依赖链高亮、分组折叠。
  • 数据表格 — 排序、搜索、分页、导出 CSV。
  • 交互式计算器 — 拖动输入滑块，输出按公式实时重算。
  • 决策树 — 逐步点选进入下一节点，可返回或重置。
  • 文本对比 — 合并 / 并排视图，逐处跳转，词级高亮，复制结果。
  • 测验 / 问答 — 即时判对错与解析，计分；支持按选择跳题。

交互式组件开关#

打开会话配置 → 交互式组件。开启后模型可在回复中输出交互式组件，组件目录会注入提示词。关闭后不注入目录、隐藏选择入口，已有消息中的组件块以原始内容显示；无论开关状态如何，组件库都可编辑。

配置参数透传#

打开参数透传。它控制用户在聊天设置中写入的模型参数是否可以进入上游请求。

策略行为
白名单只放行列出的路径，其他字段丢弃。这是默认值。
黑名单默认透传，命中黑名单或系统拦截的路径会被移除。
禁止透传用户自定义参数不进入上游。

路径写法#

顶层写字段名，嵌套用点号，支持多层：

text

白名单和黑名单都是 JSON 对象。default 键对所有协议生效；其他键只对对应协议追加放行。黑名单模式下，default 键列出需要拦截的路径。

json

协议主键#

最新前端识别以下协议主键：

default、openai_chat_completions、openai_responses、openai_image_generations、openai_image_edits、anthropic_messages、gemini_generate_content、google_image_generation、gemini_interactions、xai_responses、xai_image、xai_image_edits、xai_video、xai_video_extensions、openrouter_chat_completions、openrouter_responses、openrouter_images

OpenAI 的 service_tier 仅接受 default、flex、priority；未配置时不传。

系统拦截#

以下路径始终拦截，不能通过白名单放行：

model、messages、input、instructions、prompt、system、systemInstruction、headers、api_key、apiKey、base_url、baseURL、stream、previous_response_id、prompt_cache_key、prompt_cache_options、prompt_cache_breakpoint、prompt_cache_retention

实时预览与教程#

当前生效的策略字段下方会显示实时预览，分为不过滤和过滤两列。每行展示路径、协议范围和原因（系统拦截、命中黑名单、命中白名单、未列入黑名单）。JSON 非法时会在保存前就地报错。

点击教程可打开说明路径写法、两种策略、协议主键和系统拦截字段的弹窗。

导出对话#

打开数据导出。点击导出会把全部对话、消息和元数据下载为 JSONL 文件。成功时提示导出数量；部分失败时会提示成功和失败的数量。

配置项对照#

除特别说明外，以下键均属于 chat 命名空间。

分组配置键
会话配置chat.conversation_default_model、chat.conversation_task_model、chat.default_system_prompt、chat.conversation_title_prompt、chat.conversation_labels_prompt、chat.ui_components_enabled
上下文管理chat.context_token_budget_enabled、chat.context_window_fallback_tokens、chat.context_compact_enabled、chat.context_max_turns、chat.context_compact_trigger_percent、chat.context_compact_preserve_recent_turns、chat.context_compact_highlights_per_role、chat.context_compact_snippet_chars、chat.context_artifact_retention_days、chat.compact_async_enabled、chat.compact_llm_enabled、chat.compact_task_model、chat.compact_max_failures、chat.compact_system_prompt、chat.compact_light_prompt
提示词库chat.skills_prompt
参数透传chat.model_option_policy_mode、chat.model_option_allowed_paths、chat.model_option_denied_paths

常见问题#

  • 标题或标签缺失。 标题或标签提示词不再返回预期的 JSON 对象。恢复文档中的结构，或清空字段改用内置默认提示词。
  • 用户参数始终进不了上游。 该路径不在白名单，或被系统拦截。查看实时预览确认。
  • 压缩没有执行。 上下文压缩未开启，或对话尚未达到轮次 / Token 触发条件。
  • 压缩摘要过于笼统。 开启 LLM 压缩并选择能力合适的压缩模型；如果 LLM 调用持续失败，可提高熔断阈值。
  • 交互式组件不再渲染。 交互式组件开关被关闭，已有组件块以原始内容显示。重新开启即可。

相关页面#