자연어 명령을 안전한 해도 제어와 감사 이력으로 바꾸기

좌표를 모르는 운용자의 요청

가상의 해양 운용실에 “부산항 입출항 통제 구역을 보여 달라”는 요청이 들어왔습니다. 운용자는 구역 이름은 알지만 내부 ID와 위도·경도, 권장 축척은 알지 못합니다. 자연어를 곧바로 지도 동작으로 보내면 잘못 분류된 조회나 설정 변경까지 실행될 수 있습니다.

오늘은 해양 운용자가 되어 다음 질문에 답합니다.

구역 ID와 좌표를 몰라도 자연어 명령을 안전하게 실행하고, 허용·거부 근거와 이력을 남기려면 무엇이 필요할까요?

이번 미션의 판단 기준

• 함께 보는 관점 — 운용 관점은 구역 이름만으로 지도를 빠르게 표시하려 하고, 안전·감사 관점은 허용 범위를 벗어난 요청을 멈추면서 허용과 거부의 근거를 모두 보존합니다.
• 판단 제약 — 현재 에이전트는 UI_CONTROL만 실행하고 DATA_QUERY는 거부합니다. 배치 8행과 에이전트 런타임 이벤트는 서로 다른 실행 계약이며 함께 섞어 해석하지 않습니다.
• 완료 신호 — 부산항 요청을 TZ-008의 WGS84 좌표 JSON으로 바꾸고, 조회 질문은 실행 전에 차단한 뒤, 두 결과를 같은 사용자 기준의 감사 이력에서 다시 확인합니다.

워크숍 목표

• 자연어의 구역 이름이 내부 ID와 WGS84 좌표로 바뀌는 과정을 설명합니다.
• 표시 제어 명령과 데이터 조회 질문을 실행 전에 구분합니다.
• 허용된 명령은 구조화 JSON으로 만들고, 거부된 요청도 감사 이벤트로 남깁니다.
• 배치 기준값과 에이전트 런타임 이벤트의 실행 계약을 구분합니다.
• 데이터셋·그래프·대시보드의 근거와 현재 연결 한계를 함께 설명합니다.

일곱 번의 판단

flowchart LR
    accTitle: 자연어 해도 제어의 일곱 판단
    accDescr: 운용자의 요청을 정하고 구역과 좌표를 연결한 뒤 허용과 거부 경로를 실행하며, 배치와 런타임 이력 및 제어 경계를 점검하고 안전한 흐름을 설명합니다.
    request["1. 요청 정하기"] --> zone["2. 구역·좌표 연결"]
    zone --> gate["3. 허용 범위 판단"]
    gate --> run["4. 두 경로 실행"]
    run --> trace["5. 두 이력 추적"]
    trace --> check["6. 경계 퀴즈"]
    check --> explain["7. 제어 흐름 설명"]

각 챕터는 질문 → 이유 → 행동 → 관찰 → 해석 → 다음 판단 순서로 진행합니다. 전체 자산 목록과 구현 세부는 깊이 보기에 두었으므로 처음에는 핵심 경로만 따라가도 됩니다.

사전 준비

• D.Hub 포털에 접근할 수 있는 분석가 또는 엔지니어 계정 (편집자 이상)
• 약 37 KB의 시나리오 zip 파일을 받을 다운로드 여유
• 권장 소요 시간 90분

터미널·Python·dhub2-examples 클론은 필요하지 않습니다. 시나리오 가져오기가 처음이라면 완성된 실습 시나리오 가져와 살펴보기를 먼저 확인하세요.