불러오는 중
불러오는 중
사용 설명서 · RC-130
반복 실행되는 에이전트 루프가 언제 멈추고, 실패하면 어떻게 다시 시도하며, 어느 시점에 사람에게 넘길지 설계하는 AI 직원입니다. 설계 문서만 만들며 에이전트를 실행하지 않습니다.
추천 방식: Claude Code — 이 직원의 외부 실행 흐름이 Claude Code를 전제로 하므로 Claude 쪽 사용을 권합니다.
업무 흐름에 맞춘 제품 추천이며 모델 성능 비교가 아닙니다. 외부 AI 요금은 Recrua 결제와 별도입니다.
지시문 복사로 바로 쓰거나, 권한이 있으면 Recrua MCP를 사용자 정의 커넥터·Claude Code에 연결해 Recrua 서버로 실행합니다.
지시문 방식은 Claude 계정만 있으면 됩니다. MCP 연결은 MCP 프로 이상 결제와 /settings 키가 필요합니다.
지시문을 붙이거나, 커넥터 URL https://recrua.store/api/mcp 에 요청 헤더 Authorization: Bearer 키를 설정합니다.
MCP라면 run_agent에 agent_no 130와 에이전트 루프 설명 입력을 넘깁니다. 실행·기록·크레딧은 Recrua 서버에서 처리됩니다.
결과 끝 검수 포인트에서 확인 필요 항목을 해소하고, 전문가 상담을 요청합니다.
| 도구·기능·자료 | 필수 | 용도 | 준비 방법·권한 | 단계 | 상태 |
|---|---|---|---|---|---|
| 웹 브라우저 | 필수 | 초안용 | 설치할 앱 없음. 최신 브라우저로 접속 | 준비 | 사용 가능 |
| Claude 계정 | 필수 | 초안용 | 외부 서비스. 요금은 별도 | 준비 | 사용자가 직접 준비 |
| Recrua MCP 키 (mcp 범위) | 선택 | 실행용 | MCP 프로 이상 결제 후 /settings에서 발급 | 준비 | 요금제·권한 필요 |
| 자료: 에이전트 루프 설명 | 필수 | 초안용 | 예: 에이전트가 반복하는 작업, 사용하는 도구, 성공 기준 | 자료 연결 | 사용자가 직접 준비 |
| 자료: 겪은 실패 사례 | 선택 | 초안용 | 예: 무한 반복, 같은 오류 반복, 외부 API 오류 | 자료 연결 | 사용자가 직접 준비 |
| Claude 사용자 정의 커넥터 | 선택 | 실행용 | 계정·워크스페이스 권한에 따라 사용 가능 · 공식 문서 | 자료 연결 | 설정 예시 · 미검증 |
| Claude Code | 선택 | 실행용 | 공식 문서에 따라 설치 후 MCP 추가 · 공식 문서 | 자료 연결 | 설정 예시 · 미검증 |
| 에이전트 프레임워크 또는 Claude Code | 선택 | 실행용 | 설계를 코드로 옮길 때 사용자가 직접 구현, 기능은 [공식 문서 확인] | 실행 | 사용자가 직접 준비 |
| 실행 API 키 (runs:write) | 선택 | 실행용 | MCP 비즈니스 + 업무 실행 권한 | 실행 | 요금제·권한 필요 |
당신은 "에이전트 루프 종료·복구 설계 담당" 역할로 일합니다. 맡은 과제: 에이전트 반복 작업의 멈춤 조건과 복구 방법을 정하고 싶어요 만들 결과물: 종료 조건표, 재시도·백오프 규칙, 오류 복구와 사람 확인 절차 [작업 순서] 1. 성공 기준과 함께 최대 반복 횟수·시간 상한·진전 없음 판단 기준으로 종료 조건 정의 2. 오류를 일시적 오류와 반복 오류로 나누고 일시적 오류에만 재시도·백오프 규칙 적용 3. 실패 시 마지막 정상 상태로 되돌리는 복구 지점과 변경 기록 방법 지정 4. 같은 실패 반복이나 위험 작업 전에는 멈추고 사람 확인을 요청하는 절차 작성 [넘기기 전 점검] - 종료 조건 없이 끝나지 않는 경로가 남아 있지 않은지 확인 - 재시도 대상이 아닌 오류가 재시도 규칙에 들어가지 않았는지 확인 - 상한 수치는 [사용자 가정]으로 표시 - 사람 확인 요청에 지금까지의 시도 요약이 포함되는지 확인 [답변 형식] "## 핵심 결론", "## 본문", "## 확인 필요 사항", "## 다음 단계" 네 제목을 이 순서로 쓰고, "## 본문" 안에서 다음 소제목을 씁니다: 종료 조건표 / 재시도·백오프 규칙 / 오류 복구 지점 / 사람 확인 절차 [지켜야 할 것] - 근거 없는 수치·조문·사례를 만들지 말고, 확실하지 않은 내용은 "확인 필요 사항"에 분리합니다. - '보장', '완벽', '100%' 같은 단정 표현을 쓰지 않습니다. - 결과물은 초안입니다. 발송·제출·게시·설치·실행을 했다고 쓰지 않습니다. 그 일은 사용자가 검토 후 직접 합니다. - 하지 않는 일: 에이전트 코드를 실행하거나 배포하지 않음, 특정 프레임워크의 내장 기능을 확인 없이 단정하지 않음, 재시도 횟수·대기 시간의 정답 수치를 제시하지 않고 [사용자 가정]으로 둠, 운영 환경 접근 권한을 받지 않음, 외부 도구·계정에서의 실제 실행·설치·발송 (사용자가 검토 후 직접 진행) [내 자료] 아래 항목을 채워 함께 보냅니다. 주민등록번호·계좌번호 등 민감정보는 가립니다. - 에이전트 루프 설명 (필수): [여기에 입력 — 예: 테스트가 통과할 때까지 코드를 고치고 다시 테스트하는 에이전트. 도구: 파일 수정, 테스트 실행. 성공 기준: 전체 테스트 통과] - 겪은 실패 사례 (선택): [여기에 입력 — 예: 같은 테스트 실패를 고치다가 다른 파일을 계속 바꾸며 수십 번 반복함]
공개 기본 지시문입니다. 결제 없이 쓸 수 있습니다.
URL: https://recrua.store/api/mcp 요청 헤더: Authorization = Bearer <설정에서 발급한 rk_ 키>
키는 커넥터 설정 칸에만 넣고 대화·문서에 붙이지 마세요.
export RECRUA_API_KEY="<설정에서 발급한 키>" claude mcp add --transport http recrua https://recrua.store/api/mcp --header "Authorization: Bearer $RECRUA_API_KEY"
실행 후 Claude Code에서 /mcp로 연결 상태를 확인합니다.
{
"name": "run_agent",
"arguments": {
"agent_no": 130,
"inputs": {
"situation": "테스트가 통과할 때까지 코드를 고치고 다시 테스트하는 에이전트. 도구: 파일 수정, 테스트 실행. 성공 기준: 전체 테스트 통과"
}
}
}필수 입력 키만 담은 예시입니다. 실제 값은 내 자료로 바꿉니다.
| 항목 | 필수 | 예시 (작성 예) |
|---|---|---|
| 에이전트 루프 설명 | 필수 | 테스트가 통과할 때까지 코드를 고치고 다시 테스트하는 에이전트. 도구: 파일 수정, 테스트 실행. 성공 기준: 전체 테스트 통과 |
| 겪은 실패 사례 | 선택 | 같은 테스트 실패를 고치다가 다른 파일을 계속 바꾸며 수십 번 반복함 |
테스트 통과까지 반복하는 수정 에이전트 루프 설계 예시
성공 기준: 종료 조건표, 재시도·백오프 규칙, 오류 복구와 사람 확인 절차가 모두 들어 있고, 검수 포인트의 ✗ 항목이 해소되었으며, 확인 필요 사항이 사용자 자료나 담당자 확인으로 정리된 상태.
| 문제 | 해결 |
|---|---|
| 필수 항목이 비어 실행되지 않음 | 필수 입력 항목(에이전트 루프 설명)을 채웁니다. 무엇을 넣을지 모르면 "예시로 채우기"를 먼저 봅니다. |
| "AI 제공자가 연결되지 않아 실행하지 않았습니다" | 운영자가 AI 제공자를 연결하기 전입니다. 차감되지 않았으니 GPT·Claude 지시문 방식으로 진행할 수 있습니다. |
| 시범 3회를 모두 사용함 | 웹 베이직 이상 요금제로 채용하면 크레딧으로 계속 실행합니다. 카드 결제는 가능입니다. |
| MCP·API에서 401 또는 요금제 오류 | 키 범위(mcp, runs:write)와 요금제(MCP는 프로 이상, API는 비즈니스), 이 직원이 요금제에 포함되는지 확인합니다. |
| 결과에 "종료 조건표" 같은 소제목이 빠짐 | "답변 형식 그대로 다시 써 줘" 또는 수정 요청으로 다시 받습니다. |
에이전트 루프 설명에 다음처럼 적고 실행해 보세요.
테스트가 통과할 때까지 코드를 고치고 다시 테스트하는 에이전트. 도구: 파일 수정, 테스트 실행. 성공 기준: 전체 테스트 통과
에이전트 가이드는 전문가를 대체하지 않습니다. 남는 판단은 전문가 상담 연결을 요청하세요.
curl -X POST https://recrua.store/api/v1/runs \ -H "Authorization: Bearer $RECRUA_API_KEY" \ -H "Content-Type: application/json" \ --data @recrua-request.json
runs:write 범위 키가 필요합니다. 요청 본문은 recrua-request.json 파일로 내려받아 값을 바꿉니다.
{
"agent_no": 130,
"inputs": {
"situation": "테스트가 통과할 때까지 코드를 고치고 다시 테스트하는 에이전트. 도구: 파일 수정, 테스트 실행. 성공 기준: 전체 테스트 통과",
"failures": "같은 테스트 실패를 고치다가 다른 파일을 계속 바꾸며 수십 번 반복함"
}
}agent_no와 입력 키는 이 직원의 실제 입력 항목입니다.
이 에이전트는 업무를 돕는 AI 어시스턴트입니다. 결과의 정확성·완결성이나 최종 확정을 보장하지 않으며, 중요한 판단은 관련 전문가의 검토가 필요합니다.
전문가 상담 연결