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 使用量或货币成本来防止无限循环。
• 上下文管理：内置针对长时间运行循环的摘要功能，以管理上下文窗口。
• 反馈注入：利用失败验证的结果来指导代理的后续尝试。