AI 实战文档

Appearance

AI 最佳实践总览 ​

这一章给你一套可执行的主框架，避免"会用模型，但系统不稳定"的常见问题。

本章默认以两个核心角色展开：

  • 开发者：关注可实现性、稳定性、性能、成本。
  • 产品经理：关注业务目标、体验质量、风险与上线策略。

一张图看落地闭环 ​

文档导航 ​

核心实践 ​

文档说明适用角色
提示词设计提示词设计原则和技巧开发者、产品经理
上下文与 RAGRAG 架构和优化策略开发者
评测与迭代评测体系和迭代流程开发者、产品经理
安全与治理安全防护和合规要求开发者、产品经理
工程落地手册从 Demo 到生产的工程实践开发者

Agent 设计 ​

文档说明适用角色
Agent 设计模式ReAct、Reflexion、Plan-Execute 等核心模式开发者
多 Agent 协作多 Agent 协作和冲突治理开发者
函数调用与工具使用函数调用和工具集成最佳实践开发者

工程实践 ​

文档说明适用角色
上下文管理上下文窗口管理和优化开发者
流式响应处理流式响应的实现和优化开发者
错误处理与容错错误处理、重试、降级策略开发者
模型选择与路由模型选择策略和智能路由开发者
成本优化策略Token 优化、缓存、成本监控开发者、产品经理
可观测性与监控指标、日志、告警、仪表板开发者、运维

数据与模型 ​

文档说明适用角色
数据处理与标注数据采集、清洗、标注、验证、增强开发者、产品经理
模型微调微调决策、LoRA、训练监控、评估开发者

多模态处理 ​

文档说明适用角色
多模态处理图像、音频、视频处理与融合开发者

快速实践 ​

文档说明适用角色
最快最简单的 RAG本地 RAG 快速实现开发者
AI 编程工具生态AI 编辑器、补全工具、Cursor Rules开发者
可复用提示词模板18 个实用提示词模板开发者、产品经理
常见问题 FAQAI 工程常见问题解答开发者、产品经理

协作流程 ​

文档说明适用角色
角色驱动交付链路开发者与产品经理协作流程开发者、产品经理
开发者与产品经理协作Agent 工程协作地图开发者、产品经理

团队常见失误 ​

  • 直接上生产，没有评测基线。
  • 只调提示词，不调数据与工具。
  • 指标只看"回答看起来不错"，不看任务级 KPI。
  • 安全只靠单点过滤，没有全链路防护。
  • 没有成本监控，预算超支。
  • 错误处理不完善，系统不稳定。

成熟度分级 ​

等级名称特征关键能力
L1原型能跑通 Demo，但结果不稳定基础提示词、简单 RAG
L2可用有最小评测集和错误分类评测体系、错误分类
L3可靠有回归测试、灰度、监控与告警自动评测、监控告警、回滚机制
L4规模化多模型路由、成本优化、治理流程完善智能路由、成本优化、安全治理

角色驱动主线 ​

从"按主题阅读"升级到"按角色协作阅读"，建议先看：

在这页里，你可以看到每个阶段里开发者与产品经理分别该产出什么，以及如何交接。

推荐阅读路径 ​

开发者优先 ​

text
提示词设计 → 上下文与 RAG → Agent 设计模式 → 函数调用
     │              │              │              │
     ↓              ↓              ↓              ↓
评测体系 → 工程落地 → 流式响应 → 错误处理
     │              │              │              │
     ↓              ↓              ↓              ↓
安全治理 → 成本优化 → 模型路由 → 监控告警

产品经理优先 ​

text
角色驱动链路 → 评测与迭代 → 安全与治理 → 成本优化
     │              │              │              │
     ↓              ↓              ↓              ↓
提示词模板 → FAQ → 工程落地手册

快速入门 ​

text
最快 RAG → 提示词模板 → FAQ → 工程落地手册

下一步 ​