AI 生成的文字听起来就像 AI。它预设使用特定的节奏、词汇和正式程度,与你的公司毫无关系。没有明确指引,每个输出读起来都一样 — 无论是行销电子邮件、法律备忘录还是客户支援回复。
JieGou 的 Brand Voice 和治理控制在平台层级解决了这个问题。定义一次你的声音,每个 recipe 执行都会自动套用它。
Brand Voice 设定档
Brand Voice 设定档有五个可配置维度加上参考资料:
| 维度 | 选项 |
|---|---|
| 语气 | formal、casual、technical、friendly、authoritative、conversational |
| 句子长度 | short、medium、long |
| 术语政策 | avoid、moderate、embrace |
| 受众程度 | general、professional、expert |
| 自订指示 | 自由文字,最多 2,000 字元 |
你也可以附加最多 5 个参考写作范例(每个 1,000 字元),展示你偏好的风格。模型在生成输出时会将这些作为 few-shot 范例使用。
部门层级覆写让这对真实组织来说更实用。行销可以是轻松对话式的,而法务保持正式和权威。每个部门可以覆写帐户层级预设的任何维度。解析阶层很直接:部门覆写优先于帐户层级预设,帐户层级预设优先于无。
注入机制的运作方式
Brand Voice 不是建议。它会自动注入到每个 recipe 执行中作为系统提示部分,包裹在 <brand_voice> XML 标签中,包含所有配置的维度。
注入发生在 recipe 执行器内部。Workflow 自动继承它 — workflow 中的每个 recipe 步骤都会得到相同的 Brand Voice 处理。不需要逐个 recipe 配置。
执行时的解析顺序:
- 检查是否有与执行使用者部门匹配的部门层级覆写
- 回退到帐户层级预设
- 如果两者都不存在,则不使用 Brand Voice 执行
失败安全行为:如果执行器尝试载入 Brand Voice 设定档时 Firestore 无法连接,执行会继续进行而不使用它。缺少 Brand Voice 总比 recipe 失败好。
Glossary
Glossary 强制执行一致的术语。每个条目有五个栏位:
| 栏位 | 用途 |
|---|---|
| 术语 | 要匹配的词或短语 |
| 定义 | 它在你的组织中的意义 |
| 偏好用法 | 它应该如何出现在输出中 |
| 上下文 | 何时使用(何时不使用) |
| 部门 | 全帐户或部门特定 |
当使用者提交任务时,字词边界匹配会扫描输入中的 glossary 术语。只有匹配的术语会被注入到提示中 — 这保持了上下文视窗精简,而不是将每个术语都倒入每次执行。
匹配的术语被格式化为 <glossary> XML 区块,具有 500 token 预算。如果匹配的术语超过预算,它们会按与输入的相关性排序优先。执行使用者部门的部门范围术语会与全帐户术语一起包含。
Prompt Fragment
Prompt Fragment 是可重复使用的提示元件,你可以在 recipe 模板中使用 {{fragment:name}} 语法引用。将它们视为共享的建构模组 — 合规免责声明、格式检查清单、标准介绍段落 — 多个 recipe 可以引用而不需重复文字。
每个 fragment 具有:
- 名称 — 在
{{fragment:name}}中使用的参考键 - 类别 — intro、checklist、format、disclaimer、instructions、rules、context 或 other
- 内容 — 最多 10,000 字元
- 部门范围 — 全帐户或部门特定,可选过滤
- 使用次数 — 每次在执行期间解析 fragment 时自动递增
UI 包含复制到剪贴簿按钮,让你可以直接将 {{fragment:name}} 语法贴到 recipe 模板中。
在执行时,fragment 引用会透过将每个 {{fragment:name}} token 替换为 fragment 的内容来解析。这发生在 Brand Voice 注入之后,但在变数替换和上下文组装之前。
上下文组装顺序
了解模型看到什么对除错很重要。这是执行时的完整组装顺序:
- 产业系统提示 — 你帐户产业的基础提示
- Brand Voice 系统提示 — 语气、风格和参考范例
- Fragment 解析 —
{{fragment:name}}token 被内容替换 - 变数替换 — 使用者定义的变数被填入
- 上下文区段 — glossary 术语、few-shot 范例、RAG 文件
- 使用者任务提示 — 来自使用者的实际输入
每一层都建立在前一层之上。如果输出中有什么感觉不对,你可以独立检查每一层以找出问题所在。
治理功能
稽核日志
JieGou 追踪跨平台的 120 多种不同动作类型 — 包括 Brand Voice 设定档变更、glossary 编辑、fragment 修改、recipe 执行和 workflow 修改。
每个稽核事件储存:
- 谁 — 执行动作的使用者
- 什么 — 动作类型和受影响的资源
- 前后快照 — 变更前后资源状态的完整 JSON
- 时间戳记 — 动作发生的时间
三种日志模式处理不同的可靠性需求:
| 模式 | 行为 | 使用情境 |
|---|---|---|
| Fire-and-forget | 非同步写入,无执行延迟 | 大多数动作的预设值 |
| Synchronous | 阻塞直到稽核记录持久化 | 合规敏感操作 |
| Compliance-aware | 根据合规级别自动调度到适当模式 | 设定后即忘记的配置 |
保留政策可按帐户配置,从 30 到 365 天。稽核资料可以汇出为 CSV 或 JSON,可根据动作类型、使用者、日期范围和资源进行过滤。
合规级别
三种预设匹配常见的组织需求:
| 级别 | 保留 | 日志记录 | 其他 |
|---|---|---|---|
| Standard | 30 天 | 非同步 | 所有帐户的预设值 |
| Enhanced | 90 天 | 非同步 | 每次执行强制推理追踪 |
| Strict | 365 天 | 同步 | 不可变执行历史、必需的批准闸道 |
Strict 模式意味着每次稽核写入都会阻塞执行直到持久化,执行历史无法删除,且具有批准步骤的 workflow 在继续之前需要签核。这是为需要可稽核性作为法律要求的受监管产业设计的。
Brand Voice 的 RBAC
对 Brand Voice 控制的存取遵循 JieGou 的角色型存取模型:
| 动作 | 所需角色 |
|---|---|
| 编辑 Brand Voice 设定档 | Owner 或 Admin |
| 编辑 glossary 术语 | Editor 或以上 |
| 编辑 Prompt Fragment | Editor 或以上 |
| 读取 Brand Voice、glossary、fragment | 任何成员 |
这意味着你的内容团队可以管理 glossary 术语和 Prompt Fragment 而不需要管理员权限,而 Brand Voice 设定档变更 — 会影响整个帐户的每次执行 — 需要提升的权限。
可用性
Brand Voice 设定档和 glossary 在 Pro 方案及以上可用。治理功能 — 稽核日志、合规级别和保留政策 — 在 Team 和 Enterprise 方案可用。Prompt Fragment 在所有付费方案中可用。