2-06 · Agent 검토 자료 API 연결하기
1. 실습 목표
Agent 검토 자료 파일을 검증해 표본 12건과 초안을 반환하는 GET /api/day2/working-paper를 추가합니다. 파일 오류와 업무 오류를 API 경계에서 구분합니다.
2. 시작 지점
파싱과 내용 검증을 통과한 output/day-2/working-paper.json이 있습니다.
브라우저의 두 번째 과정 진행 안내에서 Working paper API 연결을 확인하고, API 응답의 표본 순서·집계·검증 상태를 기준 파일과 대조합니다.
3. 구현 범위 및 요구사항
- 기존 FastAPI 스타일과 Pydantic/JSON 검증 흐름을 재사용합니다.
- 표본 수·순서,
12 / 4 / 8 / 12, 모든requires_human_review를 반환 전에 확인합니다. - 파일 없음, 잘못된 JSON과 내용 오류를 빈 성공 응답으로 바꾸지 않습니다.
- 첫 과정 집계·예외·사례 상세가 API 추가 전후에 동일한지 회귀 검사합니다.
4. 실습 프롬프트
`working-paper.json`을 읽기 전용 API로 제공하고 잘못된 파일은 준비 완료 상태와 구분해 주세요.
현재 Skill은 `output/day-2/working-paper.json`을 생성하지만 웹앱에서 이 파일을 읽을 방법은 없습니다. 기존 백엔드와 검증 방식을 확인하고 검토 자료를 읽기 전용 API로 제공해 주세요.
구현이 끝나면 정상적인 검토 자료와 파일 또는 계약에 문제가 있는 상태가 명확히 구분되어야 합니다. 화면 연결은 다음 작업을 위해 남겨 두세요.
- `GET /api/day2/working-paper`를 통한 UTF-8 JSON 반환
- 스키마, 실행 ID, 요약, 검토 대상 순서와 담당자 확인 상태 검증
- 파일 없음, 잘못된 JSON과 계약 불일치에 대한 오류 구분
- 원본 JSON 수정과 API 응답을 위한 결과 재생성 금지
- 기존 입력·판정·MCP 기능 유지
- React 화면의 API 호출 연결 금지
정상 API 호출과 기존 검사 명령만 확인해 주세요. 구현 후에는 변경 파일, 실제 API 응답과 오류 처리, 검사 통과 여부와 남은 위험만 간단히 알려 주세요.5. 예상 결과
Success
- 체크포인트:
student/10-working-paper-api-ready- API 집계
12 / 4 / 8 / 12, 정해진 순서- 12건 모두 담당자 확인 필요
- 파일 없음·잘못된 JSON·내용 오류가 정상과 구분됨
- 검토 자료 원본 지문과 첫 과정 집계 유지
- 두 번째 과정 진행 안내와 API 응답에서
12 / 4 / 8 / 12확인
6. 대표 실패 사례 및 복구
Failure
- API와 화면을 동시에 바꿔 원인을 섞음
- 잘못된 JSON을 표본 0건 성공으로 표시함
- 오류를 고치기 위해 기준 검토 자료를 재작성함
- 오류 응답을 표본 0건의 정상 결과로 처리함
Info
기준 검토 자료 사본으로 원본 경로를 복구하고 API만 다시 확인합니다.
7. 다음 실습
Agent 검토 자료를 화면에 표시하기에서 기존 화면에 API를 연결합니다.