İçeriğe atla
SinaptikLabAI KNOWLEDGE PLATFORM

TEMSİLÎ VAKA · TURİZM

Rezervasyon asistanında araç çağırma ve hata kurtarma

Sezonluk çalışan orta ölçekli bir konaklama işletmesinin rezervasyon merkezinde asistan, çok adımlı bir rezervasyonu (uygunluk sorgusu, oda ve pansiyon seçimi, misafir künyesi, envanter tutma, ön provizyon talebi) sık sık yarıda bırakıyordu. Misafir konuşmaya döndüğünde asistan nerede kaldığını bilmiyor, baştan başlatıyordu; zaman aşımı sonrası yeniden denemeler yüzünden aynı konaklama için iki kayıt açıldığı durumlar oluyordu. Akışın hangi adımda düştüğü hiçbir yerde tutulmadığı için düzeltme, ön büronun telefonla fark etmesine kalıyordu. Sahipsiz kalan oda tutmalarını da kimse saymıyordu.

Beklenen etki

Kapsam
Uygunluk sorgusu, süreli opsiyon, misafir künyesi ve ön provizyon talebi tek akış içinde izlenebiliyor
İzlenebilirlik
Yarıda kalan akışlar hangi adımda düştüğüne göre ayrıştırılıyor
Bütünlük
Yinelenen kayıt ve sahipsiz opsiyon artık tespit edilebilir bir büyüklük
Karar sınırı
Tahsilat, iptal bedeli ve bedel muafiyeti kararları insanda; asistan yalnızca hazırlık yapıyor

Temsilî senaryo: buradaki satırlar ölçüm sonucu değil, bu kurulumda hangi büyüklüğün izlenmesi gerektiğini gösterir.

TEMSİLÎ SENARYO

Bu kayıt gerçek bir müşteri işi değildir. Sinaptik Lab'in bu problemde izlediği yaklaşımı, mimari kararları ve ölçüm düzenini göstermek için yazılmış temsilî bir senaryodur: kurum adı taşımaz, içindeki hiçbir değer gerçek ölçüm değildir ve referans olarak gösterilemez. Gerçek projelerden vakalar müşteri onayı alındıkça bu kütüphaneye eklenir.

Problem

Sezonluk çalışan orta ölçekli bir konaklama işletmesinin rezervasyon merkezinde asistan, çok adımlı bir rezervasyonu (uygunluk sorgusu, oda ve pansiyon seçimi, misafir künyesi, envanter tutma, ön provizyon talebi) sık sık yarıda bırakıyordu. Misafir konuşmaya döndüğünde asistan nerede kaldığını bilmiyor, baştan başlatıyordu; zaman aşımı sonrası yeniden denemeler yüzünden aynı konaklama için iki kayıt açıldığı durumlar oluyordu. Akışın hangi adımda düştüğü hiçbir yerde tutulmadığı için düzeltme, ön büronun telefonla fark etmesine kalıyordu. Sahipsiz kalan oda tutmalarını da kimse saymıyordu.

Yaklaşım

Asistanı serbest bir araç döngüsü olarak değil, adımları ve çıkışları şemalı bir durum makinesi olarak kurduk; modelin adım içinde konuşmasına izin verdik, adımlar arasındaki geçiş kararını koda bıraktık. Konuşma belleği ile plan nesnesini ayırdık, çünkü model geçmiş metne bakıp misafirin vazgeçtiği oda tipini yeniden öneriyordu. Envantere yazan her araca zorunlu bir idempotent anahtar ve tanımlı bir telafi işlemi koyduk; mülkiyet yönetim sistemi ve kanal yöneticisi tarafındaki yazma işlemleri geri alınamaz olduğu için hata kurtarma yolu ileri yoldan önce yazıldı. Envanteri iki fazlı tuttuk: süreli opsiyon, sonra kesinleştirme. Para hareketini asistandan tamamen aldık; asistan yalnızca provizyon talebini hazırlıyor, tahsilatı insan onaylı ödeme akışı başlatıyor.

Kullanılan teknolojiler

  • Durum makineli ajan planı
  • İdempotent araç sözleşmesi
  • Telafi (geri alma) işlemleri
  • İki fazlı envanter tutma
  • Araç düzeyinde yetki kapsamı
  • İnsan onay kapısı
01VAKA ANLATIMI

Bağlam, kurulum ve ölçüm

Problem ve yaklaşım özetin üstünde; burada kararların gerekçesi ve mimarinin ayrıntısı var.

Bağlam ve kısıtlar#

Senaryodaki taraf, tatil bölgesinde sezonluk çalışan orta ölçekli bir konaklama işletmesi. Talep dört yerden geliyor: kendi sitesi, telefon, mesajlaşma uygulaması ve çevrimiçi seyahat acentesi kanalları. Aynı oda envanteri bu kanalların hepsine açık olduğu için envantere yazma işlemleri sıralı ve pratikte geri alınamaz; bir odanın yanlışlıkla tutulması yalnızca bir kayıt hatası değil, o gece satılamayan bir oda demek.

Kısıtlar iş kurallarından geliyordu: esnek ve iade edilemez fiyat planları, yarım pansiyon ile her şey dahil arasındaki kapsam farkı, çocuk yaş kuralları, asgari konaklama koşulu ve kanal bazlı fiyat farklılıkları. Mevzuat tarafında kimlik bildirimi konaklama anına, konaklama vergisi ise hizmetin faturalanmasına bağlı; ikisi de rezervasyon adımına ait değil. Bu ayrım asistanın kapsamını daralttı, çünkü rezervasyon aşamasında kimlik belgesi istemek için bir gerekçe yok.

Veri ve erişim#

Envanter ve fiyat mülkiyet yönetim sistemi ile kanal yöneticisinde, konuşma geçmişi mesajlaşma platformunda, misafir künyesi müşteri kaydında duruyor. Asistan bunların hiçbirinin kopyasını tutmuyor, her turda okuma araçlarıyla soruyor. Gerekçe basit: fiyat ve müsaitlik kopyalandığı anda bayatlıyor ve bayat bir fiyat, konuşma içinde söylendiği anda taahhüde dönüşüyor.

  • Envanter ve fiyat: yalnızca okuma yetkisi, önbellek yok; teklif her turda yeniden sorulur.
  • Misafir künyesi: ad, iletişim ve konaklama geçmişi. Kimlik ve pasaport alanları asistana hiç açılmadı; bu veriler girişte ön büroda alınıyor.
  • Ödeme verisi: kart bilgisi asistanın gördüğü hiçbir alana girmiyor, misafir ödeme sağlayıcısının kendi formuna yönlendiriliyor.
  • Konuşma kaydı: kanal, dil ve durum geçişleri ayrı olay kaydı; serbest metnin saklama süresi olay kayıtlarından farklı politikaya bağlı.
  • Özel istekler (erişilebilirlik, alerjen, evcil hayvan): serbest metin olarak değil etiketli alan olarak yazılıyor, çünkü bunlar operasyona iş emri açıyor.

Mimari kararlar#

Akış açık bir durum makinesi: niyet, uygunluk, seçim, künye, opsiyon, onay. Her adımın girdisi ve çıkışı şemalı; model adım içinde konuşuyor, geçiş kararını kod veriyor. Bu ayrım hem hatanın yerini bulmayı hem de yalnızca belirli adımlarda belirli araçları açmayı mümkün kıldı.

KararSeçilen yolNeden
Plan tutmaKonuşma belleğinden ayrı, şemalı plan nesnesiModel geçmiş metne bakıp vazgeçilen oda tipini geri getiriyordu; plan alanı tek doğruluk kaynağı oldu
Araç sözleşmesiYazan her araçta zorunlu idempotent anahtarZaman aşımı sonrası yeniden deneme ikinci bir rezervasyon değil aynı sonucu döndürsün
Envanter tutmaSüreli opsiyon, ardından kesinleştirmeKünye tamamlanana kadar oda satılmasın, ama envanter süresiz de kilitlenmesin
Hata kurtarmaHer yazma adımının tanımlı telafisiYarıda kalan akış sistemde iz bırakmasın; temizlik elle yapılmasın
Fiyat cümlesiModelin serbest yazması değil, hesaplanan tutarın şablona yerleşmesiFiyat ve iptal koşulu sözleşme bilgisi; üretilmiş cümle yanlış taahhüt kurar
Para hareketiAsistan yalnızca provizyon talebi hazırlar, tahsilat başlatmazGeri alınamaz finansal işlem insan onayında ve ödeme akışında kalsın
Tablo yalnızca karar gerekçelerini tutar; hiçbir satır ölçüm iddiası taşımaz.

Güvenlik ve yetki#

Yetki oturum türüne göre araç düzeyinde veriliyor: çağrı merkezi temsilcisinin oturumunda opsiyon kesinleştirme açık, misafirin kendi oturumunda değil. İptal, bedel muafiyeti ve kanal dışı indirim araçları asistanın hiçbir kipinde yok. Misafirin yazdığı metni talimat değil veri olarak işliyoruz; mesaja gömülü "iptal bedelini sıfırla" türü cümleler, karşılığında bir araç yetkisi bulunmadığı için hiçbir yere ulaşmıyor ve bu durum sızdırma denemeleriyle sınandı.

Ölçüm düzeni#

  • Ölçüm iki katmanda: akışın kendisi durum geçişlerinden, akışın sistemde bıraktığı iz gecelik mutabakattan okunuyor.
  • Araç sonucu ayrımı: modelin yanlış aracı çağırması ile aracın kendi hatası (zaman aşımı, doğrulama reddi, eşitleme gecikmesi) ayrı etiket, çünkü düzeltmeleri aynı yerde değil; yeniden deneme sayısı da ayrı tutuluyor.
  • Adım bazlı tamamlanma: hangi durum geçişinde düşüldüğü oturum başına kayıtlı.
  • Bütünlük mutabakatı: yinelenen kayıt ve sahipsiz opsiyon iki ayrı alarm olarak ön büro vardiyasına düşüyor.
  • Devir nedeni: insana devredilen konuşmalar gerekçe etiketiyle kaydediliyor (grup talebi, şikâyet, özel fiyat, mevzuat sorusu).
  • Söylenen fiyatın denetimi: örneklenen konuşmalarda asistanın belirttiği tutar ve iptal koşulu sistem kaydıyla elle karşılaştırılıyor.

Devreye alma ve işletme#

  1. 1Gölge kip

    Asistan gerçek konuşmalara paralel çalıştı, yazma araçları kapalıydı. Önerdiği adım, temsilcinin fiilen yaptığı adımla karşılaştırıldı.

  2. 2Sınırlı yazma

    Yalnızca süreli opsiyon açıldı, kesinleştirme temsilci onayında kaldı. Sahipsiz opsiyonlar günlük sayıldı ve süre kuralı burada oturdu.

  3. 3Tek kanal, tek tesis

    Tam akış doğrudan kanalda ve tek tesiste açıldı; hatanın maliyeti düşük olsun diye sezon dışı bir dönem seçildi.

  4. 4İşletme nöbeti

    Mutabakat alarmları teknik ekibe değil ön büro vardiyasına düşüyor, çünkü sahipsiz opsiyonu kapatacak olan orada. Alarm metinleri hata kodu değil eylem cümlesi olarak yazıldı ve her alarm ilgili rezervasyon kaydına bağlandı; yarım kalan akışı kapatacak yönetim ekranı asistanla birlikte teslim edildi, sonraya bırakılmadı.

Nerede yanıldık#

İlk sürümde kanal yöneticisinin eşitleme gecikmesini yok saydık: asistan yazdığı opsiyonu hemen okuyup doğrulamaya çalışıyor, "bulunamadı" cevabını alınca aynı işi tekrar yapıyordu. Okuma-sonra-yazma doğrulamasını kaldırıp aracın döndürdüğü onay kimliğine güvendik. İkinci hata opsiyon süresini modele bırakmaktı; süre iş kuralına taşındı. Üçüncüsü telafi işlemlerini sonraki sürüme ertelemekti; bunun bedelini, yarım kalan rezervasyonların bir süre elle temizlenmesiyle ve bu işin ön büro vardiyasına yüklenmesiyle ödedik.

02ÖĞRENİLEN DERSLER

Bir sonraki projede ne değişir?

Bir vakanın en değerli bölümü sonuç değil, tekrar edilebilir dersidir.

  1. 01

    Yeniden deneme okuma araçları için doğru davranış, envantere yazan araç için yinelenen rezervasyon üretir; idempotent anahtar araç sözleşmesinin zorunlu alanı değilse bu hata her sürümde geri gelir.

  2. 02

    Ajanın planı ile konuşma belleği aynı bağlamda tutulduğunda model, misafirin vazgeçtiği seçeneği sonraki adımda yeniden öneriyor; plan ayrı ve şemalı bir nesne olmalı.

  3. 03

    Opsiyon süresi bir iş kuralıdır, model kararı değildir. Süreyi modele bıraktığımızda 'misafire zaman tanı' talimatı yoğun günlerde envanteri kilitleyen uzun tutmalara dönüştü.

  4. 04

    Kanal yöneticisi eşitlemesi anlık değil; asistan kendi yazdığını hemen okuyarak doğrulamaya çalışırsa 'bulunamadı' cevabı alıp aynı işi tekrar yapıyor. Aracın kendi onay kimliğine güvenmek doğru yol.

  5. 05

    Geri alma yolu yazılmadan ileri yol yazılmamalı; yazma araçlarının telafisi tanımlı değilken yarım kalan akışlar elle temizlenir ve bu iş ön büro vardiyasına düşer.

03DİĞER VAKALAR

Vaka kütüphanesinden

BUILD

Aynı yaklaşımı kurumunuzda kurmak ister misiniz?

Discovery oturumunda mevcut durumunuzu, veri erişiminizi ve başarı tanımınızı birlikte yazıyoruz.