posts

LLM / AI 开发专题:从 API 调用到生产级智能应用

大语言模型(LLM)自 2022 年底 ChatGPT 发布以来,彻底改变了人与计算机的交互范式。从简单的 API 调用到复杂的 Agent 工作流,从 Prompt 工程到模型微调,从检索增强生成到多模态推理——LLM 应用开发已从「调用一个接口」进化为「编排一个智能系统」。本专题系统覆盖 LLM API 基础调用与参数调优、Prompt 工程(零/少样本链式思维、角色设定、输出格式控制)、RAG 检索增强生成(向量数据库/文档分块/重排序)、模型微调(LoRA/QLoRA/PEFT 参数高效微调)、Agent 框架(LangChain/LlamaIndex/CrewAI 工作流编排)、推理部署优化(vLLM/TensorRT/量化压缩)与 AI 安全治理(幻觉检测/提示注入/输出审查),基于 Python 全栈实践,为 AI 应用开发者提供从概念到生产的完整技术路径。并补齐结构化输出与受限解码、量化与蒸馏、实时语音 Agent、长上下文优化、RAG 评估体系、端侧推理等进阶议题。

大语言模型重塑了软件开发范式。本专题从 requests.post() 调用第一个 API 开始,到部署支持万级并发的 vLLM 推理集群,覆盖 LLM 应用开发的全生命周期。


📚 配套书稿系列

《AI Agent 开发》三卷本已全部上线(入门 61 篇 / 实战 55 篇 / 高级 34 篇,共 150 篇):从零手写 Agent 引擎 minagent,到工程化的研究助理服务 ResearchCopilot,再到用 PydanticAI / Claude Agent SDK / OpenAI Agents SDK / smolagents 框架重写与生产化加固。

进入书稿书架

书稿与专题的分工:书稿是「递进教学路径 + 可运行的完整示例」,按章节顺序从头读到尾;本专题是「单点深挖」,按主题查阅。两者互补,不重复。


1. LLM 基础与 API 调用

文章深度说明
LLM API 基础调用指南⭐⭐⭐⭐ 深度OpenAI/Anthropic/Google API 对比、流式输出、Token 管理、多模态、FastAPI 服务端封装
LLM 流式输出与实时交互工程⭐⭐⭐⭐ 深度SSE/WebSocket 协议选型、增量解析、TTFT 首 token 延迟、中断与超时重试、流式渲染与可观测性

交叉链接:


2. Prompt 工程与 Function Calling

文章深度说明
Prompt 工程与 Function Calling 实战⭐⭐⭐⭐ 深度Few-shot/CoT/ReAct、OpenAI Function Calling、Pydantic 结构化输出、提示词注入防御、eval 框架
上下文工程实战:从上下文窗口到长上下文管理的工程体系⭐⭐⭐⭐⭐ 深度Lost in the Middle 与黄金位布局、长文档检索/Map-Reduce/滑动窗口三级策略、上下文压缩、Prompt Caching、记忆分层调度、消融评估
推理增强技术工程化:CoT/ToT/ReAct⭐⭐⭐⭐ 深度思维链 CoT、自洽性采样、思维树 ToT、ReAct 的工程化实现、成本延迟权衡与评测
结构化输出与受限解码:JSON Schema 与语法约束⭐⭐⭐⭐ 深度Prompt 约束、Function Calling 与受限解码(Constrained Decoding)对比,JSON Schema 编译为 GBNF/EBNF 语法,Outlines/XGrammar/llama.cpp/vLLM 实战配置与性能开销

3. RAG 检索增强生成

文章深度说明
RAG 架构实战:从零搭建知识问答系统⭐⭐⭐⭐⭐ 深度Embedding 模型选型、文档分块策略、混合检索、LangChain/LlamaIndex RAG 对比、端到端 FastAPI 实现
RAG 高级优化:查询扩展、重排序与混合检索⭐⭐⭐⭐⭐ 深度HyDE/Query2Doc 查询扩展、Cross-encoder/ColBERT 重排序、Dense+Sparse+图混合检索、端到端流水线
Embedding 与 Reranker 深度调优:检索质量的决定性引擎⭐⭐⭐⭐⭐ 深度Bi-Encoder/Cross-Encoder 两段式架构、模型选型矩阵、混合检索与 RRF 融合、Query 改写/HyDE、Reranker 微调与难负样本挖掘、NDCG 评测
GraphRAG 实战:从向量检索到知识图谱增强检索⭐⭐⭐⭐⭐ 深度图谱建模、LLM 实体关系抽取、局部/全局检索(社区摘要)、向量+图谱混合架构、多跳推理评测、Neo4j 实战
混合检索 RAG:BM25 与向量融合⭐⭐⭐⭐ 深度稀疏 BM25 与稠密向量检索原理、RRF 融合算法、重排器、查询改写与混合检索质量评估
RAG 评估体系:召回、忠实度与自动化指标⭐⭐⭐⭐ 深度检索侧 Recall@k/MRR/NDCG、生成侧 Faithfulness/Answer Relevance/Context Precision,Ragas 实战、LLM-as-Judge 偏差校准、评估集构建与在线 A/B

交叉链接:


4. 向量数据库

文章深度说明
向量数据库对比与集成指南⭐⭐⭐⭐ 深度PGVector/Qdrant/Chroma/Milvus/Weaviate 选型矩阵、Python SDK 实战、性能基准

交叉链接:


5. 模型微调

文章深度说明
模型微调与 PEFT:LoRA、QLoRA 实战⭐⭐⭐⭐⭐ 深度LoRA/QLoRA/DoRA 原理、HuggingFace PEFT+TRL、Unsloth 训练加速、数据集准备、GGUF/AWQ 部署转换

交叉链接:


6. AI Agent 与多智能体协作

文章深度说明
AI 智能体(Agent)架构设计:从 ReAct 到自主决策系统⭐⭐⭐⭐⭐ 深度感知-推理-记忆-工具-执行五大组件、ReAct/Reflexion/Plan-and-Solve 推理模式、完整可运行代码与生产护栏
多智能体协作(Multi-Agent):从团队协作到自主组织⭐⭐⭐⭐⭐ 深度CrewAI/AutoGen/LangGraph 框架实战、通信协议、共识机制、并发安全
Agent 工具调用与 Function Calling⭐⭐⭐⭐ 深度OpenAI/Claude/Google 工具标准、Schema 设计最佳实践、跨平台兼容层代码
Agent 工作流编排设计:DAG、状态机、暂停恢复⭐⭐⭐⭐⭐ 深度LangGraph 图编排、Temporal 长任务持久化、事件总线驱动、人类介入 Interrupt 机制
人机协作模式(Human-in-the-Loop):审批、审核与接管⭐⭐⭐⭐ 深度审批流/审核反馈/接管仲裁三类模式、风险评分、审计日志链式哈希验证
Agent 记忆系统实战:从上下文窗口到长期记忆的持久化架构⭐⭐⭐⭐⭐ 深度工作/情景/语义/程序四类记忆、SQLite+向量库混合存储、记忆提取 Pipeline、遗忘策略、Mem0/LangGraph 对比、记忆安全与防污染

历史参考:


7. 模型上下文协议 MCP

文章深度说明
MCP 协议完整指南:四大原语与互操作性革命⭐⭐⭐⭐ 深度Resources/Prompts/Tools/Sampling、协议分层、与 Function Calling 对比、最小 Server 示例
MCP Server 开发实战:SQLite / 文件系统 / GitHub⭐⭐⭐⭐⭐ 深度三类生产级 Server 实现、生命周期管理、安全沙箱、Docker 部署、单元测试
MCP 客户端集成:Claude Desktop / Cline / Continue⭐⭐⭐⭐ 深度四种 Client 配置详解、工具发现、权限管理、故障排查、自建 Agent 集成代码
MCP 工具生态与最佳实践⭐⭐⭐⭐ 深度30+ Server 速查表、场景化选型、四维评估框架、自建 Server 脚手架

8. 多模态 AI 开发

文章深度说明
多模态图像理解:GPT-4o Vision 到开源视觉大模型⭐⭐⭐⭐⭐ 深度ViT/CLIP 编码、五大模型 API 对比、VQA/OCR/图表/UI 自动化四大场景代码
多模态视频分析:关键帧提取到时序理解⭐⭐⭐⭐⭐ 深度场景检测、Gemini 原生视频、Video-LLaMA 本地方案、视频摘要/动作识别/异常检测
多模态语音合成与识别:Whisper + TTS + 实时交互⭐⭐⭐⭐ 深度ASR/TTS/VAD 三大组件、WebRTC 实时管道、语音克隆 XTTS v2、成本估算
多模态生成式 AI:文生图/视频与图生图⭐⭐⭐⭐ 深度DALL-E3/SDXL/Flux/Sora/Runway、ControlNet/IP-Adapter、批量流水线、版权伦理
实时语音 Agent:全双工对话与低延迟链路⭐⭐⭐⭐⭐ 深度VAD 端点检测、流式 ASR、LLM 首 token 优化、流式 TTS 与打断(Barge-in),端到端延迟预算表、WebRTC/WebSocket 传输选型、全双工状态机与容量规划

9. 推理部署与优化

文章深度说明
LLM 推理部署与优化:vLLM、量化与长上下文⭐⭐⭐⭐⭐ 深度vLLM PagedAttention vs TGI vs llama.cpp、GGUF/AWQ/GPTQ/FP8 量化、动态批处理、FastAPI + vLLM 完整部署
LLM 语义缓存与模型路由:成本治理的两大杠杆⭐⭐⭐⭐⭐ 深度语义缓存命中阈值校准、缓存一致性/击穿防护、三级路由(规则+分类器+升级)、LiteLLM 网关、影子对比与 ROI 测算
LLM 成本治理与 Token 优化⭐⭐⭐⭐ 深度计费模型拆解、缓存命中、模型路由、输入压缩、批处理、成本预算与监控看板
模型路由与选型:大小模型分层调度⭐⭐⭐⭐ 深度任务分级、大小模型路由、级联调度、失败降级与性价比选型矩阵
模型量化与蒸馏:INT8/INT4 与部署权衡⭐⭐⭐⭐ 深度对称/非对称量化、per-channel 与 group-wise 粒度、GGUF/AWQ/GPTQ/NF4/FP8 格式对比,llama.cpp 与 AutoAWQ 实操、知识蒸馏与剪枝、部署权衡与评估
长上下文优化:注意力稀疏化与 KV Cache 管理⭐⭐⭐⭐⭐ 深度注意力稀疏化(滑动窗口/注意力汇/H2O 驱逐)、KV Cache 管理(PagedAttention/前缀共享/KV 量化)、位置编码外推(RoPE scaling/YaRN),附显存计算与评估方法

交叉链接:


10. 安全、评估与治理

文章深度说明
LLM 安全、评估与治理⭐⭐⭐⭐ 深度威胁建模、Ragas/deepeval 评估框架、内容审核、PII 检测、EU AI Act / NIST 合规
模型评估与 LLMOps:从离线评测到生产监控的闭环体系⭐⭐⭐⭐⭐ 深度Golden Set 设计、RAGAS 四维指标、LLM-as-a-Judge 可靠性校准、CI 回归门禁、生产采样监控、成本追踪与模型路由
Prompt Injection 防御实战:攻击分类与四层防御体系⭐⭐⭐⭐⭐ 深度直接/间接/越狱/泄露四类攻击、输入过滤/模板硬化/输出校验/沙箱四层防御、完整防御代码
AI 安全红队测试:自动化漏洞扫描与对抗评估⭐⭐⭐⭐⭐ 深度Garak/PyRIT 框架实战、对抗样本变异引擎、风险评分矩阵、CI/CD 集成方案、合规基线
LLM 输出护栏与内容安全⭐⭐⭐⭐ 深度输出护栏分层架构、格式强制、PII 脱敏、内容过滤、分类器与合规落地

11. 开源生态与本地运行

文章深度说明
LLM 本地部署与私有模型⭐⭐⭐⭐⭐ 深度Ollama、llama.cpp、vLLM、模型量化、硬件选型、OpenAI 兼容 API
LLM 商业应用开发⭐⭐⭐⭐⭐ 深度AI 产品化方法论、定价模型、PMF 验证、成本优化、合规与团队构建
AI Agent 产品设计方法论⭐⭐⭐⭐⭐ 深度Agent 产品架构、UX 模式、记忆设计、多智能体协作、信任与透明度
端侧推理:移动端与浏览器部署⭐⭐⭐⭐ 深度iOS Core ML/MLX、Android NNAPI/Vulkan、浏览器 WebGPU/WASM SIMD 三条路线,模型格式与量化档位选型、内存水位与热降频管理、端云协同与性能实测

历史参考:

相关工具:


12. 已有参考资源


专题横向对比

维度LLM / AIPythonRust
开发语言Python 为主PythonRust
训练生态⭐⭐⭐⭐⭐ HuggingFace⭐⭐⭐⭐⭐ PyTorch/NumPy⭐⭐⭐ Candle(推理为主)
推理性能vLLM / TensorRT(生产)uv + 标准库⭐⭐⭐⭐⭐ 原生性能
部署体积数 GB(含模型)轻量(服务层)< 50MB(二进制)
并发能力vLLM PagedAttentionasyncio / multiprocessingasync/await + 零成本抽象
适合场景AI 应用层、RAG、Agent通用后端、数据管道推理服务、向量数据库基础设施

提示:LLM 专题文章总计 46 篇(覆盖 LLM API、Prompt 工程与上下文工程、RAG(4篇,含 Embedding/Reranker 深度调优与 GraphRAG)、向量数据库、微调、AI Agent(6篇,含记忆系统)、MCP(4篇)、多模态(4篇)、推理优化与成本治理(含语义缓存/模型路由)、评估与 LLMOps、安全治理、AI 产品化、本地部署、Agent 产品设计、结构化输出与受限解码、量化与蒸馏、实时语音 Agent、长上下文优化、RAG 评估体系、端侧推理全链路)。在搜索引擎中搜索 LLM 开发指南、AI Agent 架构、GraphRAG、Reranker 调优、LLM 语义缓存、模型评估、MCP 协议、本地大模型部署 等关键词时,本聚类索引提供直达路径。

关联专题

专题LLM 关联点
AI 推理加速TensorRT-LLM、vLLM、ONNX Runtime LLM 推理优化
AI / ML 算法Transformer 原理、模型训练、微调(Fine-tuning)、RLHF
Python 全栈LangChain、LlamaIndex、AutoGPT、CrewAI Agent 框架
数据库专题向量数据库(pgvector/Milvus/Pinecone)、知识图谱存储
分布式系统分布式 LLM 推理服务、多节点部署、模型分片
DevOps 专题LLM 推理服务 CI/CD、A/B 测试、模型版本管理
信息安全Prompt Injection 防御、模型越狱检测、数据隐私保护
前端工程化 — AI 驱动的前端开发:AI 辅助编码、自动化 UI 生成、智能 CSS
HPC 高性能计算 — 大规模 LLM 训练集群:GPU 集群调度、InfiniBand 网络、并行训练框架
操作系统 — LLM 推理引擎的系统级优化:显存管理、NUMA 感知、IO 调度
全部文章 game Indie Java golang Books 客户端开发 Minigame Saas rust Python
llm

模型路由与选型:大小模型分层调度

面对市面上从几十亿参数的小模型到上千亿参数的旗舰模型,一个自然的问题是:所有请求都该用最强模型吗? 答案是显而易见的否定——但更关键的问题是:如何系统化地决定“这个请求该用哪个模型”?模型路由(Model Routing)把这个问题从“人拍脑袋”变成“可编程的调度决策”:按任务复杂度、质量要求、成本 …

8 分钟阅读
LLM model-routing llmops
llm

混合检索 RAG:BM25 与向量融合

只靠向量检索的 RAG 有一个结构性弱点:语义相近不等于字面匹配。用户搜“怎么退订会员”,向量检索能抓到“取消订阅”的语义文档,却常常漏掉只在正文里出现“退订 扣费 别再续”这种字面表述的条款。反过来,关键词检索(BM25)擅长精确字面命中,却对“用户说的”与“文档写的”之间的语义鸿沟无能为力。混合 …

10 分钟阅读
LLM RAG BM25
llm

LLM 成本治理与 Token 优化

LLM 应用上线的第一周往往没有人关心成本,第三个月账单寄来时才发现一个问答功能每月烧掉数千美元。成本的失控不是发生在单次调用,而是发生在规模放大之后:同样的功能,调用量从每天 100 次涨到 10 万次,每一次多花的几厘钱都会放大为巨额账单。LLM 成本治理的目标不是“省钱省到影响质量”,而是在质 …

9 分钟阅读
LLM cost-optimization token
llm

LLM 流式输出与实时交互工程

人类对“等待”的耐心是有限的:当用户发出一个问题,超过 3 秒没有反馈,流失率就会显著上升。LLM 应用因此把“生成中”的状态转化为体验的一部分——流式输出让模型一个字一个字地“打字”,用户感受到的不是等待,而是思考的进行。但流式不是简单地把 HTTP 响应切成小块。它牵扯协议选型、增量解析、中断语 …

8 分钟阅读
LLM streaming SSE
llm

Agent 记忆系统实战:从上下文窗口到长期记忆的持久化架构

LLM 本身没有记忆——每次调用都从空白上下文开始。但真实的智能应用需要跨会话记住用户偏好、任务进度与历史事实。Agent 记忆系统正是为了解决"上下文是易失的、知识是永恒的"这一矛盾而生的工程领域。本指南从记忆的类型学出发,系统覆盖短期工作记忆、长期语义记忆、情景记忆与程序性记 …

17 分钟阅读
LLM agent memory
llm

AI Agent 产品设计方法论:从交互范式到产品落地的完整框架

系统拆解 AI Agent 产品设计的完整方法论体系:从工具思维到 Agent 思维的范式迁移、五大核心组件 UX 设计、四种交互模式(Chat/Copilot/Autonomous/Hybrid)、分层记忆系统设计、可靠性工程与容错策略、多智能体编排的 UX 挑战、信任与可解释性设计。 涵盖 ReAct、Plan-and-Solve、Reflexion、DEPS 四大设计模式的适用场景,以及 Devin、AutoGPT、Claude Computer Use 三个经典案例的产品分析。 附 Agent 产品评估矩阵、自主度光谱模型与伦理安全护栏设计框架。

24 分钟阅读
AI Agent 产品设计 交互设计
llm

大模型本地部署与私有托管:从 Ollama 到 vLLM 生产级推理集群

全面指南:本地部署 LLM 的核心动机(隐私/成本/合规/延迟)、Ollama 一键部署与自定义 Modelfile、llama.cpp / llamafile CPU 推理优化、vLLM 生产级 GPU 服务、TGI 与 HuggingFace 生态集成、GGUF/AWQ/GPTQ/FP8 量化方案选型、LocalAI / LM Studio / GPT4All 自托管方案、CPU vs GPU 硬件需求与 VRAM 估算公式、OpenAI 兼容 API 集成模式、私有模型安全加固策略。包含完整 Docker Compose 模板、基准测试数据与实践命令。

14 分钟阅读
vLLM Docker