vercel-labs/ralph-loop-agent

解決的問題

標準的 AI 代理循環通常在模型完成工具調用後立即停止，這可能導致複雜工作流程中的任務未完成或失敗。Ralph-loop-agent 提供了「持續自主性」，允許代理以迭代方式工作、驗證結果並根據反饋重試，直到真正達成特定目標。

運作方式

它將 AI SDK 的 generateText 包裝在一個外部循環中。流程遵循以下步驟：

1. 內部循環：AI 代理使用工具嘗試執行任務。
2. 驗證：使用者定義的 verifyCompletion 函數會檢查任務是否真正完成。
3. 反饋：如果任務未完成，失敗原因將作為上下文注入回代理，供下一次迭代使用。
4. 終止：循環會持續進行，直到驗證函數返回成功，或達到安全停止條件（基於迭代次數、Token 或成本）。

適用對象

開發者正在構建需要高可靠性、長時間運行任務的複雜 AI 代理，例如代碼庫遷移、多文件重構，或任何需要現實世界驗證的工作流程。

特點

• 迭代完成：持續運行直到自定義驗證函數確認成功。
• AI SDK 相容性：與 AI SDK 工具和 AI Gateway 字串格式完全相容。
• 靈活的停止條件：透過限制迭代次數、總 Token 使用量或貨幣成本來防止無限循環。
• 上下文管理：內建針對長時間運行循環的摘要功能，以管理上下文視窗。
• 反饋注入：利用失敗驗證的結果來指導代理的後續嘗試。