에이전트 · 담당 박소연

1. 미션

버튼으로 안 되는 작업을 에이전트로 처리한다. 착수 시점에는 세 축 (이력서 추출 · 도구 호출 · RAG 보조)이었고, 그 뒤 결정 문서로 두 축이 더해져 지금은 다섯이다 — ① 이력서 비정형 → 정형 추출 ② 요약 → 평가 → 추천 3단 체인 기반 자동 서류 심사 ③ 도구 호출 에이전트 ④ RAG 시맨틱 검색 ⑤ AI 면접의 표정 · 음성 진위 판별과 서류 ↔ 발언 대조.

최종 합격 · 불합격 확정은 항상 사람이다. 2026. 09. 10. ADR-0034가 "확정은 사람"의 범위를 그 한 자리로 좁혔다 — 서류 점수와 그에 따른 단계 이동, 면접 점수는 아르가 판정하고, 사람이 손으로 바꾸면 그쪽이 항상 이긴다(단계를 사람이 바꾼 지원자는 이후 자동 판정에서 빠진다). 화면에서는 AI 제안이 앰버 점선, 사람이 확정한 것이 실선으로 계속 구분된다. 이것은 구현 편의가 아니라 채용이라는 도메인에서 되돌릴 수 없는 마지막 판단은 자동화하지 않겠다는 결정이다.

2. 범위

부수효과가 있는 도구는 반드시 확인 단계를 거친다. "김도현을 불합격으로 옮길까요?"를 사람이 승인해야 실행된다. 게이트를 타는 것은 단계 변경 · 면접관 배정 · 일정 제안 · 메일 발송 · 지원서 접수 5종이고, 메일 초안만 빠진다 — 초안은 텍스트만 돌려주고 아무것도 바꾸지 않아서, 그것까지 확인 카드를 물리면 승인 한 번의 의미가 흐려진다. 되돌릴 수 없는 것은 발송이고 그쪽이 게이트를 지난다. 발송에서는 수신자가 지원자 본인으로 고정된다 — 도구가 주소를 인자로 받지 않는다.

3. 확정된 설계 결정

착수 전에 결정이 필요했던 3건. 모두 2026. 08. 25.에 확정됐다.

4. 인터페이스 계약

의존 — 도구가 호출할 대상인 백엔드 코어 API(검색 · 지원자 조회 · 단계 변경 · 평가)와 이력서 원문 접근 경로. 제공 — 지원서 접수 흐름이 호출할 요약 생성 함수, 그리고 에이전트 API.

에이전트 도구는 기존 REST를 서비스 레이어로 재사용한다 — 권한 검사를 우회하는 별도 경로를 만들지 않는다. 에이전트가 뒷문이 되면 역할 기반 접근 제어 전체가 무의미해지기 때문이다.

5. 주간 계획

에이전트는 초기 버전(09. 04.) 범위 밖이다. 아래 W1 · W2는 당시 오너 진수택의 기록이고 — 그 시점까지의 기여는 전환기 백엔드 분담과 UI · 모델 결정(ADR-0009 · 0011)이다 — 박소연은 W2 마지막 날인 09. 04.에 인계받았으므로 W3부터가 이 담당의 몫이다.

6. 품질 기준

전 마일스톤 공통으로 적용한다.

7. 리스크 및 대응

8. 발표 포인트

• 도구 호출 에이전트 설계 — 한 문장이 검색 → 필터 → 상태 변경 → 문서 생성으로 분해되는 과정, 그리고 왜 쓰기 도구에만 확인 단계를 강제했는가.
• 음성 인식 오류가 도구 호출로 전파되는 것을 어떻게 막았는가 — 엔티티 해석 레이어.
• 왜 "버튼으로 되는 일"에 에이전트를 쓰지 않았는가 — 그리고 ADR-0034로 확정 지점을 최종 합불 한 자리로 좁힌 뒤에도 그 원칙이 어디에 남았는가를 자기 언어로.