章节摘要:本章跟着一次真实的开演走:从一台干净的机器出发,装环境、配密钥、跑通第一场十轮对手戏、读懂演出日志、把舞台参数调顺。第 2 章写的剧本在本章原样上场——如果你是先跳到这里想跑起来的读者,读完本章你手里会有一个能转的最小系统,再回第 2 章补剧本手艺即可。
主线从安装命令敲下后的一连串报错开始。环境问题有个讨厌的特点:每一个都简单,连起来就是一下午。而环境之外,首演还有三道更隐蔽的坎:密钥放哪、跑不起来是剧本的锅还是参数的锅、跑起来了怎么判断这场戏演得好不好。本章的主线,就是把这三道坎按真实顺序过完:先搭台(3.1),再开锣(3.2),然后学会看仪表盘(3.3 的参数与调优),最后把常用工具摸熟(3.4 的 API 速查)。
需要先交代一个立场:本章所有的环境动作都围绕"最小可演出系统"展开——一个解释器、一个框架包、一把密钥,仅此而已。教程里常见的"先装十几个依赖"的开场对双智能体编排没有意义,那是在为第 4 章的具身工具预支复杂度。首演要的是最快看到第一场戏,复杂度等真的需要时再引入。
本章的认知拐点在 3.2 与 3.3 之间:跑通不是终点,可诊断才是。第一场戏能跑通的人很多,但能在它演砸的第三轮说出"这是温度问题不是剧本问题"的人很少。诊断能力的核心是把每次演出当数据看——所以 3.2 节会要求你把日志落盘成文件,3.3 节的每个调参建议都挂在日志的某个字段上。养成这个习惯,第 4 章的加戏和第 6 章的剧评才有地基。
第二个拐点藏在 3.1:密钥管理看似运维小事,实则是编排工程的安全底线。双智能体系统一次实验就是几十次调用,密钥一旦泄漏进版本库,损失是按调用计费的。四层环境的顺序(解释器→虚拟环境→框架包→密钥)不能乱,乱了哪层都会在几小时后才暴露。
首演成功只是及格线。第 4 章开始给这台剧场加戏:让演员走下舞台调用真实工具(具身智能体)、请一位审戏人入场把关(评论家在环)、把一场戏复制成一百场(数据合成),最后看看对手戏怎么长成群戏。每一个新机制都架在你本章跑通的骨架上。