Skip to content

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 中模型混乱
示例没有分类冲突
缺乏版本控制行为变更难以追溯
不测试示例库质量不可控

本节小结

关键要点

  1. 示例库是工程级 Prompt 的核心资产
  2. 多层结构:基础/任务/场景
  3. 模块化+可复用+可组合
  4. 必须可扩展、可溯源、可版本化

第 11 章(Few-shot 与示例工程)已全部完成。接下来我们将进入第 12 章 · Prompt Pipeline