find_events
ChatGPTCanlı Passo kataloğunda filtrelere göre arar; KART OLUŞTURMAZ. Etkinlik keşfi için search_events yerine bunu kullan. filters içindeki alanlar search_events ile aynı anlamdadır. Yalnızca kullanıcının verdiği koşulları ekle; açık koşulları sessizce kaldırma. query sanatçı/serbest metni, name etkinlik/takım adını arar. Futbol ayrı genre=Futbol değeridir. Tahmini tür ekleme; eklenmişse yalnızca inferred_filters içinde işaretlenen kategori gevşetilebilir. Sayfalama için next_offset kullan, total yerel filtreleme öncesidir. Karşılaştırma için gerektiğinde birden çok veri araması yapabilirsin. Son seçimde event_references içindeki reference değerlerini değiştirmeden show_events'e gönder. Boş veya hatalı arama sonucunu metinde açıkla; gösterim çağrısı yapma. Örnek: filters={"query":"Hande Yener","city":"İstanbul","limit":12}.
get_event
ChatGPTfind_events veya 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 find_events veya search_events çalışmış ve id'yi döndürmüş olmalıdır.
list_cities
ChatGPTPasso'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_genres
ChatGPTKataloğ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_organizers
ChatGPTGü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_sub_genres
ChatGPTAlt 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_venues
ChatGPTPasso 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").
search_events
ChatGPTEski istemciler için uyumluluk aracı. find_events ve show_events birlikte varsa keşifte onları kullan; bu araç kalıcı kart oluşturur. 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. TUR BAŞINA TAM BİR KEZ VE TEK BAŞINA ÇAĞIR: sonuç boş ya da beklenmedik görünse bile aynı kullanıcı mesajı için yeniden çağırma. Her çağrı ChatGPT transkriptinde kalıcı bir kart oluşturabilir; alaka kontrolü ve yalnızca inferred_filters içinde işaretlenen tahmini kategoriyi kaldıran tek yeniden deneme sunucunun içinde yapılır. Ç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 — aynı turda ikinci kez arama yapma. Kullanılan ölçütleri söyle ve kullanıcıya sonraki mesajında hangi kesin koşulu gevşetmek istediğini sor; sessizce alakasız sonuç gösterme. ÖRNEKLER (istek → ilk çağrı): • "gs maçı" → name="Galatasaray" • "göztepe-gs" → name="Göztepe 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" • "Tan Taşçı konserleri" → query="Tan Taşçı", genre="Müzik"; tahmini alt tür yok • "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 next_offset 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. has_more=true ise katalogda başka sayfa var; next_offset ile ilerle. total yerel alaka filtresinden önceki katalog toplamıdır. Kullanıcı istemedikçe sayfaları kendiliğinden dolaşma, daha fazlasını gösterebileceğini söyle. Ayrıca filtered_out (yeterli alaka sinyali taşımadığı için düşürülen satır), products_hidden (gizlenen kombine/seri bilet/hediye kartı), recovery_attempted (sunucu içinde yeniden denendi mi), recovered (bu denemede sonuç bulundu mu), raw_count (ham sayfa boyutu) ve relaxed_filters döner. Bunlar eksik veri değil, tek çağrı içinde temizlenen gürültünün bilgisidir. 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.
show_events
ChatGPTfind_events sonucundaki gerçek etkinlikleri kart olarak gösterir. Önce find_events kullan; event_references[].reference değerlerini değiştirmeden references listesine koy. Ayrı aramalardan referanslar birleştirilebilir. En ilgili 1–8 sonucu seç. Etkinlik nesnesi veya id uydurma. Tüm veri aramaları ve seçim tamamlandıktan sonra kullanıcı mesajı için yalnızca bir kez çağır; her gösterim kalıcı kart oluşturabilir. Referanslar kısa süre geçerlidir; süresi dolarsa find_events ile yenile. Kart dışında etkinlik adı, tarih, şehir, mekan ve fiyatı metinde de yaz.
