DerslerWeb sitenize yapay zekâ sohbeti nasıl eklersiniz?

Mini ders 17 / 30 · Veri ve yapay zekâ ekleyin

Sınamak için küçük bir konuşma seçin

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.

İkinci ileti birinciye bağlı olmalıdır.

Bu derste ne öğreneceksiniz?

  • İ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.
Açıklama, çözülmüş örnek ve alıştırma

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.

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.

  1. 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.

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.

Konuyu anlayalım

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

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

Hangi ilk soruyu ve ona bağlı hangi takip sorusunu deneyeceksiniz?

Çözülmüş örneği göster

Örnek soru çifti: “Bir web sitesi sunucusu ne yapar?” ardından “Bu açıklamayı ilk sitesini yapan biri için sadeleştir.” İkinci cevap, ilgisiz yeni konu başlatmak yerine aynı rolü sadeleştirmeli.

Bu bir test planı, konuşma kaydı değil. Devamlılığı gerçek ilk yanıttan sonra değerlendirecek; yanıt başka açıklama gerektirirse devam sorusunu ona göre uyarlayacağım.

İyi bir cevap neleri içermeli?

  • Somut ilk soru ve onun cevabına başvuran devam sorusu sunar.
  • Tek iyi cevabı yeterli saymak yerine devamlılığın neyle anlaşılacağını açıklar.
Nasıl çalışır? (isteğe bağlı)

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.

Ek teknik alıştırma

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.

Adım 1 · Web sitenize yapay zekâ sohbeti nasıl eklersiniz?

Verilen sohbet botunu başlatın

Özel sunucu yapılandırmasını asistan yapsın.

Açıklama, çözülmüş örnek ve alıştırma

Konuyu anlayalım

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.

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

Çalışan uygulama gerçek ilk yanıtı üretti mi, yoksa kurulum nerede durdu?

Çö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.

İyi bir cevap neleri içermeli?

  • 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.
Nasıl çalışır? (isteğe bağlı)

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

Ek teknik alıştırma

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.

Adım 2 · Web sitenize yapay zekâ sohbeti nasıl eklersiniz?

Konuşmayı sürdürüp hatayı deneyin

İstek başarısız olduğunda yazılan iletiyi koruyun.

Açıklama, çözülmüş örnek ve alıştırma

Konuyu anlayalım

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.

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

Takip sorusunda ve başarısız gönderim/yeniden deneme yolunda ne oldu?

Çö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.

İyi bir cevap neleri içermeli?

  • 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.
Nasıl çalışır? (isteğe bağlı)

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.

Ek teknik alıştırma

İ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.

Adım 3 · Web sitenize yapay zekâ sohbeti nasıl eklersiniz?

Konuşma davranışını teslim edin

Tek bir güzel yanıt yerine birkaç soru-yanıt kullanın.

Açıklama, çözülmüş örnek ve alıştırma

Konuyu anlayalım

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.

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

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.

Çö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.

İyi bir cevap neleri içermeli?

  • Üç 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.
Nasıl çalışır? (isteğe bağlı)

Ö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.

Ek teknik alıştırma

Üç 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.

Ders işine yaradı mı?

Beğenebilir, faydalanacağını düşündüğün biriyle paylaşabilirsin.