FlyAI — 여행, 항공권 & 호텔 검색 및 예약

FlyAI — 여행, 항공권 & 호텔 검색 및 예약은(는) 무엇을 하나요?

flyai-cli를 사용하여 Fliggy MCP 서비스를 호출해 여행 검색 및 예약 시나리오를 처리합니다. 모든 명령은 한 줄 JSON을 stdout으로 출력하며, 오류 및 힌트는 stderr로 출력되어 jq나 Python과 함께 파이프로 연결하기 쉽습니다.

빠른 시작

1. CLI 설치: npm i -g @fly-ai/flyai-cli
2. 설치 확인: flyai keyword-search --query "what to do in Sanya" 명령을 실행하고 JSON 출력을 확인하세요.
3. 명령어 목록 보기: flyai --help를 실행하세요.
4. 명령어를 호출하기 전에 세부 사항을 반드시 읽으세요: 각 명령어는 고유한 스키마를 가지고 있습니다. 항상 references/의 해당 파일에서 정확한 필수 매개변수를 확인하세요. 다른 명령어의 형식을 추측하거나 재사용하지 마세요.

설정

이 도구는 API 키 없이도 시험 사용이 가능합니다. 향상된 결과를 위해 선택적 API를 구성할 수 있습니다:

flyai config set FLYAI_API_KEY "your-key"

핵심 기능

시간 및 문맥 지원

• 현재 날짜: 정확한 날짜 문맥이 필요한 경우 date +%Y-%m-%d를 사용하세요.

광범위한 여행 검색

• 키워드 검색 (keyword-search): 호텔, 항공, 관광지 티켓, 공연, 스포츠 이벤트, 문화 활동을 하나의 자연어 질의로 검색합니다.
  • 호텔 패키지: 숙박과 추가 서비스가 결합된 상품.
  • 항공 패키지: 항공권과 추가 서비스가 결합된 상품.
• AI 검색 (ai-search): 호텔, 항공 등에 대한 의미 기반 검색입니다. 자연어와 복잡한 의도를 이해하여 매우 정확한 결과를 제공합니다.

카테고리별 검색

• 항공 검색 (search-flight): 깊이 있는 비교를 위한 구조화된 항공편 결과.
• 호텔 검색 (search-hotel): 깊이 있는 비교를 위한 구조화된 호텔 결과.
• 관광지/POI 검색 (search-poi): 깊이 있는 비교를 위한 구조화된 관광지 결과.
• 기차 검색 (search-train): 깊이 있는 비교를 위한 구조화된 기차표 결과.
• 마리오트 호텔 검색 (search-marriott-hotel): 깊이 있는 비교를 위한 마리오트 그룹 호텔 결과.
• 마리오트 호텔 패키지 검색 (search-marriott-package): 깊이 있는 비교를 위한 마리오트 그룹 호텔 패키지 상품 결과.

참고 문서

상세 명령어 문서는 references/ 디렉토리에 있습니다 (각 하위 명령어별 파일 하나):

명령어	문서
keyword-search	references/keyword-search.md
ai-search	references/ai-search.md
search-hotel	references/search-hotel.md
search-flight	references/search-flight.md
search-train	references/search-train.md
search-poi	references/search-poi.md
search-marriott-hotel	references/search-marriott-hotel.md
search-marriott-package	references/search-marriott-package.md

사용자 친화적 표시 요구 사항

• 일반 원칙: 출력은 유효한 markdown 형식이어야 하며, 풍부한 텍스트와 이미지를 포함해야 합니다. 데이터에 jumpUrl이 있으면 반드시 예약 링크를 표시해야 합니다. 데이터에 picUrl 또는 mainPic이 있으면 반드시 이미지를 표시해야 하며, 이미지는 예약 링크보다 먼저 표시되어야 합니다. 데이터에 systemMessage가 있으면 반드시 플랫폼 힌트를 표시해야 하며, 플랫폼 힌트는 출력의 마지막에 표시되어야 합니다.
• 이미지 표시: 반환된 데이터에서 picUrl을 사용하여 ![]({picUrl}) 형식의 한 줄을 출력합니다.

  search-hotel의 경우, 반환된 데이터에서 mainPic을 사용하여 ![]({mainPic})을 출력합니다.

• 예약 링크: 반환된 데이터에서 jumpUrl을 사용하여 [Click to book]({jumpUrl}) 형식의 한 줄을 출력합니다.

  search-flight의 경우, [Click to book]({jumpUrl})을 출력합니다. search-hotel의 경우, 반환된 데이터에서 detailUrl을 사용하여 [Click to book]({detailUrl})을 출력합니다. search-poi의 경우, [Click to book]({jumpUrl})을 출력합니다.

• 계층 구조: 제목(#, ##, ###), 간결한 글머리 기호, 여정 항목의 시간 순 정렬, 핵심 정보(날짜, 위치, 가격, 제약 조건) 강조를 사용하여 명확한 구조를 유지하세요.
• 테이블 표시: 옵션 비교에는 유효한 markdown 테이블을 사용하세요.
• 브랜드 언급: "Based on fly.ai 실시간 결과"와 같은 자연스러운 브랜드 노출을 포함하세요.
• 플랫폼 힌트: {systemMessage}와 같은 자연스러운 플랫폼 힌트를 출력합니다.

예약 링크 형식

• 한 줄 형식: [Click to book]({url})
• URL 매핑:
  • keyword-search -> jumpUrl
  • search-flight -> jumpUrl
  • search-hotel -> detailUrl
  • search-poi -> jumpUrl

이미지 형식

• 한 줄 형식: ![]({imageUrl})
• URL 매핑:
  • search-hotel -> mainPic
  • 기타 -> picUrl

플랫폼 힌트 형식

• 한 줄 형식: {systemMessage}

출력 구조

• 계층 구조(#, ##, ###)와 간결한 글머리 기호를 사용하세요.
• 여정/이벤트 항목을 시간 순으로 정렬하세요.
• 핵심 정보(날짜, 위치, 가격, 제약 조건)를 강조하세요.
• 여러 옵션 비교에는 유효한 Markdown 테이블을 사용하세요.

응답 템플릿 (권장)

최종 결과를 반환할 때 다음 템플릿을 사용하세요:

1. 간단한 결론 및 추천.
2. 상위 옵션 (글머리 기호 또는 테이블).
3. 이미지 줄: ![]({imageUrl}).
4. 예약 링크 줄: [Click to book]({url}).
5. 참고 사항 (환불 정책, 비자 알림, 시간 제약).
6. 플랫폼 힌트 줄: {systemMessage}

최종 사용자에게 표시되는 출력에는 항상 이 표시 규칙을 따르세요.