本节摘要:Parlant 不是实验室里先发明哲学再找场景,而是企业定制对话代理时被随机性、难复用、难审核逼出来的。对照通用 Agent 的「先智能后治理」和规则引擎的「先确定后补口语」,它从第一天就把确定性步骤从生成里拆走。开源后用存储抽象和文档分层长生态。许可证在原文不同章节说法不一致,选型时以当时官方声明为准。
阅读完本节,你应当能够:
据原文,项目来自 Emcie 团队做企业 AI 时的真实麻烦:输出随机,业务流程不确定;提示和任务死绑,复用差;状态乱,调试难;客户要求「这步必须人工审」「情绪负面立刻转人工」时,端到端生成几乎做不到。这和当时流行的通用 Agent 叙事正好相反——那边在比谁更会自己规划,这边在比谁还能把步骤按住。
设计理念被写成:代理是确定性逻辑驱动、LLM 提供感知与生成的混合系统。早期形态允许声明式定义对话状态机,每个节点里让模型做子任务:意图、槽位、情感、回复。What 由状态图定义,How 由受控的模型完成。银行客服里「验证身份」是必须状态,失败三次转人工——不管模型回复写得多好听。
2023 年底开源。原文写仓库归属 emcie-co 项目、文档站点公开。初始版本就带 SDK、本地示例和 JSON 存储,意图是降低第一次接触成本。对照很多 Agent 框架:演示很炫,持久化、审计要自己拼。Parlant 把「能复现的状态」当开源第一天的货物,而不是路线图上的勾。
早期纯内存,重启丢失客户与会话。社区反馈指向持久化。团队没有绑单一数据库,而是做存储抽象:接口统一,后端可换。
| 后端 | 适用 | 对照其他框架常见做法 | 代价 |
|---|---|---|---|
| 内存 | 原型、测试 | 很多演示默认如此且停在这 | 不能生产 |
| 本地 JSON | 开发、轻量部署 | 少见,通常直接上 Postgres | 并发与运维上限明显 |
| MongoDB | 生产,文档模型贴近半结构化会话 | 通用 Agent 常让你自选任意库 | 要会运维该库 |
| 更多库 | 原文写「可预见社区会加」 | 有的框架第一天就抽象一切 | 当时不能当成已支持 |
概念配置:customer_store 与 session_store 可指向本地或 MongoDB 连接串。开发到生产换的是后端,不是会话语义。这和「把整个 Lang 式记忆对象 pickle 进磁盘」不同——后者版本一变就打不开。
开源策略原文强调:文档当产品,从五分钟上手到状态机设计;对接主流模型提供商与本地开源模型;状态机可导出与其他工具链交互;路线图吸收社区高频需求,例如 Webhook 回调、可视化编辑。许可证策略被历程章写成宽松 MIT、允许商业闭源使用——这里先记下,后面必须和简介、许可证章对照。
⚠️ 常见坑:读到「开源」就默认生产模块也全免费。原文许可证章写过核心与企业扩展可能分层。采购前核对照仓库声明,不要用教程里的历史表述当合同。
💡 关键直觉:它故意不做大而全。LLM 调用、向量检索、前端留给生态。克制换来的是能和检索增强、编排工具并肩,而不是再造一个封闭全家桶。
社区与支持,原文还写过:讨论区活跃、文档分层(概念/操作/参考)、Discord 一类即时渠道、商业支持与合作作为企业选项。这些从原第 6 章并入此处,避免单独注水成四节。学习路径仍是官方文档优先,社区第二,商业支持第三——和「先加咨询顾问群」的销售型框架对照。
这是对照驱动里最需要诚实的一块。同一文集内部:
| 出处 | 表述 | 能推出什么 | 不能推出什么 |
|---|---|---|---|
| 简介/概述 | Apache 2.0,便于集成到现有栈 | 核心偏宽松开源 | 不能否定其他章节的 MIT 或分层说 |
| 历程节 | MIT,允许商业闭源使用 | 强调企业评估友好 | 不能据此写死「一定是 MIT」 |
| 许可证节 | 分层:核心常见 MIT 或 Apache 2.0;企业合规模块可能商业许可或双许可 | 采购要看模块边界 | 不能把企业模块写成一定开源 |
三处冲突本身就说明:教程作者不是许可证权威。正确做法是并列展示 + 指向当时官方仓库与文档的声明。本平台正文不能放网址,书面表述用「其官方仓库与文档中的许可证声明」。金融医疗客户真正关心的是:能否闭源部署、微调权重是否要公开、有无专利授权条款——这些只能对着正式文本勾,不能对着本教程勾。

历程章再次强调主场:金融保险客服要可追溯;医疗预筛要问题不漏、敏感信息合规;内部 IT 要按 SOP 走。优势是确定性高于一切,模型当传感器和接口。代价是开放闲聊会显得僵;复杂状态图设计成本高;简单 FAQ 可能过重。社区原话大意:要训练有素的员工用它,要天马行空的朋友请另寻。
截至原文写作的 2024 年中,方向包括:多代理协作实验、可观测性往开源追踪标准靠、低代码可视化。宏观叙事是从追模型能力转向追系统可靠。这些是趋势判断,不是版本发布说明。
文档学习资源原文分成概念层、操作层、参考层,对应不同角色。业务读概念和写指南教程,开发读工具注册与 API 参考。这比「一份 README 打天下」更接近双轨用户假设。缺文档时,再好的分离也会在协作里重新耦合。
开源生态容易写成赞美诗。采购视角只问四件事。文档是否按角色分层,业务能否不读接口说明也能写指南。存储抽象是否真能从本地换到生产库而不改会话语义。模型后端能否换,以免被单一供应商卡住。许可证以当时官方声明为准,原文内部不一致必须写进风险登记,由法务核,不由教程作者拍板。
Emcie 团队从内部痛点出发,决定把强制人工节点做成系统能力,这和当时比谁更会自主规划的潮流是逆行。逆行的代价是状态图要设计、指南要维护;收益是企业问「这步必须人审」时你不是靠提示词赌。历史读到这里,应能解释为什么它不做全家桶:检索、前端、向量库留给生态,核心守运行时控制。大而全会让控制点再次糊掉。
社区需求里的 Webhook、可视化编辑、多代理,对双轨用户很重要:可视化降低业务门槛,Webhook 把代理接入现有事件总线。它们是生态成熟度指标。没有可视化并不等于不能用,只是指南编写成本更高。不要等编辑器才开始收 SOP,文本指南可以先跑。
学习资源分层:概念层给所有人,操作层按角色,参考层给开发。缺哪一层,协作就会在那一层重新耦合。内部推广时复制这个分层:不要给客服主管一份接口手册,也不要给后端一份心灵鸡汤愿景。第 6 章原文的社区与商业支持,并到这里只保留判断:文档先于社群,社群先于商务,商务不能替代许可证核验。
若你的组织不能接受「核心开源、扩展可能商业」的分层,现在就停,而不是用到企业模块才发现要谈许可。历程章写 MIT、简介写 Apache、许可证章写分层——三处并列,就是为了让你把不确定性交给正式文本,而不是交给记忆。
内存到 JSON 到 MongoDB,说明他们把状态当一等公民。开源第一天带本地存储,说明不把持久化当以后再说。克制全家桶,说明控制点要少而硬。这些是取舍故事。不要从故事推出「下个季度一定有可视化编辑」。路线图是社区意愿,交付以当时文档为准。许可证三处表述并存,本身也是故事:项目在企业与社区之间找平衡,教程作者不是律师。把故事当合同,会在采购后期翻车。历程节读完,留下的应是取舍逻辑,不是日期承诺。
围绕「生态采购四问」,把四条路径再过一遍。表里每格都是可执行判断,不是形容词。读完请把你的项目钉进一格,不要钉在两格之间假装都占了。
| 检查项 | 纯 prompt | 通用 Agent | 规则引擎 | Parlant |
|---|---|---|---|---|
| 决策权放哪 | 无状态故事 | 记忆对象自序列化 | 库表从第一天绑死 | 状态一等公民且可换后端 |
| 改口径谁动手 | 全家桶绑死 | 检索编排UI绑死 | 不接口语生态 | 克制核心外围开放 |
| 行动如何被拦 | 许可证当口号 | 未核正式文本 | 许可清晰但入口僵 | 三处表述并列交法务 |
| 出事如何复盘 | 文档一份打天下 | 只给开发读 | 只给开发读 | 文档按角色分层 |
| 口语进得来吗 | 持久化以后再说 | 演示无存储 | 确定优先 | 开源第一天就带本地存储 |
| 上线第一周验什么 | 看星标 | 看插件数 | 看工单系统 | 看双轨能否运转 |
采购清单不要粉丝应援。可视化编辑没来之前,文本指南可以先跑。等编辑器才收 SOP,是把治理抵押给路线图。
许可证原文不一致必须进风险登记。教程并列展示,结论留给正式声明,不留给记忆。
下一章把「混合系统」拆成模块:规则引擎、上下文、工具网关、审计,并对照 LLM 在别的框架里为什么总当主角。