Kohaku-Lab/KohakuTerrarium

解决的问题

KohakuTerrarium 是一个旨在阻止开发者每次创建新 AI 代理时重复构建相同基础架构（"基底"）循环的框架。它提供了一个标准化、可复用的基础，用于代理逻辑、工具分发、会话持久化和多代理编排，使用户可以通过配置文件和自定义模块定义新的代理「形态」，而无需从头重新实现运行时。

工作原理

该框架的核心是 creature（生物体），一个由六个模块组成的独立代理：推理循环（Controller）、输入、输出、工具、触发器和子代理。这些生物体由 Terrarium 引擎托管，负责管理图拓扑、通信通道和会话记录。Studio 层提供 Web 仪表板和桌面应用等管理界面，而可选的 Laboratory 传输层允许通过 WebSockets 将引擎分布在多台机器上。

适用人群

适用于需要可定制代理架构、希望通过 Python 程序化控制代理以执行批处理任务或流水线，或正在构建无法适配于单一现有代理产品的演进型代理需求的开发者。

主要亮点

• 代理级抽象：通过配置文件和自定义模块定义新代理，无需重写运行时。
• 编码组合代数：使用 >>（序列）、&（并行）和 |（回退）等运算符，将代理组合成复杂流水线。
• 内置持久化：原生会话管理支持用户使用 kt resume 数小时后恢复代理。
• MCP 支持：支持按代理或全局连接 Model Context Protocol (MCP) 服务器。
• 包系统：专用市场（kt install @name）用于共享和安装预构建的生物体和插件。
• 多接口支持：开箱即用支持 CLI、TUI、Web 仪表板和原生桌面应用。