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 仪表板與原生桌面應用。