环境配置分层
环境配置分层
config/base.yaml # 通用默认值
config/staging.yaml # 测试环境覆盖
config/prod.yaml # 生产环境覆盖
渲染优先级: prod > staging > base
提示模板本身不包含环境差异| 原则 | 一份模板多环境复用，差异外置表达 |
|---|---|
| 敏感值 | 走密钥管理，不进仓库与镜像 |
| 加载 | 启动时校验必填配置，缺失即失败 |
本包目录（290 条）
提示词基础40 条模式与框架50 条任务型写法50 条评估与迭代50 条提示注入与防护50 条
工程化实践50 条
- 提示模板的占位符设计
- 上下文窗口的使用规划
- 提示即代码：纳入仓库管理
- 模型与 SDK 版本固定
- token 预算与分配
- OpenTelemetry GenAI 语义约定
- 生成延迟的分解度量
- 线上质量抽检
- 模板变量注入与默认值
- 提示灰度发布与回滚
- 配置外置与环境差异
- 提示与密钥分离管理
- 多轮对话的滚动摘要
- 上下文排序与位置效应
- 提示缓存的概念与收益
- 重试与指数退避
- 模型不可用时的降级
- 流式输出处理
- 请求追踪与回放调试
- 成本归因与预算告警
- 日志与数据脱敏
- 模板渲染的转义与安全
- 提示变更评审清单
- 提示版本号与兼容策略
- 功能开关与实验分流
- 开发与生产环境隔离
- 分词器与 token 估算
- 会话记忆与实体表
- 会话隔离与并发
- 超时与取消设计
- 限流与配额处理
- 批量任务的部分失败处理
- 响应缓存与语义缓存
- 长任务的异步化
- 审计日志字段设计
- 用户反馈收集与回流
- LLM 功能的值班手册
- 模板注册表与命名规范
- 提示变更记录的写法
- 提示资产目录与元数据
- 历史截断策略对比
- 调用幂等性设计
- 回退链设计
- 并发控制与排队
- 数据保留与清理策略
- 依赖固定与升级窗口
- 模板片段复用与组合
- 提示静态检查规则
- 配置优先级与覆盖规则
- 会话恢复与持久化
配置外置与环境差异
提示与配置和代码分离，按环境注入：接口地址、模型标识、阈值放环境配置；同一份模板在多个环境复用，差异由配置表达。
易错点
- 把生产密钥写进仓库配置文件
- 环境差异写进模板正文，模板随环境分叉难维护
数据来源与参考
- 12-Factor App 原则三：Config（配置外置）