[AI 연동] canonical Slot 조회와 Agent 재호출 구현

[hywznn]

연결

• Refs [AI Run][P0] Agent 요청 Slot 조회·재호출 오케스트레이션 구현 #74
• Supersedes feat(ai): canonical Slot 조회 및 Agent 재호출 구현 #78 — 삭제된 [AI 연동] AI Runtime HTTP 연결과 장애 격리 구현 #56 작업 브랜치를 base로 사용해 재오픈할 수 없어 최신 main 기준으로 복구
• 선행 완료: [AI 연동] AI Runtime HTTP 연결과 장애 격리 구현 #56
• Agent 계약: [Agent Contract][P0] PLAN·ANALYZE와 Slot 요청 계약 ai#6

목표

Agent가 CONTEXT_REQUIRED로 요청한 canonical Slot을 현재 사업장 DB에서 안전하게 조회하고, 같은 분석을 ANALYZE 단계로 이어서 호출합니다.

PLAN 응답
→ requiredFieldKeys 확인
→ Workflow allow-list와 companyId 검증
→ Worker DB 값 조회
→ 새 AiAttempt 내부 기록
→ 최소 ANALYZE JSON으로 Runtime 재호출

주요 변경

• worker_id, stay_expiry_date, contract_end_date 고정 Resolver 추가
• Agent의 임의 SQL·DB column 접근 금지
• 현재 companyId 범위에서만 Worker 조회
• 대상 없음·동명이인·누락 값·금지 field를 안전한 오류로 구분
• requestId와 원래 instruction 유지
• Runtime 호출 전 새 attemptId를 Server 내부에 기록하는 Port 추가
• 자동 DB 보충 최대 2회 제한
• Agent 결과만으로 Task·승인·발송을 자동 실행하지 않음

#56 최소 계약 보존

Runtime에는 다음 값만 전송합니다.

• requestId
• phase
• analysisInput.instruction
• analysisInput.requestedFieldKeys
• analysisInput.workers[].workerRef
• analysisInput.workers[].requestedFields

attemptId, version, deadline, extractedSlots, workflowConstraints는 Server 내부에서만 관리합니다.

검증

• Slot Resolver 단위 테스트
• JPA 사업장 격리·동명이인 통합 테스트
• PLAN → CONTEXT_REQUIRED → ANALYZE 재호출 순서 테스트
• [AI 연동] AI Runtime HTTP 연결과 장애 격리 구현 #56 최소 HTTP JSON 계약 테스트
• ./gradlew clean test
• chaeliki, krestar 리뷰

범위 밖

• AiRun·AiAttempt PostgreSQL 영속화: [AI Run] 비동기 실행 상태·재시도·멱등성 구현 #24
• 발화문 입력·질문·답변 API: [AI Run][P0] 발화문 입력과 누락 Slot 답변 API 구현 #77
• Agent Prompt·Provider 구현
• Task 자동 생성·승인·발송

[chaeliki]

확인했습니다. 슬롯 조회 부분이랑 반복 제한 부분 등 확인했습니다. Worker 바꿔치기 보안 부분도 죠습니다..