k-schoollunch-menu

나이스(NEIS) 교육정보 개방 포털의 학교기본정보 · 급식식단정보 를 k-skill-proxy 가 중계하는 HTTP API로 조회한다. 에이전트는 아래처럼 base 를 정한다. 다음이 없으면 사용자에게 짧게 묻는다. 교육청 표현이 애매해 ambiguous_education_office 가 나오면, 응답의 candidate_codes 를 보여 주고 더 구체적인 이름(예: 경상북도교육청 vs 경상남도교육청 )을 받는다. schoolInfo 본문에서 row 가 여러 개 면 사용자에게 **학교명·주소( ORG_RDNMA 등)**를 보여 주고 하나를 고르게 한다. 한 건뿐이면 그 row의 ATPT_OFCDC_SC_CODE , SD_SCHUL_CODE 를 다음 단계에 쓴다. - 사용자는 시도교육청 이름 (자연어)과 학교 이름 , 날짜 만 말하면 된다. - 에이전트는 먼저 /v1/neis/school-search 로 학교를 찾고, 응답의 SD_SCHUL_CODE · ATPT_OFCDC_SC_CODE 로 /v1/neis/school-meal 을 호출한다. - 인증키( KEDU_INFO_KEY )는 프록시 서버에만 두고, 클라이언트는 키 없이 프록시 URL만 호출한다. - "서울특별시교육청 미래초등학교 오늘 급식 뭐야?" - "○○초 급식 식단 알려줘" - "이번 주 화요일 중학교 급식 메뉴" - "급식 메뉴 조회해줘" (교육청·학교·날짜 확인 후 진행) - 인터넷 연결 - curl 사용 가능 환경 - k-skill-proxy 에 KEDU_INFO_KEY 가 설정된 배포(기본 hosted 또는 self-host)에 접근 가능할 것 - 사용자 측 필수 시크릿 없음. - KSKILL_PROXY_BASE_URL — self-host·별도 프록시를 쓸 때만 설정. 비우면 기본 hosted 를 사용한다. - KEDU_INFO_KEY 는 프록시 운영 서버 환경에만 둔다. - 교육청 — 자연어 허용 (예: 서울특별시교육청 , 서울 , 경기도교육청 ).