NAA Tour API 테스트

현재 구현 계약

NAA 현재 구현spaceContext의 공간 그래프와 scenes 선택 범위 안에서 Survey와 free_text를 반영한 XR 투어 정차 순서와 Action을 생성합니다. 응답은 XROO가 실행할 themeId와 Scene별 Action만 포함하며, 실제 이동 렌더링이나 좌표 기반 waypoint는 반환하지 않습니다.

처리 흐름

1. 요청 크기·인증·JSON 필드와 spaceContext의 Scene·Theme·Link 참조를 검증합니다.
2. scenes를 닫힌 선택 범위로 삼고, 요청 Scene 전체에서 공통으로 사용할 수 있는 Theme을 결정합니다.
3. history를 후보에서 제외하고 초기 또는 현재 Scene 기준으로 도달 가능한 후보와 첫 Scene 정책을 계산합니다.
4. 필요한 Scene 좌표가 모두 유효하면 방향성 Link별 상대 coordinateCost를 계산해 LLM에 제공합니다.
5. LLM이 계획을 반환하면 Domain Validator가 검증합니다. Domain 검증에 실패한 경우에만 같은 후보 범위에서 한 번 Repair한 뒤 다시 검증합니다.
6. LLM 연결·Structured Output 생성 실패는 즉시, Repair 후 Domain 검증 실패는 재검증 뒤 503 PLANNER_UNAVAILABLE로 응답합니다.

요청 필드 명세

Survey 지원 코드

• family: single=1인 가구, couple=부부·커플, child=자녀가 있는 가족, parents=부모님과 함께 거주, etc=기타
• childAges: a=영유아, b=초등학생, c=중·고등학생, d=성인 자녀
• people: 1=1명, 2=2명, 3=3명, 4=4명, 5=5명 이상
• spaces: living=거실, kitchen=주방·다이닝, bedroom=침실, kids=자녀방, bath=욕실, dress=드레스룸·파우더룸, pantry=팬트리·수납공간, utility=다용도실, balcony=발코니·테라스
• lifestyle: famtime=가족이 함께 보내는 공간, kidedu=자녀 학습과 생활, wfh=재택근무·홈오피스, guest=손님 방문과 모임, pet=반려동물과 생활, hobby=취미·운동 공간, chores=편리한 가사 동선, privacy=가족 구성원별 독립 공간, none=특별히 없음

알 수 없는 요청 필드는 현재 호환성을 위해 허용하지만 Planner나 성공 응답으로 전달하지 않습니다. 필드 형태의 기계 판독 기준은 OpenAPI JSON, 실제 초기 예시는 아래 “초기 샘플 불러오기”를 사용하세요.

응답 및 Action 명세

성공 응답은 추가 필드 없이 themeId와 1..6개의 scenes만 포함합니다. 각 Scene은 {sceneId, actions} 형태이며 Action은 실행 순서대로 적용합니다.

{
  "themeId": 12608,
  "scenes": [
    {
      "sceneId": 291441,
      "actions": [
        {"type": "DISPLAY_TEXT", "value": "거실을 살펴봅니다."},
        {"type": "AROUND_360"}
      ]
    }
  ]
}

오류·운영 계약

{
  "code": "INVALID_INPUT",
  "message": "Request validation failed",
  "requestId": "요청 추적 ID",
  "details": [{"field": "scenes", "reason": "오류 원인"}]
}