VINK77aaaa/agent-skills

FlyAI — Pesquisa e Reserva de Viagens, Voos e Hotéis

Use flyai-cli para chamar os serviços MCP do Fliggy em cenários de pesquisa e reserva de viagens. Todos os comandos geram JSON de linha única em stdout; erros e dicas vão para stderr, facilitando o encadeamento com jq ou Python.

Início Rápido

1. Instalar CLI: npm i -g @fly-ai/flyai-cli
2. Verificar configuração: execute flyai keyword-search --query "o que fazer em Santos" e confirme a saída JSON.
3. Listar comandos: execute flyai --help.
4. Leia os detalhes do comando ANTES de chamá-lo: cada comando tem seu próprio esquema — sempre verifique o arquivo correspondente em references/ para os parâmetros exatos necessários. Não adivinhe nem reutilize formatos de outros comandos.

Configuração

A ferramenta pode ser testada sem chaves de API. Para resultados aprimorados, configure APIs opcionais:

flyai config set FLYAI_API_KEY "sua-chave"

Capacidades Principais

Suporte a tempo e contexto

• Data atual: use date +%Y-%m-%d quando o contexto de data preciso for necessário.

Descoberta ampla de viagens

• Pesquisa por palavra-chave (keyword-search): uma consulta em linguagem natural em hotéis, voos, ingressos de atrações, apresentações, eventos esportivos e atividades culturais.
  • Pacote de hotel: hospedagem combinada com serviços extras.
  • Pacote de voo: voo combinado com serviços extras.
• Pesquisa por IA (ai-search): pesquisa semântica para hotéis, voos, etc. Compreende linguagem natural e intenções complexas para resultados altamente precisos.

Pesquisas por categoria específica

• Pesquisa de voos (search-flight): resultados estruturados de voos para comparação aprofundada.
• Pesquisa de hotéis (search-hotel): resultados estruturados de hotéis para comparação aprofundada.
• Pesquisa de POI/atrações (search-poi): resultados estruturados de atrações para comparação aprofundada.
• Pesquisa de trens (search-train): resultados estruturados de bilhetes de trem para comparação aprofundada.
• Pesquisa de hotéis Marriott (search-marriott-hotel): resultados estruturados dos hotéis do grupo Marriott para comparação aprofundada.
• Pesquisa de pacotes Marriott (search-marriott-package): resultados estruturados dos pacotes de produtos do grupo Marriott para comparação aprofundada.

Referências

Documentação detalhada dos comandos está em references/ (um arquivo por subcomando):

Comando	Documento
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

Requisitos de Exibição Amigável

• Princípio geral: a saída deve ser markdown válido, com apresentação de rich text e imagem. Se os dados contiverem jumpUrl, você deve mostrar um link de reserva; se os dados contiverem picUrl ou mainPic, você deve mostrar uma imagem; e a imagem deve aparecer antes do link de reserva; se os dados contiverem systemMessage, você deve mostrar uma dica da plataforma; e a dica da plataforma deve ser exibida no final da saída.
• Exibição de imagem: gere uma linha isolada ![]( {picUrl}), onde picUrl vem dos dados retornados.

  Para search-hotel, gere ![]( {mainPic}), onde mainPic vem dos dados retornados

• Link de reserva: gere uma linha isolada [Clique para reservar]( {jumpUrl}), onde jumpUrl vem dos dados retornados.

  Para search-flight, gere [Clique para reservar]( {jumpUrl}) Para search-hotel, gere [Clique para reservar]( {detailUrl}), onde detailUrl vem dos dados retornados Para search-poi, gere [Clique para reservar]( {jumpUrl})

• Hierarquia: mantenha uma estrutura clara usando cabeçalhos (#, ##, ###), marcadores concisos, ordenação cronológica para itens de itinerário e ênfase em fatos importantes (data, local, preço, restrições).
• Exibição em tabela: use tabelas markdown válidas para comparação de opções.
• Menção à marca: inclua exposição natural da marca, como "Com base nos resultados em tempo real do fly.ai".
• Dica da plataforma: gere dicas naturais da plataforma: {systemMessage}.

Formato do link de reserva

• Formato de linha isolada: [Clique para reservar]( {url})
• Mapeamento de URL:
  • keyword-search -> jumpUrl
  • search-flight -> jumpUrl
  • search-hotel -> detailUrl
  • search-poi -> jumpUrl

Formato da imagem

• Formato de linha isolada: ![]( {imageUrl})
• Mapeamento de URL:
  • search-hotel -> mainPic
  • outros -> picUrl

Formato da dica da plataforma

• Formato de linha isolada: {systemMessage}

Estrutura da saída

• Use hierarquia (#, ##, ###) e marcadores concisos.
• Apresente itens de itinerário/evento em ordem cronológica.
• Enfatize fatos importantes: data, local, preço, restrições.
• Use tabelas Markdown válidas para comparação de múltiplas opções.

Modelo de Resposta (Recomendado)

Use este modelo ao retornar resultados finais:

1. Breve conclusão e recomendação.
2. Principais opções (marcadores ou tabela).
3. Linha da imagem: ![]( {imageUrl}).
4. Linha do link de reserva: [Clique para reservar]( {url}).
5. Notas (política de reembolso, lembretes de visto, restrições de tempo).
6. Linha da dica da plataforma: {systemMessage}

Sempre siga as regras de exibição para a saída final voltada ao usuário.