Skip to content

编排预设 ​

编排模式(spec / agenda / loop / director)在全局与角色卡作用域各维护一份预设库:

  • 全局 —— 预设存放在扩展设置里,对所有聊天可用。
  • 角色卡 —— 预设存放在角色卡本身上,导出角色卡时随卡一起带走。

一份预设记录了该模式编排面板里的所有内容 —— 系统提示词、工具开关、子代理、planner 配置、loop 上限、capsule 注入策略。它不记录提示词预设或 API 预设;这两者在预设里只按名字引用,运行时再去解析。

为什么按模式分库

spec 预设和 director 预设在结构上没有任何共通的字段,所以它们活在彼此独立的库里。切换执行模式时露出的是当前模式的库,其它模式的库保持原样。

预设栏 ​

预设栏位于每种模式编辑面板的顶部:

预设栏 —— director 模式

它提供了一组标准操作:

  • 下拉菜单 —— 当前 (模式, 作用域) 库下所有预设的列表。选中一项后,编辑器会重新加载为该预设的内容。
  • 新建 —— 用当前模式的出厂默认数据起一份全新预设。
  • 复制 —— 把当前激活预设克隆一份,起个新名字;克隆品成为新的激活预设。
  • 重命名 —— 改名字。底层 id 保持不变,所以任何按 id 引用这份预设的地方均不会失效。
  • 删除 —— 删除该预设。如果删的是当前激活预设,列表里的下一份会自动成为激活预设。如果整个库被删空,下一次读取时 Default 会自动从出厂数据重新填回。
  • 导入 / 导出 —— 使用标准的可移植 JSON 格式。导入时会让你起个名字,加进当前库;导出会把当前激活预设写到磁盘。

在面板里做的编辑会写回到当前激活预设。没有显式保存这一步 —— 关闭面板或切换预设时,当前状态已经持久化。

全局作用域 vs 角色卡作用域 ​

没有加载角色卡时,预设栏展示该模式的全局库。在这里改动会影响所有不跑卡上预设的聊天。

加载了角色卡后,下拉分成 角色卡 和 全局 两组,其中一组处于选中状态。这个选中项就是全部决定:

  • 选中角色卡预设 —— 卡上的预设对这个角色生效;这次聊天里全局激活预设被忽略。
  • 选中全局预设 —— 这次聊天以全局激活预设为准。卡自己的库原样保留在卡上,随时可以从同一个下拉切回卡上的任何预设。

切换组会立即写入卡的激活槽位并随卡持久化,所以这个选择会跟着卡一起导出 / 导入。

如果这张卡还没有自己的预设库,角色卡组是空的。在选中卡预设的状态下保存一次编辑,卡的预设库就被透明地创建出来 —— 不存在「先初始化卡库」这一独立步骤。

角色卡导出时带上自己的预设库

导出角色卡时会把卡自己的预设库一并打包,所以在另一台机器导入这张卡时,卡上的预设也跟着过来。别人拿到你的卡,开箱就是一套能跑的完整编排配置,不需要额外导入任何文件。

编排预设和提示词预设、API 预设的关系 ​

编排预设是一次生成里相互独立的层之一,另外两个是 SillyTavern 的提示词预设和连接配置:

概念控制什么存在哪里
编排预设子代理、工具、planner、loop 上限、系统提示词、capsule 注入扩展设置或角色卡上
提示词预设(chat completion preset)token 预算、采样器、提示词顺序、越狱SillyTavern 预设
API 预设(连接配置)端点、模型、API key连接管理器

编排预设按名字引用提示词预设和 API 预设 —— 例如一份 director 预设可以把它的 voice_critic 子代理钉到 Sonnet · 慢节奏评审、其它一切走 Haiku · 快速。切换激活的编排预设不会切底层提示词预设;切提示词预设也不会动到编排。

实际效果是:名为 审讯节奏 和 重叙事密度 的两份预设,可以共用同一份提示词预设和连接配置,只在编排形态上有差别 —— 不同的子代理、不同的 planner 指令、不同的注入深度。你在预设栏里前后切换,不用碰连接管理器,也不用动 SillyTavern 的预设下拉。

Agent 提示词预设解析优先读角色卡 ​

当一份编排预设按名字把某个 agent 钉到某份提示词预设(Sonnet · 慢节奏评审、Haiku · 快速 等)时,这个名字是在生成时才解析的。查找顺序:

  1. 当前角色的卡内嵌预设集合——只要卡上有一份内嵌预设的名字命中,直接用它。
  2. 你本地的聊天补全预设库。
  3. 前两者均未命中时,回退到编排器设置里钉住的全局运行时默认。

卡优先的顺序在角色卡携带自己推荐预设时很关键:编排 profile 和它引用的预设一起走,接收方无需单独导入匹配的预设。若接收方本地有同名预设,卡上的副本仍然在该角色范围内胜出——卡作者调好的提示词形态不会被接收方本地随便起的同名预设遮盖。

编排器抽屉里每个 agent 的预设选择器顶部,当加载了角色卡时会展示一个「本卡内嵌」optgroup,列出卡上的内嵌预设——所以你能在同一个 UI 里同时看到并选择卡上的和本地的预设。

把编排配置提交到角色卡时按需内嵌引用的预设 ​

向当前角色卡提交编排配置时,Luker 会先预检 agent 引用的提示词预设名字,查出哪些还没内嵌到卡上。这里的「提交」既包括编排器抽屉里的「保存到角色卡预设」,也包括「AI 迭代工作台」弹窗里的「应用到角色卡」——这些入口共用同一次预检。

若有未内嵌的引用,会弹出汇总窗口列出它们,提供以下动作:

  • 全部内嵌——把每个引用预设的本地内容复制到卡上,让编排 profile 在导出后端到端可跑。
  • 只存名字——按原样持久化编排 profile,不嵌入预设内容。接收方若没有同名本地预设,那些 agent 会走运行时默认回退。
  • 取消——中止提交。

在面板里编辑 agent 的预设引用本身不会触发弹窗——选择权属于提交这一步,不属于编辑那一步。

角色卡槽位如何管理、编辑、剥离连接字段,详见角色卡绑定预设与人设。

Default 预设 ​

Default 是一个种子条目,不是受保护条目。你可以重命名它、随意编辑它、删除它 —— 名字上没有星号,系统也不会把它当成任何特殊存在。

唯一一条特殊行为:如果你把一个库里的预设全部删光,下一次读取这个库时 Default 会从出厂数据自动重新种出来。这意味着你不可能因为删得太狠就让某种模式陷入没法跑的状态;也意味着只要你想从头来,删光所有预设就能拿回出厂数据。

用法举例 ​

预设栏支撑起的几种常见工作流:

  • 同一张卡用多份预设 —— 给日常场景用一份又快又省的预设,给重头戏场景用一份慢一点但密度更高的预设。均保存在角色卡作用域下,需要时从下拉里翻。
  • 把角色卡预设提升为全局 —— 把卡上的激活预设导出,再把预设栏切到全局作用域,导入这份 JSON。现在全局库里也有了同一份预设,对所有聊天可用。
  • 试一份预设但不承诺 —— 复制一份当前激活预设,在副本上改。如果实验没跑通,从下拉里切回原版就回到了起点。
  • 把调好的编排和角色卡一起交付 —— 在角色卡作用域上把预设迭代到位,确认下拉里选中的就是卡上的预设,然后导出角色卡。拿到卡的人不需要任何额外配置就能得到你调好的整套编排形态。

相关页面 ​

  • Spec 模式 —— 默认 DAG 工作流;每份 spec 预设是一张 DAG。
  • Agenda 模式 —— planner 驱动;每份 agenda 预设是一份 planner + worker 组合。
  • Loop 模式 —— 单 Agent 工具循环;每份 loop 预设是一份 agent 配置。
  • Director 模式 —— 接管模式;每份 director 预设是一份主代理 + 子代理团队。
  • AI 迭代工作台 —— 直接编辑当前激活预设;在预设栏里切预设就是在切 Studio 迭代的对象。
  • 卡内绑定预设与人格 —— 角色卡作用域的设置如何随卡导出。

基于 SillyTavern 构建