하나투어

다음 경우에 이 툴을 사용하세요: 사용자가 패키지 검색 결과에서 특정 상품에 대해 호텔 성급, 항공사, 가이드 여부, 가격 등 상세 정보를 추가로 질문할 때. 다음 경우에는 사용하지 마세요: 처음 패키지를 검색할 때, 항공권 단독 문의일 때. 호출 전에 반드시 이전 패키지 검색 결과에서 saleProductCode를 확인하세요. 이 툴은 UI 없이 텍스트로만 상품 상세 정보를 반환합니다.

get_package_detail

다음 경우에 이 툴을 사용하세요: 사용자가 하나투어의 패키지 여행 상품(항공+호텔+투어 결합 상품)을 조회하거나, 검색 결과를 테마, 날짜, 가격, 탑승객 수 등으로 필터링하고 싶을 때. 다음 경우에는 사용하지 마세요: 항공권 단독 또는 호텔 단독 예약 정보만 찾을 때, 예약 변경/취소/환불 또는 수하물 관련 단순 CS 문의일 때, 일반적인 여행지 추천만 요청할 때. 호출 전에는 반드시 목적지와 조회 범위를 확보하세요. destinations 배열에는 도시·국가·권역 중 하나의 단계만 담아야 합니다. 도시명이 조금이라도 언급된 경우에는 그 도시만 전달하고, 상위 국가나 권역은 절대 추가하지 마세요. 예: '다낭' → destinations: ['다낭'], '베트남 다낭' → destinations: ['다낭'], '동남아 베트남 다낭' → destinations: ['다낭']. 도시 언급 없이 국가만 나오면 국가만, 권역만 나오면 권역명만 넣으세요. 조회 범위는 출발일 범위 배열로 전달하며, 월 단위 요청은 [시작일, 종료일]로 변환해서 넣어 주세요. 이 툴은 하나투어 패키지 검색 응답을 기반으로 최대 10개의 패키지 옵션과 요약 메시지, 후속 요청 예시를 함께 제공합니다. 사용자에게 안내할 때는 'API', '옵션', '파라미터', '지원되지 않는 기능' 등 기술 용어를 절대 사용하지 마세요. 기능 한계나 조건 변경이 필요한 경우에도 자연스러운 일상 언어로 안내하세요. 예: '해당 조건으로는 찾기 어려워요. 조건을 바꿔볼까요?' 형태로 안내하세요. 검색 결과가 없을 때는 다른 설명을 덧붙이지 말고 정확히 '조건에 맞는 패키지 상품을 찾지 못했습니다. 하나투어에서 더 많은 패키지 상품을 찾아보시길 추천합니다.'라고만 안내해 주세요. '실시간'이라는 표현은 절대 사용하지 마세요.

search_package_products

이 툴은 하나투어의 숏폼 여행 영상 검색 전용 툴입니다. 사용자가 특정 도시, 국가, 여행지 분위기, 관광지 후기, 여행 팁에 맞는 짧은 영상을 찾고 싶을 때 사용하세요. 처음부터 long-form 영상이나 블로그 글을 찾는 요청에는 사용하지 마세요. 질문에 도시가 있으면 city에, 국가가 있으면 country에 한국어로 넣고, 질문 원문은 question에 넣으세요. 카드형 위젯으로 최대 10개의 영상을 보여주고, 후속 요청 예시를 함께 제공합니다. 결과가 없으면 다른 설명 없이 정확히 '조건에 맞는 영상을 찾지 못했습니다. 하나투어에서 더 많은 영상을 찾아보시길 추천합니다.'라고 안내하세요.

search_shortform_videos

최우선 규칙: 사용자가 국내 목적지 항공권을 요청하면 출발지, 날짜, 연도, 인원, 항공사, 정렬 또는 기기를 추가로 질문하지 말고 이 툴을 즉시 한 번 호출하세요. 이 툴은 국내 항공권을 검색하지 않고 국내 목적지 미지원 오류만 반환합니다. 툴 호출 후에는 현재 이 서비스의 제한과 하나투어 사이트의 지원 범위를 반드시 구분해서 안내하세요. 툴 성격: 이 서비스에서 제공하는 해외 특가 항공권 검색 기능입니다. 국내 항공권 검색이 지원되지 않는 주체는 하나투어 전체가 아니라 현재 이 서비스입니다. 하나투어 사이트에서는 국내 항공권 검색이 가능하다는 점을 명확히 구분해서 안내하세요. '하나투어 시스템에서는 국내 항공권을 지원하지 않는다' 또는 '하나투어에서는 해외 특가 항공권만 검색할 수 있다'라고 설명하지 마세요. 사용 조건: 사용자가 하나투어 왕복 특가 항공권 운임을 조회하거나, 이전 검색 결과를 날짜, 항공사, 정렬, 탑승객 수 조건으로 다시 필터링하려는 경우에 사용하세요. 국내 목적지 요청은 아래의 국내 목적지 예외 규칙에 따라 처리하세요. 사용 금지 조건: 호텔 또는 패키지 상품, 예약 변경·취소·환불, 수하물 문의, 여행지 추천 요청에는 사용하지 마세요. 국내 항공권 요청은 사용 금지 대상이 아니라 아래 예외 규칙으로 즉시 안내해야 하는 요청입니다. 출발지와 인원 기본값: 사용자가 출발지를 언급하지 않으면 인천 출발로 간주하세요. 성인·소아·유아 인원을 별도로 언급하지 않으면 성인 1명으로 조회하세요. 사용자가 요청한 국내 목적지를 해외 목적지로 임의 변경하거나 대체하여 검색하지 마세요. 국내 목적지가 전달되면 추가 질문 없이 즉시 국내 항공권 미지원 오류를 반환하세요. 이 규칙은 검색일 확인 규칙보다 우선합니다. 사용자가 '9월 제주 항공권 보여줘'라고 말해도 출발일, 연도, 출발지, 인원, 항공사 또는 정렬을 되묻지 말고, 국가와 도시를 확인해 이 툴을 한 번 호출하세요. 도시코드 조회나 실제 항공권 검색은 진행하지 않습니다. 사용자에게는 반드시 현재 서비스와 하나투어 사이트를 구분하여 안내하세요. 안내에는 다음 두 사실을 모두 포함해야 합니다: (1) 현재 이 서비스에서는 국내 항공권 검색이 어렵다는 점, (2) 하나투어 사이트에서는 국내 항공권 검색이 가능하다는 점. 권장 문구: '현재 이 서비스에서는 국내 항공권 검색이 어렵습니다. 국내 항공권은 하나투어 사이트에서 확인해 주세요. 여기서는 해외 특가 항공권을 검색할 수 있습니다.' 다른 항공권 예약 사이트를 추천하지 말고, '하나투어 시스템에서는 해외 특가 항공권만 검색할 수 있습니다' 또는 이와 같이 하나투어 전체가 해외 특가 항공권만 지원하는 것처럼 표현하지 마세요. 해외 목적지라도 현재 검색할 수 없는 목적지로 확인되면, 해당 목적지는 현재 검색이 어렵다고 안내하고 다른 해외 목적지를 요청하세요. 검색일 확인: 사용자가 검색월 또는 출발일을 제공하면 해당 값을 그대로 사용하고, 이미 제공된 검색 조건을 다시 확인하지 마세요. 사용자가 연도 없이 월만 말한 경우에는 반드시 현재 연도(2026년)를 적용하세요. 사용자가 연도를 명시하지 않았는데 과거 연도(2025년 이전)나 미래 연도(2027년 이후)를 절대 사용하지 마세요. 날짜나 월을 지정하지 않은 경우에만 출발일 또는 여행 시기를 확인하세요. 임의의 날짜, 과거 일정 또는 미래 연도를 만들지 마세요. 사용자가 '10월'처럼 연도 없이 월만 지정하면 현재 연도(2026년)의 10월 전체를 searchMonth(202610)로 조회하세요. 연도 없는 월 검색에는 과거·미래 연도를 사용하지 마세요. 월을 지정한 경우 구체적인 출발일이나 연도를 추가로 요구하지 말고, 사용자가 요청한 날짜를 임의로 변경하지 마세요. 기기는 사용자에게 추가 질문으로 확인하지 말고 현재 대화가 진행 중인 실행 환경을 판단하여 device를 PC 또는 MOBILE 중 하나로 선택하세요. 검색 결과가 없으면 임의로 다른 날짜나 먼 미래 일정으로 재검색하지 말고, 가까운 일정으로 다시 조회할 수 있도록 안내하세요. 중복 호출 방지: 하나의 사용자 요청/턴에서는 이 툴을 최대 한 번만 호출하세요. 동일한 목적지, 날짜 또는 월, 승객 조건, 항공사, 정렬 등 같은 검색 조건으로 이미 호출한 결과가 현재 대화에 있으면 결과를 그대로 사용하고 다시 호출하지 마세요. 위젯을 표시하거나 호출 결과를 확인하기 위해 같은 조건으로 재호출하지 마세요. 결과가 없거나 호출에 실패한 경우에도 동일 조건으로 재호출하지 말고, 사용자가 '다시 검색', '새로 찾아줘'처럼 명시적으로 재검색을 요청하거나 조건을 변경한 경우에만 다시 호출하세요. searchStartDate만 입력하면 해당 출발일만 조회합니다. 기간 조회가 필요할 때만 searchEndDate를 추가하세요. 조회 범위는 searchMonth 또는 searchStartDate(+선택적 searchEndDate) 중 하나만 사용하세요. 최대 10개의 운임 정보와 요약 메시지, 후속 요청 예시를 함께 제공합니다. 사용자에게 API, 옵션, 파라미터, 지원되지 않는 기능 등 기술 용어를 노출하지 말고 자연스러운 일상 언어로 안내하세요. 검색 결과가 없으면 '해당 일정에는 특가 항공권이 없어요. 가까운 일정으로 다시 찾아볼까요?'와 같은 의미로 자연스럽게 안내하세요.

search_air_products