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.

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

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.

Uygulama dosyaları

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

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

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

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.

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.

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.

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.

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.

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.

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.

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.

Ders işine yaradı mı?

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

Öğrenmeye devam edin

Diğer dersleri inceleyin