角色
角色让你保存可复用的助手配置文件，其中包含独立模型、系统提示词、生成设置、 头像和背景，以及可选的记忆行为。
角色存储的内容
- 名称和说明
- 模型 ID
- 头像和背景
- 系统提示词
- 温度、top-p、top-k、上下文窗口、最大令牌数和惩罚项
- 可选嵌入模型
- 可选记忆设置
- 可选变异或适应设置
角色数据按用户隔离。
创建角色
- 从侧边栏打开角色。
- 创建新角色。
- 选择模型。
- 编写系统提示词。
- 调整生成参数。
- 保存并使用该角色开始聊天。
推荐用途
| 角色 | 实用设置 |
|---|---|
| 代码审查员 | 低温度、简洁提示词、编程模型 |
| 编辑 | 中等温度、写作风格指令 |
| 研究助手 | 启用文档聊天、安装嵌入模型 |
| 创意伙伴 | 较高温度、更大的最大令牌预算 |
| 支持代理 | 在系统提示词中严格规定语气和回复格式 |
参数限制
Libre WebUI 会在保存前验证角色设置：
| 参数 | 范围 |
|---|---|
| 温度 | 0 到 2 |
| Top P | 0 到 1 |
| Top K | 1 到 100 |
| 上下文窗口 | 128 到 131072 |
| 最大令牌数 | 1 到 8192 |
记忆
角色记忆会把选定交互保存为可搜索记忆，其中包括内容、上下文、时间戳、重要性评分、 记忆类型、访问次数、衰减数据以及可选嵌入。
记忆功能包括：
- 记忆状态和统计信息
- 核心记忆检索
- 清空记忆
- 合并相似记忆
- 全局衰减
语义记忆搜索使用配置的嵌入模型。nomic-embed-text 是不错的本地起点。
变异状态
启用变异设置后，Libre WebUI 会保存角色的运行时状态。变异引擎可以根据对话信号 跟踪情绪、习得偏好、交互模式和变异日志。
这是有状态的助手行为，并不保证自主推理。生产工作流应明确编写提示词和设置。
导入与导出
角色可导出为 JSON 并导入另一个 Libre WebUI 实例。导出包含角色配置及现有高级设置。
另有类似 DNA 的导出路由，在相关记录存在时包含角色、记忆和变异日志。