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.

Etkileşimli derse başlaDers notlarını oku

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.

Uygulama dosyaları

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

Start hereUygulama 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

Bu adımda kullanılan dosyalar

Start hereUygulama 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.

Bu adımda kullanılan dosyalar

Start hereUygulama 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.

Bu adımda kullanılan dosyalar

Start hereUygulama 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

Diğer dersleri inceleyin