unreallabsai/unreal-agent

解決的問題

Unreal Agent 是一個以非同步為優先的代理框架，旨在提供一個穩健、持久且可組合的 AI 代理建構框架。它專注於解決與代理工作流程相關的穩定性與可靠性問題，特別是輸入去重、會話持久化以及工具的非同步執行。

工作原理

該系統圍繞一個協調器構建，負責管理代理的生命周期。它使用 會話收件箱 實現輸入冪等性，並使用 會話儲存 持久化歷史記錄和操作狀態，從而支援恢復和會話分叉。流程遵循特定順序：上下文建構器 組裝模型輸入，LLM 適配器 處理與提供方的通訊，工具註冊表 管理功能能力。當 LLM 請求工具時，工具翻譯器 驗證呼叫並将其轉換為可序列化的 操作，由 操作管理器 執行。

適用對象

需要高可靠性、持久狀態管理，並希望將工具定義與非同步執行過程分離的複雜 AI 代理開發者。

主要亮點

• 非同步優先架構：專為非阻塞操作設計。
• 持久會話：支援僅追加的持久化歷史記錄，可分叉。
• 輸入冪等性：使用會話範圍的收件箱，防止外部輸入的重複處理。
• 可組合元件：會話儲存、LLM 適配器和操作管理器的介面可交換，支援自訂實作，例如為工具執行提供遠端沙箱。