
Mini ders · Türkçe
Sohbetin kendi içeriğinize dayanarak yanıt vermesini nasıl sağlarsınız?
Hazır kafe projesini kodlama asistanıyla çalıştırın; kendi bilgilerinizi ekleyip yanıtları kaynaklarıyla kontrol edin.
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.
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.
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.
Neler öğreneceksin?
- 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.
Adım 1
Kafe bilgilerini bilen bir sohbet uygulaması kurun
Hedefiniz: hazır kafe notlarından yanıt veren ve dayandığı kaynağı açabilen bir soru kutusu.
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
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Adım 2
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.
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.Google AI Studio: API anahtarı oluşturma ve yönetme · Netlify: yerel geliştirme ve proje bağlama
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.
Cevabını ders asistanıyla değerlendir
Çö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.
- Uygulama adresini ve gerçek yanıtı, dosya önizlemesinden ayırır.
- Kaynağı veya denenemeyen adımı gizli bilgi paylaşmadan kaydeder.
Bu adımda kullanılan dosyalar
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Adım 3
Kaynağı açıp yanıtı kontrol edin
Projeyi değiştirmeden üç soru deneyin: bilinen bilgi, eksik bilgi ve notlarla çelişmesini isteyen talimat.
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.
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.
Cevabını ders asistanıyla değerlendir
Çö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.
- 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.
Bu adımda kullanılan dosyalar
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Adım 4
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.
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.
Uygulama ödeviniz
Başlangıç malzemeleri
Başlangıç dosyaları ve deneme içerikleri hazır. Gerçek servis doğrulaması için Başlamadan önce bölümünde belirtilen kendi hesabınız, gelen kutunuz veya alan adınız gerekir. Bunlar olmadan dosyaları inceleyebilirsiniz; gerçekten denemediğiniz canlı adımı denenmedi diye kaydedin.
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.
Cevabını ders asistanıyla değerlendir
Çö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.
- 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.
Bu adımda kullanılan dosyalar
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Ders işine yaradı mı?
Beğenebilir, faydalanacağını düşündüğün biriyle paylaşabilirsin.
Öğrenmeye devam edin
- İlk kişisel web sitenizi nasıl kurarsınız?
- Web sitenizi GitHub üzerinden nasıl yayımlarsınız?
- Kendi alan adınızı web sitenize nasıl bağlarsınız?
- Kendi alan adınızla e-posta nasıl kurulur
- Web sitenizi telefonda rahat kullanılır hale nasıl getirirsiniz?
- Web sitenizdeki görsellerin daha hızlı yüklenmesini nasıl sağlarsınız?
- Sitenize gelen geri bildirimler gelen kutunuza nasıl ulaşır
- Sitenize e-posta aboneliği nasıl eklenir
- Web sitenizden otomatik e-posta nasıl gönderirsiniz?
- Formdan gelen bilgileri veritabanına nasıl kaydedersiniz?
- İnsanların web sitenizde oturum açmasını nasıl sağlarsınız?
- Bir sayfayı nasıl yalnızca izin verilen kişilere açarsınız?
- Kullanıcıların profil bilgilerini düzenlemesini nasıl sağlarsınız?
- Kullanıcıların görsel yüklemesini nasıl sağlarsınız?
- API anahtarlarını tarayıcıya göndermeden nasıl kullanırsınız?
- Başka bir API’den gelen veriyi web sitenizde nasıl gösterirsiniz?
- Web sitenize yapay zekâ sohbeti nasıl eklersiniz?
- Web sitenize nasıl blog eklersiniz?
- Web sitenize nasıl arama eklersiniz?
- Web sitenize nasıl başka bir dil eklersiniz?
- Google’ın sitenizi bulmasına nasıl yardımcı olursunuz
- Bağlantı paylaşırken sitenizin önizlemesi nasıl düzeltilir
- Sitenizde ziyaretler ve yararlı işlemler nasıl ölçülür
- Ziyaretçilerin randevu almasını nasıl sağlarsınız?
- Web sitenizde ödeme nasıl alınır
- Yayımlamadan önce site değişiklikleri nasıl önizlenir
- Hatalı yayımlanan web sitenizi önceki çalışan sürüme nasıl döndürürsünüz?
- Web sitenizin verilerini nasıl yedekler ve geri yüklersiniz?
- Canlı sitenizdeki hatalar nasıl bulunur ve düzeltilir