Camel多智能体交流框架开发教程

教程导读：把两个智能体请上台

戏班后台有句行话，叫"双人成局"。把这句行话翻译成大模型圈的术语，就是 RolePlaying：给大语言模型分别派定提需求的用户与干活的助理这双重身份，让它们在不受人工干预的台上你来我往，把模糊的想法一步步推进成完整交付物。KAUST 的研究团队最早把这套戏码立上台面，并给整套机制起了名字：CAMEL，Communicative Agents for "Mind" Exploration of Large Language Model Society，NeurIPS 收录，公认是率先基于大语言模型的角色扮演多智能体框架——多智能体协作这门手艺，最先立住的恰恰就是这样的"双人局"：角色立住了，戏就活了一半，剩下的，是编剧给足本子、导演压住节奏、后台备好行头。

很多人第一次看到两个智能体自主对话的输出记录时，反应出奇一致：这不就是两个模型在聊天吗，有什么难处？难处恰恰藏在这句轻描淡写里。你亲手试一次就知道，不加约束的两个模型聊天，三句话就会开始互相吹捧，十句话之内必定跑题，二十句话之后它们在讨论的问题已经和你的任务毫无关系。CAMEL 的全部工程价值，就在于把这场"聊天"驯化成一场有剧本、有轮次、有终止条件的"演出"：角色怎么设定，台词怎么约束，任务怎么拆幕，戏什么时候该收。本册要拆解的，正是这套编排手艺的里里外外。

这本册子怎么读

全册六章，跟着一场戏的完整生命周期走。你在任何一章卡住，都可以回到下面这张知识地图，看清当前站位和前后承接。

图 1 全册知识地图：一场戏的六道工序

读法上有两条建议。第一条：第 1、2 章是概念地基，第 3 章才动手，如果你想先跑起来再回头补理论，完全可以按 3、1、2 的顺序读，但第 2 章的启示式提示一节无论如何不能跳——它是整台剧场的剧本机制，跳过它后面所有调参都成了碰运气。第二条：第 5 章的四个案例不是"完事示例集"，而是四套可迁移的编排方案，读的时候建议对着自己手头的任务问一句：我的角色该怎么设、我的终止条件该收在哪。

读完后你应当能做什么

1. 说清 RolePlaying 机制里两个角色的分工：AI 用户智能体负责下达指令与验收，AI 助理智能体负责交付方案，谁也不能越位；
2. 独立写出一对合格的启示式提示，包含角色定义、任务目标、行为约束三要素，并让两个提示互相咬合；
3. 用任务分解器把一句模糊需求拆成可执行的幕次结构，并为每场戏设定轮次上限与终止条件；
4. 部署一个最小可运行的双智能体环境，跑通第一场十轮以内的对手戏并读懂对话日志；
5. 在基础对手戏上加入评论家在环与具身工具，把"会聊"升级成"会干活"；
6. 面对一个真实业务场景，判断它适不适合双智能体编排，并给出角色设定初稿。

与姊妹教程的分工

市面上的多智能体教程不少，定位容易混。给你一个省心的判断：如果你想学的是"一群智能体怎么开会"——多方议程、工具席次、纪要汇总——那属于 OWL 那类社会型框架的故事；本册只讲"两个角色怎么演好对手戏"。CAMEL 的角色扮演机制是后来几乎所有多智能体框架的公共地基，地基打牢了，去看任何群戏框架都不会晕。

一个提醒放在前面：本册所有代码示例都围绕角色编排展开，模型密钥、计费、数据合规属于你自己的运维事项，示例里的密钥占位符请一律替换为你自己的凭据，且不要把凭据写进任何会被提交的文件。

戏票已经检过，下一章，先认识台上这两位主角。