开关配置示例
开关配置示例
flags:
prompt.summarize.version: 1.3.0
experiment.summarize.json_output:
enabled: true
rollout: 10 # 百分比
default: false
cleanup_by: 2026-11-01| 分级 | 发布开关、实验开关、运维开关分开管理 |
|---|---|
| 默认值 | 生产默认关闭，开启需显式操作 |
| 清理 | 实验结束设清理期限，定期盘点开关清单 |
本包目录（290 条）
提示词基础40 条模式与框架50 条任务型写法50 条评估与迭代50 条提示注入与防护50 条
工程化实践50 条
- 提示模板的占位符设计
- 上下文窗口的使用规划
- 提示即代码：纳入仓库管理
- 模型与 SDK 版本固定
- token 预算与分配
- OpenTelemetry GenAI 语义约定
- 生成延迟的分解度量
- 线上质量抽检
- 模板变量注入与默认值
- 提示灰度发布与回滚
- 配置外置与环境差异
- 提示与密钥分离管理
- 多轮对话的滚动摘要
- 上下文排序与位置效应
- 提示缓存的概念与收益
- 重试与指数退避
- 模型不可用时的降级
- 流式输出处理
- 请求追踪与回放调试
- 成本归因与预算告警
- 日志与数据脱敏
- 模板渲染的转义与安全
- 提示变更评审清单
- 提示版本号与兼容策略
- 功能开关与实验分流
- 开发与生产环境隔离
- 分词器与 token 估算
- 会话记忆与实体表
- 会话隔离与并发
- 超时与取消设计
- 限流与配额处理
- 批量任务的部分失败处理
- 响应缓存与语义缓存
- 长任务的异步化
- 审计日志字段设计
- 用户反馈收集与回流
- LLM 功能的值班手册
- 模板注册表与命名规范
- 提示变更记录的写法
- 提示资产目录与元数据
- 历史截断策略对比
- 调用幂等性设计
- 回退链设计
- 并发控制与排队
- 数据保留与清理策略
- 依赖固定与升级窗口
- 模板片段复用与组合
- 提示静态检查规则
- 配置优先级与覆盖规则
- 会话恢复与持久化
功能开关与实验分流
用开关控制提示版本、模型路由与新功能可见性：开关分级管理，默认值明确，实验结束设清理期限，防止开关堆积成隐性技术债。
易错点
- 实验开关长期不清，组合状态无人敢动
- 开关默认值设为开启，事故时来不及补救
数据来源与参考
- Pete Hodgson《Feature Toggles (aka Feature Flags)》（martinfowler.com）；持续交付中的发布解耦概念