vercel-labs/ralph-loop-agent

해결하는 문제

표준 AI 에이전트 루프는 모델이 도구 호출을 완료하면 즉시 중단되는 경우가 많아, 복잡한 워크플로우에서 작업이 미완료되거나 실패할 수 있습니다. Ralph-loop-agent는 "지속적인 자율성"을 제공하여 에이전트가 반복적으로 작업하고, 결과를 검증하며, 피드백을 통해 재시도함으로써 특정 목표가 실제로 달성될 때까지 작동하도록 합니다.

작동 방식

AI SDK의 generateText를 외부 루프에서 감싸는 방식입니다. 프로세스는 다음 단계를 따릅니다:

1. 내부 루프: AI 에이전트가 도구를 사용하여 작업을 시도합니다.
2. 검증: 사용자가 정의한 verifyCompletion 함수가 작업이 실제로 완료되었는지 확인합니다.
3. 피드백: 작업이 미완료된 경우, 실패 원인이 컨텍스트로 에이전트에 주입되어 다음 반복을 위한 정보로 사용됩니다.
4. 종료: 검증 함수가 성공을 반환하거나 안전 정지 조건(반복 횟수, 토큰, 비용 기준)이 충족될 때까지 루프가 계속됩니다.

대상 사용자

코드베이스 마이그레이션, 다중 파일 리팩토링 또는 실제 검증이 필요한 워크플로우와 같이 장시간 실행되는 작업에 대해 높은 신뢰성이 요구되는 복잡한 AI 에이전트를 구축하는 개발자.

주요 특징

• 반복적 완료: 사용자 정의 검증 함수가 성공을 확인할 때까지 계속 실행됩니다.
• AI SDK 호환성: AI SDK 도구 및 AI Gateway 문자열 형식과 완벽하게 호환됩니다.
• 유연한 정지 조건: 반복 횟수, 총 토큰 사용량 또는 비용 제한을 통해 무한 루프를 방지합니다.
• 컨텍스트 관리: 장시간 실행되는 루프를 위해 컨텍스트 윈도우를 관리하는 내장 요약 기능을 포함합니다.
• 피드백 주입: 실패한 검증 결과를 사용하여 에이전트의 후속 시도를 안내합니다.