Appearance
11.6 示例库的工程化设计
引言:为什么要构建"示例库"
当你构建可持续的 AI 应用体系时,会遇到单示例无法覆盖所有任务、示例版本冲突、风格无法统一等问题。因此,大厂级工程实践中会构建一个可维护、可复用、可扩展的提示词示例库(Example Library)。
11.6.1 什么是"示例库"
示例库指:为不同任务、不同流程、不同场景设计的可复用、模块化示例集合。
示例库 = Prompt 版的组件库(Component Library)11.6.2 示例库的三层结构
| 层级 | 说明 | 示例 |
|---|---|---|
| 基础示例层 | 通用风格、结构、推理、格式化示例,跨任务共享 | 结构化摘要示例 |
| 任务示例层 | 具体任务使用的示例 | 翻译、摘要、分类、风格转换 |
| 场景示例层 | 产品级别的功能场景 | 客服投诉回复、周报生成 |
11.6.3 为什么需要多层示例结构
| 问题 | 多层结构的解决方式 |
|---|---|
| 示例难以复用 | 通过"基础层"复用 |
| 示例风格不一致 | 通过"基础示例风格锚点"统一 |
| 示例跨任务混乱 | 通过"任务层"进行分类管理 |
| 业务场景不断增加 | 通过"场景层"扩展 |
11.6.4 示例库管理的五大原则
| 原则 | 说明 |
|---|---|
| 可复用 | 将通用模式抽象为基础示例 |
| 可组合 | 基础层+任务层+场景层组合使用 |
| 可扩展 | 新增任务只需扩展对应层 |
| 可溯源 | 每条示例标注ID、所属层、版本 |
| 可版本化 | 保持版本历史,持续演进 |
11.6.5 示例库的目录结构
examples/
base/
style/
structure/
reasoning/
tasks/
summarization/
translation/
classification/
scenarios/
customer_support/
sales_email/
code_assistant/11.6.6 在 System Prompt 中引用示例库
你必须遵循以下写作结构:
<<base.structure.summary>>
以下是本任务的示例(任务层):
<<tasks.summarization.ex1>>
以下是当前场景示例(场景层):
<<scenarios.business_report.ex1>>11.6.7 常见错误
| 错误 | 后果 |
|---|---|
| 示例全挤在 System Prompt 中 | 模型混乱 |
| 示例没有分类 | 冲突 |
| 缺乏版本控制 | 行为变更难以追溯 |
| 不测试示例库 | 质量不可控 |
本节小结
关键要点
- 示例库是工程级 Prompt 的核心资产
- 多层结构:基础/任务/场景
- 模块化+可复用+可组合
- 必须可扩展、可溯源、可版本化
第 11 章(Few-shot 与示例工程)已全部完成。接下来我们将进入第 12 章 · Prompt Pipeline。


