ai
ai/llm-engineering/index.md
medium
ai-llm-engineering-index
LLM 调用工程规范七件事 — prompt 版本化 / 流式 SSE / TPM+RPM 限流 / 重试熔断 / 结构化输出 / 缓存 / 可观测性。Use when 设计 LLM 网关 / 上线大模型调用链 / 评审调用韧性与成本时。
子项索引
| 子项 | 一句话 |
|---|---|
| prompt-management skill | prompt 工程化 — 模板外置不硬编码、每版打版本号且 trace 关联版本、模板内显式写格式/范围/语气/长度约束 |
| streaming-sse skill | LLM 流式响应默认用 SSE(单向、标准 HTTP、EventSource 自动重连),token 边到边逐块 flush,仅双向交互才上 WebSocket |
| rate-limit-token skill | LLM 网关层做 TPM+RPM 双限流(TPM 是成本主控维度),并按 input/output/cached token 单价实时核算每次调用成本 |
| retry-degradation skill | LLM 调用失败用指数退避+full jitter 重试,先区分瞬时错误(可重试)与结构性错误(不盲目重试),并按错误率+成本速率+延迟三类触发器熔断降级 |
| structured-output skill | 需要可解析结果时强制用 JSON schema / function calling 约束模型输出,并对每次响应做 schema 校验(校验失败率是模型回归的先行指标) |
| caching skill | LLM 三层缓存 — 精确匹配普通缓存(FAQ 可省 80%+ 调用)、按语义命中跳过模型的语义缓存、供应商 prompt caching 降长前缀成本 |
| observability skill | LLM 调用每条 trace 记录 prompt(含版本)/response/token 用量/延迟,并按调用维度归集成本;prompt 版本化是可观测性的前提 |
LLM Engineering · 子项索引
LLM 调用工程拆成七个独立决策点,按你正在做的事下钻:
| 你在做什么 | 进哪个 |
|---|---|
| 管理 prompt(版本化、模板外置、写约束) | prompt-management |
| 把模型输出流式推给前端 | streaming-sse |
| 在网关层做限流并算成本 | rate-limit-token |
| 处理调用失败的重试、降级与熔断 | retry-degradation |
| 要求模型返回可解析的结构化结果 | structured-output |
| 用缓存省 token / 降延迟 | caching |
| 给整条调用链做埋点、追踪与成本归集 | observability |
韧性栈顺序:请求队列(TPM/RPM 双限) → 熔断(错误率+成本+延迟) → 网关(指数退避+full jitter 重试) → LLM。 文中省钱比例为第三方观察的量级参考,需用自有调用数据复测后定参。