Passo

Alt tür (sub_genre) listesini döner; örneğin Spor türünün altında Dövüş Sporları gibi değerler bulunur. genre verilirse yalnızca o türün alt türleri döner. Ne zaman: kullanıcı bir türün altında neler olduğunu sorduğunda — "müzik altında hangi tarzlar var". Örnek: genre="Müzik" yalnızca müzik alt türlerini döner; genre boş bırakılırsa kataloğun tamamı gelir. Arama hazırlığı için çağırma.

list_sub_genres

search_events'ten gelen TAM bir etkinlik id'sinin bütün ayrıntılarını getirir: açıklama, ayrıntı notu, bilet kategorileri ve kategori fiyatları, etkinlik tipi, mekan adresi ve kanonik Passo adresi (event_url). Ne zaman: kullanıcı listedeki bir etkinliğin ayrıntısını istediğinde — "ikincisinin detayını ver", "bilet kategorileri neler", "nerede tam olarak", "açıklaması ne diyor". Örnek: search_events sonucunda id=1234567 olan etkinlik için event_id=1234567. Id tahmin etme, uydurma ya da SEO adresinden türetme: önce search_events çalışmış ve id'yi döndürmüş olmalıdır.

get_event

Kataloğun tür (genre) listesini döner; şu anda Diğer, Futbol, Hediye Kart, Müze, Müzik, Sahne ve Spor. Ne zaman: yalnızca kullanıcı "hangi türler var", "neler bulabiliyorsun" diye sorduğunda. Arama hazırlığı için çağırma: bir tür değerinden emin değilsen search_events'e genre'ı hiç göndermemek, önce burayı çağırmaktan her zaman daha güvenlidir. Örnek: "neler bulabiliyorsun" → list_genres; "rock konseri var mı" → doğrudan search_events(query="rock").

list_genres

Güncel Passo etkinliklerini bulma, filtreleme, karşılaştırma veya önerme isteklerinin HEPSİNDE bunu kullan. Canlı Passo kataloğunda serbest metin, şehir, tür, alt tür, organizatör, mekan, tarih, fiyat ve sayfalama ile arar; sonucu ayrıca etkinlik kartları olarak gösterir. TEK BAŞINA ÇAĞIR: bir arama için gereken tek araç budur. Aynı turda ondan önce başka bir araç çalışırsa sonuç kartı bazı istemcilerde hiç oluşmaz. ÇAĞRI ÖNCESİ NORMALİZASYON 1. Kısaltmayı tam ada çevir (kulüp, şehir, mekan — ilgili parametrenin açıklamasındaki tablolar). 2. Tire ve virgülü boşluğa çevir: "göztepe-gs" → "Göztepe Galatasaray". 3. Kullanıcının kategori kelimesini genre/sub_genre'in kendi değerine çevir; kelimeyi olduğu gibi gönderme. 4. Göreli tarihi date_preset ile, açık tarihi YYYY-AA-GG ile geçir. SONUÇ BOŞ GELİRSE — sırayla gevşet, her adımda tek değişiklik: search_mode="any" → fuzzy=true → en dar filtreyi kaldır (mekan, sonra alt tür) → tarih aralığını genişlet → şehri kaldır → yalnızca query ile ara. Hepsi boşsa bunu dürüstçe söyle; sessizce alakasız sonuç gösterme. ÖRNEKLER (istek → ilk çağrı): • "gs maçı" → name="Galatasaray" • "göztepe-gs" → name="Göztepe Galatasaray"; boşsa name="Galatasaray" • "bjk maçı rams'ta mı" → name="Beşiktaş", venue_name="RAMS Park" • "bu hafta ank'da tiyatro" → city="Ankara", genre="Sahne", sub_genre="Tiyatro", date_preset="this_week" • "ist'ta jolly joker'da konser" → city="İstanbul", genre="Müzik", venue_name="Jolly Joker" • "zorlu'da bu ay ne var" → venue_name="Zorlu PSM", date_preset="this_month" • "hande yener konser" → query="hande yener konser" (ad farklı olsa da açıklamada geçen sanatçıyı yakalar) • "galatasray" → query="galatasray", fuzzy=true • "16 Ağustos'ta Ankara'da ne var" → city="Ankara", date_from ve date_to = o günün YYYY-AA-GG karşılığı; yılı sohbetteki bugünün tarihinden tamamla • "500 TL altı tiyatro" → genre="Sahne", sub_genre="Tiyatro", max_price=500 • "en ucuz konserler" → genre="Müzik", sort_by="min_price" • "ücretsiz etkinlik" → free_only=true • "biraz daha göster" → aynı filtreler, offset=önceki offset + limit YANIT: {total, offset, limit, count, results[]}. Dönen her etkinlikte id, ad, tarih, bitiş tarihi, şehir, mekan adı ve adresi, tür, alt tür, organizatör, min/max fiyat, afiş görseli ve kanonik Passo adresi (event_url) bulunur. include_details=true ayrıca açıklama, ayrıntı notu ve bilet kategorilerini getirir. offset + count < total ise daha fazla sonuç var; kullanıcı istemedikçe sayfaları kendiliğinden dolaşma, daha fazlasını gösterebileceğini söyle. Ayrıca filtered_out (sorgu terimleriyle hiç eşleşmediği için düşürülen satır) ve products_hidden (gizlenen kombine/seri bilet/hediye kartı) döner. Bu iki sayı eksik veri değil, temizlenmiş gürültüdür — istenirse açılabileceğini söyle. Fiyatlar TL'dir; fiyat alanı boşsa "fiyat bilgisi yok" de, ücretsiz sanma. Sayfanın açılması satın alma ya da rezervasyon değildir.

search_events

Passo mekanlarını döner (mekan id'si ve adı). city verilirse şehir adına göre kısmi eşleşmeyle filtreler. Ne zaman: yalnızca kullanıcı hangi mekanların olduğunu sorduğunda — "Ankara'da hangi salonlar var". Bir mekandaki etkinlikler soruluyorsa buraya değil doğrudan search_events çağrısına git. Örnek: "Ankara'da hangi salonlar var" → list_venues(city="Ankara"); "Zorlu'da ne var" → search_events(venue_name="Zorlu").

list_venues

Güncel katalogda etkinliği olan organizatör adlarını döner. Ne zaman: yalnızca kullanıcı "hangi organizatörler var" diye sorduğunda ya da bir organizatör adının katalogda tam olarak nasıl yazıldığını doğrulaması gerektiğinde. Arama hazırlığı için çağırma: search_events organizer'ı doğrudan alır. Örnek: "hangi organizatörler var" → list_organizers; "X'in etkinlikleri" → doğrudan search_events(organizer="X").

list_organizers

Passo'da şu anda etkinliği olan şehirlerin adlarını döner (İstanbul, Ankara, İzmir gibi düz bir metin listesi). Ne zaman: yalnızca kullanıcı "hangi şehirlerde etkinlik var" diye sorduğunda. Arama hazırlığı için çağırma: search_events şehir adını doğrudan alır ve aynı turda ondan önce başka bir araç çalışırsa arama sonucunun kartı bazı istemcilerde hiç oluşmaz. Örnek: "hangi şehirlerde etkinlik var" → list_cities; "İzmir'de ne var" → doğrudan search_events(city="İzmir").

list_cities