
Mini ders · Türkçe
Web sitenize yapay zekâ sohbeti nasıl eklersiniz?
Hazır özel sohbet botunu kodlama asistanıyla çalıştırın; takip sorusunun konuşmayı kullanıp kullanmadığını ve başarısız isteği atlatıp atlatmadığını sınayın.
Bu ders kimler için?
Küçük web sitesine konuşabilen asistan ekleyenler için. Proje verilir; ileti işleme kodu yazmak yerine davranışını yönlendirip sınarsınız.
Başlamadan önce
Kendi Google AI Studio API erişiminiz ve sağlanan ayrı sunucu fonksiyonu projesi gerekir. Gerekirse API anahtarı dersi özel kurulumu açıklar. Önce kullanılabilir model erişimini, kullanım sınırlarını ve olası ücretleri doğrulayın. Yapay test mesajları ve sahibinin elinde tuttuğu deneme kodunu kullanın; herkese açık kullanımdan önce kimlik doğrulama, kalıcı kullanım sınırları ve bütçe takibi gerekir.
Tahmini süre: 20–32 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. Gerçek istekler ayarlanan hesabınızın kotasını kullanır. Herkese açık giriş sistemi, kalıcı sınırlar ve gizlilik incelemesi ayrı işlerdir.
Neler öğreneceksin?
- İlk gerçek yapay zekâ yanıtını alın.
- Önceki iletiye bağlı takip sorusunu kontrol edin.
- Başarısız iletiyi yeniden denemek için koruyun.
Adım 1
Sınamak için küçük bir konuşma seçin
İkinci ileti birinciye bağlı olmalıdır.
Hazır sohbet botu projesini asistanınızla açın. Konuşmanın devam ettirilip ettirilmediğini değerlendirmek için basit, yapay bir konu ve önceki yanıta atıfta bulunan takip sorusu seçin.
Tek başına iyi bir yanıt, konuşmanın çalıştığını kanıtlamaz. İki iletiyi ve aralarındaki ilişkiyi incelemeyi planlayın.
Somut bir örnek
Kısa bir açıklama isteyin, ardından aynı açıklamanın daha basit sürümünü talep edin.
Verilen sohbet botu projesini kullan ve run-locally.txt içindeki özel kurulumda yol göster. Kimlik bilgileri ve model talimatları sunucuda kalsın. İlk soruyu sormama, aynı konuda takip sorusu yöneltmeme ve yazdığım iletiyi kaybetmeden başarısız isteği sınamama yardım et. Siteyi yeniden kurma veya yalnızca ilk yanıttan konuşmanın çalıştığını iddia etme.Bu adımda kullanılan dosyalar
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Konuşmayı sürdürebilen bir yardımcı ekleyin
İşe yarayan sohbet, öğrencinin son yazdığını ve hangi konuya devam ettiğini okumalıdır.
Bu derste küçük bir web sitesi öğreticisi hazırlıyoruz. Ziyaretçi soru sorar, yanıtı okur ve devam sorusu sorar. Tarayıcı her yeni mesajda önceki tamamlanmış konuşmayı gönderir; sunucu Gemini’yi çağırıp modelin gerçekten ürettiği yanıtı verir.
Model önceki HTTP isteğinizi kendiliğinden hatırlamaz. Bu sekmenin belleğinde kısa geçmiş tutarız. Sayfa yenilenince silinir; denemeyi sınırlı tutmak için dört başarılı soru-cevaptan sonra dururuz.
Çözülmüş örnek
Önce “What is DNS?” (DNS nedir?), ardından “Explain that using a street-address example.” (bunu sokak adresi örneğiyle açıkla) diye sorun. İkinci istekte “bunu” sözcüğünün neyi anlattığı anlaşılabilsin diye önceki soru ve yanıt da gerekir.
Extra implementation exercise
API çağrısı başarılı olsa bile ikinci yanıt neden konudan kopuk gelebilir?
Çözülmüş örneği göster
Uygulama yalnızca genel bir yönerge göndermiş veya geçmişi atlamış olabilir. Giden messages dizisini inceleyin; önceki başarılı soru-cevapların ve yeni sorunun sırayla bulunduğunu doğrulayın.
- Önceki mesajların gönderilip gönderilmediğine bakar.
- Kullanıcının en son mesajının korunup korunmadığını kontrol eder.
Sık yapılan hata
Birbiriyle ilgisiz hazır yanıtları konuşma diye sunmak.
Adım 2
Verilen sohbet botunu başlatın
Özel sunucu yapılandırmasını asistan yapsın.
Asistanla run-locally.txt dosyasını izleyin. Hesabı/modeli ve kullanım koşullarını doğrulayın, server-env.example.txt içindeki özel sunucu değerlerini ayarlayın; ardından yerel proxy’nin yazdırdığı uygulama adresini açın. Forma sağlayıcı anahtarını asla değil, ayrı deneme kodunu girin. Bu kurulum zorunlu, sunucu kodunu yazmak isteğe bağlıdır.
Sağlayıcı anahtarı ve yöneten talimatlar sunucuda kalır. Hesabınız/modeliniz kullanılamıyorsa sayfayı sahte yanıtla doldurmak yerine tam olarak o aşamayı bildirin.
Somut bir örnek
Web sitesi alanı, ziyaretçinin sizin özel sağlayıcı kimlik bilgilerinizi seçmesine izin vermemelidir.
Gemini generateContent API · Gemini API anahtarları · Gemini: güncel model ID’leri ve özellikleri · Node.js: desteklenen sürümlerin durumu
Sıra sizde
Çalışan uygulama gerçek ilk yanıtı üretti mi, yoksa kurulum nerede durdu?
Cevabını ders asistanıyla değerlendir
Çözülmüş örneği göster
Örnek ilk çağrı kaydı: “Eksiksiz uygulama proxy adresinde açıldı. Ayrı deneme kodunu girdim ve ayarlı sağlayıcı modelinden açıklama aldım. Google anahtarı özel sunucu ortamında kaldı.”
Takılan örnek: “Yerel sayfa açıldı ama sunucu modelden yanıt alamadı.” Gerçek yapılandırma/erişim/kota aşamasını kaydedin; yeniden denemeden hesap maliyetlerini inceleyin. Statik dosya önizlemesi canlı yanıtı doğrulayamaz.
- Yerel proxy uygulamasını ve gerçek sağlayıcı destekli ilk yanıtı veya tam engeli belirtir.
- Deneme kodunu özel sağlayıcı anahtarından ayırır ve hesap/model kullanım sınırlarını kontrol eder.
Bu adımda kullanılan dosyalar
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Tarayıcıyı sınırlandırılmış sunucu işlevine bağlayın
Kimlik bilgileri ve öğreticinin nasıl davranacağı sunucunun denetiminde kalsın.
Verilen klasörleri yayımlayıp START-HERE.txt değişkenlerini ayarlayın. public/app.js, user/assistant mesajlarını kendi mini-chat işlevinize gönderir. İşlev yalnızca sırayla değişen kullanıcı/yardımcı rollerini, sınırlı metni ve küçük geçmişi kabul eder.
Sunucu assistant rolünü Gemini’nin model rolüne çevirir ve ayrı bir sistem yönergesi ekler. İstemci sağlayıcı URL’si seçemez veya system rolü gönderip öğreticinin yönergesini değiştiremez. Sahip kodu bu alıştırmayı kısıtlar; genel kullanıcı doğrulamasının ve kalıcı harcama denetiminin yerine geçmez.
generate, netlify/functions/mini-chat.mjs içindeki yerel yardımcı işlevdir; başka bir yayımlanmış hizmet değildir. Ödevde öğreticinin davranışını değiştirmek için bu sunucu dosyasında generate işlevine verilen yönerge metnini düzenleyin. Tarayıcı için .env değişkeni ayarlamak alternatif değildir; tarayıcı koduna yazılan değer herkese açılır.
Yerel çalışma sırasının tamamı için run-locally.txt dosyasını açın: kökteki özel ortamı hazırlayın, yalnızca deneme projesini bağlayın ve Netlify işlevlerine istek ileten yerel aracı başlatın. server-env.example.txt gerçek sırlar olmadan değişken adlarını listeler. Yalnızca HTML’yi açmak sunucuyu çalıştırmaz.
Aşağıdaki güncel model kılavuzunu kullanın veya kendi ortamınızla özel kök klasörden list-text-models.mjs çalıştırın. Anahtarı yazdırmadan hesabın görebildiği generateContent adaylarını listeler. Desteklenen metin modelini seçin, koşul ve kotayı kontrol edip tam API ID’sini sunucudaki GEMINI_MODEL değerine yazın.
Çözülmüş örnek
Geçmişi denetleyen kod, araya sokulan system rolünü sağlayıcı çağrısından önce reddeder. Modelin hatasız olmasını sağlayamaz ama isteğin biçimi ve ayrıcalıklı ayarlar sizin denetiminizde kalır.
Gemini generateContent API · Gemini API anahtarları · Gemini: güncel model ID’leri ve özellikleri · Node.js: desteklenen sürümlerin durumu
Extra implementation exercise
Tarayıcı GEMINI_API_KEY seçmeli veya öğreticiyi değiştirmek için system mesajı göndermeli mi?
Çözülmüş örneği göster
İkisini de yapmamalı. Anahtarı ve yönergeyi sunucuda ayarlayın. İstemci rollerini ve boyutlarını doğrulayın; model yanıtlarını yine doğruluk açısından incelemek gerekir.
- Sağlayıcı sırlarını sunucuda tutar.
- İstemciden gelen mesajları güvenilmeyen konuşma verisi olarak değerlendirir.
Sık yapılan hata
Normal arayüz göstermiyor diye istemcinin gönderdiği rollere güvenmek.
Adım 3
Konuşmayı sürdürüp hatayı deneyin
İstek başarısız olduğunda yazılan iletiyi koruyun.
Bağımlı takip sorusunu gönderip yanıtını önceki konuşmayla karşılaştırın. Asistanınızdan gözden çıkarılabilir projede başarısız bir isteği benzetmeye veya yeniden üretmeye yardım etmesini isteyin.
Takip sorusu konuşmanızla ilgili kalmalı; başarısız gönderim taslağı ve önceki iletileri yeniden deneme için korumalıdır.
Somut bir örnek
İkinci turdaki hata, az önce yazdığınız soruyu silmemelidir.
Sıra sizde
Takip sorusunda ve başarısız gönderim/yeniden deneme yolunda ne oldu?
Cevabını ders asistanıyla değerlendir
Çözülmüş örneği göster
Örnek konuşma kaydı: “Sunucu açıklamasından sonra sadeleştirme isteğim aynı açıklama hakkında kaldı. Ardından bir gönderimde bilerek yanlış deneme kodu kullandım; taslak ve önceki mesajlar görünür kaldı. Geçerli kodu geri koyunca yeniden deneyebildim.”
Yanlış kod reddi, sağlayıcı kesintisi değil, bilerek yapılan yerel testtir. Taslak kaybolursa veya yeniden denemede başarılı mesaj çifti iki kez eklenirse konuşma henüz hazır değildir.
- Konu devamlılığı için devam cevabını önceki konuşmayla karşılaştırır.
- Açıkça etiketlenmiş hatayı test eder; taslağın ve önceki mesajların tekrar denemek için kaldığını kontrol eder.
Bu adımda kullanılan dosyalar
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Konuşmanın devamını ve hatayı deneyin
İkinci soruyu da tamamlama kontrolünüzün parçası yapın.
Örnekteki DNS sorusunu sorun; ardından ona gönderme yapan bir devam sorusu sorun. Tarayıcının geliştirici araçlarında istek gövdesini inceleyin ve yanıtı gerçekten sorulan son soruyla karşılaştırın. Uzun ve akıcı bir yanıt, soruyla ilgili olduğunun kanıtı değildir.
Sonraki gönderimde yanlış erişim kodu deneyin. Taslak textarea alanında kalır; başarısız soru-cevap geçmişe eklenmez. Erişimi düzeltip tekrar deneyin. Enter gönderir, Shift+Enter yeni satır açar. Beklerken düğme devre dışıdır.
Çözülmüş örnek
Zaman aşımı veya eksik sağlayıcı yanıtı görünür hata verir. Tarayıcı boş assistant mesajı ekleyip konuşma devam etmiş gibi yapmaz.
Extra implementation exercise
İlk yanıt iyi ama ikinci istek başarısız. Yazılan mesaj ve geçmiş ne olmalı?
Çözülmüş örneği göster
Taslağı ve önceki tamamlanmış konuşmayı koruyun. Hatayı doğru bildirin, gönderme kontrollerini açın; yeni soru-cevap çiftini ancak geçerli yanıt gelince ekleyin.
- Yeniden denemek için taslağı korur.
- Uydurma yardımcı yanıtı kaydetmez.
Sık yapılan hata
Yalnızca “merhaba” deneyip bütün sohbetin çalıştığını söylemek.
Adım 4
Konuşma davranışını teslim edin
Tek bir güzel yanıt yerine birkaç soru-yanıt kullanın.
Yapay konunuzla üç soru-yanıtlık testi tamamlayın ve hassas bilgileri çıkarılmış dökümü saklayın. Düzeltmeden sonra başarısız gönderimden toparlanmayı tekrarlayın.
Tekrar denemenin taslağı kaybetmediğini veya başarılı mesaj çiftini çoğaltmadığını kontrol edin. Yapılamayan testleri denenmedi kaydedin. Bu örnek güvenilir web sitesi notlarını getirmez, doğru bilgi garantisi vermez; sıradaki content-chatbot dersi, sağlanan kaynakla kontrol görevini ekler.
Somut bir örnek
Kanıtınız ziyaretçinin ne sorduğunu, ne döndüğünü ve başarısız isteğin nasıl toparlandığını göstermelidir.
Sıra sizde
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.
Konuşma dökümünü ve gerçek hata/yeniden deneme gözlemini sunun.
Hazırlanacak çıktı Sırlar çıkarılmış kısa, çok turlu konuşma dökümü ve gözlemlenen hata/yeniden deneme sonucu.
Cevabını ders asistanıyla değerlendir
Çözülmüş örneği göster
Üç mesaj çiftlik örnek taslak: “1. Web sitesi sunucusunu açıkla. 2. O cevabı sadeleştir. 3. O sunucunun bu siteye yardımcı olduğu bir örnek ver.” Tamamlanmış kayıt, aralarındaki ilişki değerlendirilebilsin diye soruların yanında gerçek yanıtları içermeli.
Örnek toparlanma notu: “Bilerek reddedilen gönderim taslağını korudu; yeniden deneme iki değil, bir başarılı mesaj çifti ekledi.” Yalnızca sahibine açık bu örnek, herkese açılmadan önce hâlâ kimlik doğrulama, kalıcı kullanım kontrolleri ve maliyet takibi gerektirir; kaynağa dayalı cevap sistemi değildir.
- Üç ilişkili soru-cevap ve yanıtları değerlendirmeye yetecek bağlam içerir.
- Başarısız gönderimden toparlanmayı taslak kaybı veya yinelenmiş başarılı mesaj çifti olmadan 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.
How it works (optional)
Ödeviniz: devam etmeye değer bir öğretici hazırlayın
Yalnızca başarılı istekleri saymak yerine yanıtların soruya karşılık verip vermediğini değerlendirin.
Sunucu yönergesini kısa ve anlaşılır HTML/CSS öğreticisi olacak şekilde değiştirin. Üç soru-cevap yapın: bozuk sayfa içi bağlantıyı sorun, yanlış href/id çifti önerin ve neden çalışmadığını sorun. Özel kaynak kod yerine uydurma deneme kodu kullanın.
Hassas bilgileri çıkarılmış konuşmayı saklayıp her yanıtın son mesaja karşılık verip vermediğini not edin. Bir başarısız gönderimi tekrarlayın; yeniden denemenin konuşmayı tutarlı bıraktığını gösterin. Herkese açmadan önce gerçek giriş doğrulaması, kullanıcı başına kalıcı kota ve mesajların nereye gittiğinin açıklamasını planlayın.
Çözülmüş örnek
Yararlı öğretici hangi href/id değerlerinin uyuşmadığını söyler. Değişken adları hakkındaki genel tavsiye doğru bile olsa öğrencinin belirli yanıtını ele almaz.
Çözümün bütün adımlarını reference/assignment-walkthrough.txt dosyasında bulabilirsiniz. Adımları kendi sonucunuzla karşılaştırın; kontrol kaydını kendi projenizde gözlemlediklerinizle doldurun.
Extra implementation exercise
Üç soru-cevaplık konuşma ve bir hata/yeniden deneme gözlemi hazırlayın.
Çözülmüş örneği göster
Sunucu işlevindeki yönerge metnini kısa HTML/CSS öğreticisi olarak düzenleyin. Tarayıcı değişkenini değiştirmeyin veya generate işlevini public klasörüne taşımayın. Referans işlevi değişmiş yönergeyle tam sürümdür.
Örnek değerlendirme: kullanıcı <a href='#work'> neden <section id='projects'> bölümüne ulaşmıyor diye sorar. İlgili yanıt href/id farkını belirtir. Sonra kullanıcı href='#projects' önerir; devam yanıtı bu düzeltmeyi kontrol etmelidir. Genel değişken adlandırma tavsiyesi, HTTP 200 olsa bile bu denemeyi geçmez.
Daha sonraki soruda yanlış deneme koduyla gönderin. Önceki konuşma bozulmamalı; textarea gönderilmemiş taslağı korumalı. Kodu düzeltip tekrarlayın, yeni user/assistant çiftini yalnızca geçerli yanıtla ekleyin. Bu konuşma örneği bir değerlendirme kılavuzudur, gerçek model çalıştırıldığı iddiası değildir.
- Devam yanıtları gerçekten önceki mesajlara karşılık verir.
- Hata taslağı ve geçmişi korur; sağlayıcı anahtarı özel kalır.
Sık yapılan hata
Yapay zekâ bağlantısını yalnızca HTTP başarısıyla değerlendirmek.
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?
- Sohbetin kendi içeriğinize dayanarak yanıt vermesini nasıl sağlarsınız?
- 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