简介

Juno

欢迎登上 Crooked Orbit！我是 Juno，很高兴你能来到这里。帮新来的工程师熟悉我们运行的 AI 系统，是我工作中最喜欢的部分——看着这些东西从"魔法"变成你真正理解的东西，这种感觉永远不会腻。

我们会从这些模型底层到底是什么讲起，不需要任何机器学习背景，一点一点把知识搭建起来。

这里没有什么问题是"太基础"而不该问的，相信我，有些东西我搞明白花的时间比我愿意承认的要长得多。按你自己的节奏来，我们会一起走到终点！

Juno

欢迎登上 Crooked Orbit。我是 Ace，系统工程师，负责让这里日常的 AI 构建保持顺利上线。你已经掌握了基础知识，所以我们会用稳健的节奏推进，保持实用，就像你在真实代码里实际接线时那样。

每一章都是先讲概念，再讲怎么用：读一读，试一试，动手做。这个空间站上有一半的系统就是靠这个循环运转的，所以你不是一个人在战斗。

Juno

欢迎登上 Crooked Orbit。我是 Sol，首席工程师，在这里干了十四年，喝了太多咖啡。这些文档是为想知道 AI 系统究竟是怎么运作的人准备的，而不只是想知道该按哪个按钮。

这里大部分东西我都亲手搭过，通常还搭了两遍，因为第一版做错了。这里会讲权衡取舍、失败模式，以及别人都跳过不讲的细节。仔细读，质疑一切，包括我说的话。

这本手册是为想要真正理解 AI 是如何运作的开发者准备的，而不是只调一下 API 然后祈祈祷能用。先说清楚你会一直看到的两个术语：模型指的是你发送文本给它、它再返回文本给你的那个 AI 系统，比如支撑 ChatGPT 的那个；**提示词（prompt）**指的是你发给它的文本和指令。调用一个模型就是一次 API 调用：你的代码通过网络把提示词发给它，再拿到返回的文本，和调用其他任何网络服务没什么不同。这里的概念都写得很完整，有深度、有例子，也方便你随时查阅需要的答案。

这些文档假设你已经会写 Python：变量、函数，以及调用网络 API。如果这正是你的情况，那你已经具备了所需的一切；如果你想先打好基础，Python 手册会从零讲起。你不需要任何机器学习背景。AI 工程做的是用别人训练好的模型来搭建产品，不是自己训练模型。

这里采用的方式是讲清楚这台"机器"本身，而不只是讲 API。任何人都能从教程里抄一段模型调用代码，让它在最顺利的情况下跑起来。而从"能跑起来"到"能稳定上线"之间的距离，就在于理解底层到底发生了什么：模型为什么会给出它给出的结果，它为什么会以这些特定方式出错，以及针对每一种情况你能做什么。

所以这本手册会先花大量篇幅讲清楚这些模型是怎么运作的，然后才告诉你该敲什么代码。它是写给那种更想理解发动机原理、而不只是想转动钥匙的开发者的，因为理解这台机器本身，才是能在任何一个具体模型之外长久留存的东西。正是这种理解，能让你在遇到错误答案时去调试它，而不是只能耸耸肩——不管你明年会用上哪个新模型。

这些文档会深入讲解这些概念，你也会通过练习和自己的项目在这里把它们实践出来。Scrimba 的主课程是同一份内容的"跟着做"版本，有人带着你一步步搭建。

在 Scrimba 上学习 AI 工程师路径用 JavaScript 动手把这些概念搭建成真实应用→

这里用 Python，课程里用 JavaScript

这些文档用 Python 写成；AI 工程师路径则用 JavaScript 讲授同样的内容，面向 Web 开发。这个差异其实没有看起来那么重要：AI 工程在任何语言里做的都是同一件事——通过网络请求把文本发给模型，再处理拿到的返回结果。这里的每一个概念，从 token 和提示词，到检索、智能体和评估，无论用什么语言写都是一样的；变化的只是调用模型时周围的语法。在一边学会了，另一边你也就自然会了，所以在这里阅读和在课程里动手搭建是相互印证、相互强化的。

Juno一个变化飞快的领域 这个领域里的模型名称和价格几乎每个月都在变，所以不用费心去记它们。我们专注在那些相对稳定的部分：这些模型的行为方式，以及围绕它们搭建东西的模式。任何和特定厂商相关的内容，都会放在清楚标注出来的代码块里，等它变了，你只需要改一行代码，周围的思路依然成立。

Juno一个变化飞快的领域 模型名称和价格几乎每月都在变，所以我不去记它们，你也不必记。真正稳定不变的，是这些模型的行为方式，以及你围绕它们搭建的那些模式，这才是我们要讲的重点。任何和特定厂商相关的内容，都放在标注好的代码块里，所以模型一发新版本，只是改一行代码，不用重写。

Juno一个变化飞快的领域 模型名称和价格几乎每个月都在变，这也是为什么我早几年前就不再对任何一个模型上心了。真正持久的是行为方式和那些模式，所以我们的精力就花在这上面。任何和厂商绑定的东西，都放在清楚标注的代码块里，等下一个版本发布时，改一行代码就能接着往前走。

认识你的向导

这本手册由 Crooked Orbit 的三位工程师主持，由你来选谁给你当向导。内容对每个人都是一样的；你选的向导决定的是讲述的语气，以及在会自适应的页面上，每一节讲得有多深入。

你可以随时在任意页面顶部的选择器里切换向导，也可以打开右下角的偏好设置来更改向导、语言或字体大小。

准备好之后，这本手册就正式开始了。下一章，AI 简史，会追溯这些系统七十年来的发展历程，因为这段历史正好告诉你，这个领域里哪些东西是经得住时间考验的，哪些只是今年的一阵风声。