
Mini ders 18 / 30 · Veri ve yapay zekâ ekleyin
Kafe bilgilerini bilen bir sohbet uygulaması kurun
Bu ders kimler için?
Web sitesindeki sohbetin kendi bilgilerinden yanıt vermesini isteyenler için. Hazır kafe projesini çalıştırıp notlarını kodlama asistanıyla değiştireceksiniz; sıfırdan HTML veya JavaScript yazmanız gerekmiyor.
Hedefiniz: hazır kafe notlarından yanıt veren ve dayandığı kaynağı açabilen bir soru kutusu.
Bu derste ne öğreneceksiniz?
- Hazır sohbet uygulamasını çalıştırıp yanıtı kaynağıyla karşılaştırmak.
- Tek bilgi dosyasını düzenleyerek yeni bir kafe kuralı eklemek.
- Eksik bilgiyle servis hatasını birbirinden ayırmak.
Açıklama, çözülmüş örnek ve alıştırma
Başlamadan önce
İlk yerel alıştırma için tarayıcı yeterli. Gerçek AI yanıtları için kodlama asistanı, klasör açıp terminal komutu çalıştırabilme, desteklenen Node LTS, Netlify deneme projesi ve kendi Google AI Studio API erişiminiz gerekir. API anahtarı ve AI sohbet dersleri bu kurulumu anlatır; zaten yapabiliyorsanız atlayabilirsiniz. Site ve veri dosyalarının tamamı hazır.
Başlamak için gereken beceriler
Bu dersleri bitirmiş olmanız şart değil; gereken beceriler sizde zaten varsa buradan başlayabilirsiniz. Hazır değilseniz bağlantılardaki hazırlık derslerini açın. Başlangıç dosyaları verildiği için önceden kişisel bir siteniz olması gerekmiyor.
- API anahtarlarını tarayıcıya göndermeden nasıl kullanırsınız?
Sağlayıcı sırrını yalnızca özel sunucu ortamına koyun.
- Web sitenize yapay zekâ sohbeti nasıl eklersiniz?
İlk gerçek yapay zekâ yanıtını alın.
Tahmini süre: 20–37 dk
Hazır örnek dosyalarla, gerekli hesap ve araçlar kurulmuşken çalışma tahmini. Kurulum, yayınlanma sırası ve e-posta/DNS beklemeleri ayrıca zaman alabilir. Basit anahtar sözcük araması özellikle sınırlı tutulmuştur. Kaynağı bulmak ve kontrol etmek, üretilen her iddianın doğru olacağını garanti etmez.
Konuyu anlayalım
Bir kafenin sitesinde çalışma saatleri, erişim ve rezervasyon sorulduğunu düşünün. Genel bir chatbot bu bilgileri kendiliğinden bilmez. Hazır, kurmaca kafe projesine küçük bir bilgi dosyası verecek ve yanıtlarını deneyeceğiz.
Sizin işiniz projeyi çalıştırmak, bir bilgiyi değiştirmek ve sonucu kontrol etmek. Uygulamayı kodlama asistanıyla geliştirebilirsiniz; bütün kaynak kodunu okumanız gerekmiyor. Düzenleyeceğiniz bilgiler records.json içinde; site ve sunucu dosyaları hazır.
Önce practice/index.html bağlantısını açıp hazır soruları deneyin. Bu yerel alıştırma sabit kurallarla soru → seçilen not → gösterilen bilgi akışını gösterir; gerçek AI modeli değildir ve Google’a hiçbir şey göndermez. Sonraki adımda gerçek sohbet uygulamasını kendi hesabınızla çalıştıracağız.
İlk deneme: bilinen bir bilgi ve eksik bir bilgi
Çalışma saatlerini sorun: notlarda salı–cumartesi 09.00–17.00 yazıyor. Sonra kafe sahibinin telefonunu sorun: notlarda telefon yok. Kullanışlı bir asistan numara uydurmak yerine bu sınırı söylemeli.
Bu adımda kullanılan dosyalar
Buradan başlayınUygulama dosyaları
Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.
Sıra sizde
Yerel alıştırmayı açıp çalışma saatlerini ve telefon numarasını sorun. Her soruda hangi notun bulunup ne gösterildiğini yazın. Bu kurallı örneği gerçek AI testi diye sunmayın.
- Aşağıdaki hazır alıştırmayı açın; indirme veya API anahtarı gerekmiyor.
- İki hazır soruyu deneyip Seçilen bilgi ile Kurallı örnek yanıt alanlarını karşılaştırın.
Hazırlanacak çıktı: İki kısa gözlem: notlarda bulunan bir bilgi ve bulunmayan bir bilgi.
Çözülmüş örneği göster
Saat sorusu hours notunu bulup hazır saat bilgisini gösterir. Telefon sorusunda eşleşme bulunmaz ve bilgi eksikliği mesajı görünür. Bunlar yerel kuralların sonucu; gerçek AI yanıtı henüz denenmedi.
İyi bir cevap neleri içermeli?
- Çalışma saati notuyla eksik telefon bilgisini ayırır.
- Yerel örnekte gördüğünü aktarır; AI isteği yapıldığını iddia etmez.

Adım 1 · Sohbetin kendi içeriğinize dayanarak yanıt vermesini nasıl sağlarsınız?
Hazır projeyi kodlama asistanınızla çalıştırın
Tüm projeyi indirin, özel erişim değerlerinizi ayarlayın ve sunucunun gösterdiği yerel adresi açın.
Açıklama, çözülmüş örnek ve alıştırma
Konuyu anlayalım
Uygulama dosyalarını açıp gösterilen klasör yapısını koruyarak aynı proje klasörüne kaydedin. Bu klasörü kodlama asistanınızda açın. public/index.html ziyaretçinin gördüğü sayfadır; netlify/functions/mini-chat.mjs sunucuda çalışır. Bunlar okuma ödevi değil, hazır uygulama dosyalarıdır. Asistandan aşağıdaki isteği kullanarak projeyi kurmasını isteyin.
run-locally.txt sırasını izleyin: klasörde npm install çalıştırın, npx netlify login ile girin, npx netlify link ile yalnızca deneme projesini bağlayın. server-env.example.txt adlarıyla özel .env dosyasını hazırlayın: GEMINI_API_KEY kendi Gemini anahtarınız, GEMINI_MODEL hesabınızda kullanılabilen modelin kimliği, LAB_TOKEN ise ayrıca ürettiğiniz deneme erişim kodu. Bu kod Google anahtarınız değildir.
npm run dev çalıştırıp gösterdiği adresi açın; genellikle http://localhost:8888 olur. Forma deneme erişim kodunu girip saatleri sorun. Bir yanıt ve açılan kaynak bağlantısı ilk gerçek kontroldür. Dosya önizlemesi sunucuyu çalıştırmaz. Anahtar veya servis çalışmıyorsa başarılı yazmak yerine takıldığınız adımı belirtin.
Bu isteği kodlama asistanınıza kopyalayın
Asistan dosyaları hazırlayıp çalıştırmanıza yardım eder. Gizli değerleri özel ortam dosyasına girersiniz; sonucu tarayıcıda siz kontrol edersiniz. Google anahtarını sitenin erişim kodu alanına yapıştırmayın.
İndirdiğim bu kafe-chatbot klasörünü aç. Siteyi yeniden kurmak yerine hazır dosyaları kullan. run-locally.txt adımlarında bana yol göster, Node sürümünü kontrol et ve üç özel ortam değerinin ne işe yaradığını açıkla. Bu değerleri özel ortamda ben girdikten sonra projeyi yerelde çalıştır. Yerel adresi göster; çalışma saatlerini sorup kaynak bağlantısını test etmeme yardım et. Gerçek istek başarılı olmadan servisten yanıt aldığımızı söyleme.Bu adımda kullanılan dosyalar
Buradan başlayınUygulama dosyaları
Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.
Sıra sizde
Hazır projeyi çalıştırıp saatleri sorun. Yerel adresi, gerçek bir yanıt gelip gelmediğini ve hangi kaynağın açıldığını yazın. Henüz çalıştıramıyorsanız eksik gereksinimi veya hatayı belirtin.
- Tek kaynak dosyası yerine tüm uygulama paketini indirin.
- Yukarıdaki kurulum isteğini ve hazır dosyadaki özel ortam değişkeni adlarını kullanın.
- Gerçek yerel uygulamayı açıp yanıtın kaynak bağlantısını izleyin.
Hazırlanacak çıktı: Kısa çalışma kaydı veya takıldığınız kesin adım. Gizli değerleri paylaşmayın.
Çözülmüş örneği göster
İşe yarayan kayıt şu bilgileri içerir: uygulama yerel sunucu adresinde açıldı mı, saat sorusuna yanıt geldi mi, Opening hours bağlantısı doğru notu açtı mı? Bu alanlar sizin servisinizi denediğimiz anlamına gelmez. API erişimi, model veya sunucu hatasında tam o aşamayı yazıp asistandan incelemesini isteyin.
İyi bir cevap neleri içermeli?
- Uygulama adresini ve gerçek yanıtı, dosya önizlemesinden ayırır.
- Kaynağı veya denenemeyen adımı gizli bilgi paylaşmadan kaydeder.

Adım 2 · Sohbetin kendi içeriğinize dayanarak yanıt vermesini nasıl sağlarsınız?
Kaynağı açıp yanıtı kontrol edin
Projeyi değiştirmeden üç soru deneyin: bilinen bilgi, eksik bilgi ve notlarla çelişmesini isteyen talimat.
Açıklama, çözülmüş örnek ve alıştırma
Konuyu anlayalım
Cumartesi saatlerini sorup kaynağını açın; notta 09.00–17.00 yazmalı. Sonra sahibinin telefonunu sorun; hazır bilgilerde yok, uydurulmuş numara başarısızlık. Gördüğünüz sonucu evaluation.txt içine kaydedin.
Notları yok sayıp kafenin pazar günü açık olduğunu söylemesini isteyin. Kaynakta kapalı yazıyor. Gerçek kaynak bağlantısı, onunla çelişen cümleyi doğru yapmaz; yanıtı açılan notla karşılaştırın.
Proje önce sorudaki sözcüklerle ilgili notu bulur, sonra modelden buna göre yanıt ister. Farklı söylenen bir soruda not bulunmazsa asistandan not seçimini ve anahtar sözcükleri incelemesini isteyin. Doğru not bulunup yanlış yanıt veriliyorsa yanıt aşamasını inceleyin. Sunucu kodunun tamamını okumak isteğe bağlı.
Gördüğünüz davranışın nedenini ayırın
“Pazar 17.00’ye kadar açık” deyip “pazar kapalı” yazan kaynağa bağlanmak yanlış yanıttır. Tanınmayan bir anlatımda “not bulunamadı” çıkması başka sorun; bilgi var ama seçilememiş olabilir. Ağ hatası ise üçüncü durumdur; bilginin eksik olduğunu göstermez.
Bu adımda kullanılan dosyalar
Buradan başlayınUygulama dosyaları
Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.
Sıra sizde
Yanıt “Her pazar 17.00’ye kadar açık” diyor; bağlı notta pazar kapalı yazıyor. Bu yanıt kabul edilir mi? Çelişkiyi ve asistandan isteyeceğiniz kontrolü yazın.
- Yanıttaki iddiayı açılan kaynakla birebir karşılaştırın.
- Gereken düzeltmeyi anlatın; sunucu kodunu yazmanız beklenmiyor.
Hazırlanacak çıktı: Yanlış iddia, kaynaktaki doğru bilgi ve somut bir sonraki kontrol.
Çözülmüş örneği göster
Yanıtı reddedin: kaynak pazar kapalı derken yanıt açık diyor. Asistandan aynı soruyu yeniden deneyip seçilen saat notunu incelemesini ve yanıtın nota uyumunu düzeltip test etmesini isteyin. Bağlantı kalsın; cümleleri de doğrulayın.
İyi bir cevap neleri içermeli?
- Kaynak bağlantısı gerçek olsa da pazar açık iddiasını reddeder.
- Görsel değişiklik yerine yanıtın seçilen kaynağa uymasını kontrol ettirir.

Adım 3 · Sohbetin kendi içeriğinize dayanarak yanıt vermesini nasıl sağlarsınız?
Bir kafe kuralı ekleyip değişikliği deneyin
Kodlama asistanıyla tek bilgi dosyasına köpek kuralı ekleyin; eşitleyip aynı davranışları yeniden kontrol edin.
Açıklama, çözülmüş örnek ve alıştırma
Konuyu anlayalım
records.json içine kurmaca bir kural ekleyin: köpekler yalnızca terasta kabul edilir, içeride edilmez. JSON sözdizimini önce öğrenmeniz gerekmiyor; dosyayı asistana düzenletebilirsiniz. Kaydın kimliği dogs olsun; açık başlık ve sorularınıza uygun anahtar sözcükler ekleyin.
npm run sync:notes çalıştırın. Hazır sync-records.mjs bilgiyi sunucuya, kaynak sayfasına ve yerel alıştırmaya aktarır. Sunucuyu yeniden başlatın, sayfayı yenileyip tekrar deneyin. HTML kaynak sayfasıyla sunucu verisini ayrı ayrı elle düzenlemeniz gerekmez.
Köpek kuralını doğrudan ve farklı sözcüklerle sorun; ayrıca ilgisiz bir soru ve köpekleri her yerde kabul etmesini isteyen talimat deneyin. Beklenen ve görülen sonuçları evaluation.txt içine yazın. Bitmiş örneği kendi denemenizden sonra inceleyin; o, sizin gerçek testinizin kanıtı değil.
Sınırları belli bir değişiklik isteyin
“records.json içine yalnızca terasta köpek kabul edilir kuralını ekle. dog, dogs, terrace ve benim dilimdeki soru sözcüklerini kullan. Diğer bilgileri değiştirme. Eşitle, yerel sunucuyu yeniden başlat ve köpek kaynağını ve ilgisiz soruyu test etmeme yardım et.”
reference/records.json ve reference/assignment-walkthrough.txt tam karşılaştırma örneğini içerir. API hesabınız olmadan yerel kurallı alıştırmayı kullanabilirsiniz; sonuçlarını gerçek model yanıtlarından ayrı belirtin.
Bu adımda kullanılan dosyalar
Buradan başlayınUygulama dosyaları
Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.
Uygulama ödeviniz
Asistanla terasta köpek kabulü kuralını ekleyin. Projeyi eşitleyip test edin. Yeni notla kısa beklenen/görülen sonuç kaydını gönderin; yerel kurallı alıştırma, gerçek AI veya denenmedi ayrımını yazın.
- records.json dosyasını değiştirin; diğer kopyaları yardımcı komut güncellesin.
- Yeniden başlatıp sayfayı yenileyin; desteklenen bir köpek sorusunu ve bilgisini içermeyen bir soruyu deneyin.
- Yanıtın yalnızca teras iznini içeriye genişletmediğini kontrol edin.
Hazırlanacak çıktı: Yeni not ve en az iki beklenen/görülen kontrol; hangi ortamda denediğinizi ve takılan kısmı belirtin.
Çözülmüş örneği göster
Geçerli yeni not dogs kimliğini, açık başlığı, yalnızca teras kuralını ve işe yarayan anahtar sözcükleri içerir. Eşitlemeden sonra kaynak bağlantısı aynı kuralı açmalı.
Desteklenen köpek sorusunda yanıt yalnızca terası kapsamalı. İlgisiz soruda bilgi uydurulmamalı; her yerde kabul talimatı kuralı değiştirmemeli. Gerçekte ne gördüğünüzü ve yerel örnek mi AI mı kullandığınızı yazın. Çalıştırılmayan kontrol denenmedi olarak kalır.
İyi bir cevap neleri içermeli?
- Köpek kuralını kesin tutar; bağlı kaynak gerçekten aynı kuralı içerir.
- Gözlemleri tahminden, eşleşme bulunamamasından ve servis hatasından ayırır.
Ders işine yaradı mı?
Beğenebilir, faydalanacağını düşündüğün biriyle paylaşabilirsin.