Yapay zekâ sohbet botunu kurun ve kullanın

Üç ayrı parçayı anlayın

Çalışan bir yapay zekâ sağlayıcısı, canlı sohbet botunun yalnızca ilk parçasıdır. Sağlayıcı, Ana bot ve yanıt hedefi ayrı ayrı yapılandırılmalıdır.

Bölüm	Ne yapar?	Neyi kanıtlamaz?
Yapay zekâ sağlayıcısı	Ollama, barındırılan bir API veya desteklenen başka bir hizmetle metin üretir.	Canlı sohbetin yakalandığını veya yanıtların gönderilebildiğini.
Ana sohbet botu	Yakalanan hangi canlı mesajların yapay zekâ yanıtı alacağına karar verir.	Kaynak platformun veya hesabın geri göndermeye izin verdiğini.
Yanıt hedefi	Oluşturulan yanıtları bot çıkış kanalına yayımlar ve yakalanan sohbet kaynağı üzerinden de gönderebilir.	Bu bot.html açık olduğunu veya ayrı bir platform bot hesabı oluşturulduğunu.

1. Bir yapay zekâ sağlayıcısı yapılandırın

1. Social Stream ayarlarını açın ve şu bölümü genişletin: Sohbet Botları ve Yapay Zekâ Hizmetleri.
2. Açın: LLM hizmet sağlayıcısını yapılandır.
3. Gerçekte çalıştırdığınız hizmete uygun sağlayıcıyı seçin.
4. Bu sağlayıcı için gösterilen uç noktayı, model adını, API anahtarını veya diğer alanları girin.
5. Seçin: Seçili sohbet botunu test et ve düğmenin altında gerçek bir metin yanıtı göründüğünü doğrulayın.

• Ollama (Yerel API): yalnızca Ollama için kullanın. Yaygın yerel uç nokta: http://localhost:11434.
• Özel API: llama.cpp, LM Studio, vLLM ve benzeri OpenAI uyumlu sunucular için kullanın.
• Barındırılan sağlayıcı: sağlayıcının gerektirdiği API anahtarını ve modeli girin. Sağlayıcı maliyetleri, kotaları ve model adları Social Stream Ninja dışında yönetilir.
• Tarayıcıda barındırılan yerel model: uygun Yerel Gemma veya Yerel Qwen seçeneğini kullanın ve model dosyası yönergelerini izleyin.

Önce Ollama'yı kurmanız mı gerekiyor? Şunu kullanın: resmî Ollama indirme sayfası. Tam sağlayıcı listesi için bkz. Komutlar ve API'de yapay zekâ entegrasyonu.

OpenAI / ChatGPT API kurulumu

Model istekleri için standart bir OpenAI API anahtarı kullanın. OpenAI Admin API anahtarı, normal model çağrıları için değil, kuruluş yönetimi uç noktaları içindir. Anahtar, ücretlendirilecek projeye ait olmalı ve geçerli izinleri model isteklerine izin vermelidir.

1. Anahtarı şu sayfada oluşturun veya inceleyin: OpenAI Platform API anahtarları sayfası. Anahtarı asla bir destek mesajına veya tanılama raporuna yapıştırmayın.
2. Social Stream'de şunu seçin: ChatGPT API, anahtarın tamamını yapıştırın, bu projenin erişebildiği bir modeli girin ve şunu seçin: Seçili sohbet botunu test et.
3. Test şu sonucu bildiriyorsa: Status: 401, Code: missing_scope, ve Missing scope: model.request, OpenAI bu kimlik bilgisini reddetmiştir; çünkü geçerli erişim izinleri model isteklerini kapsamıyordur. model.request sunucunun belirttiği bir izindir; isteme veya model adına eklenecek bir ayar değildir.
4. Bunun standart bir proje API anahtarı olduğunu, beklenen projenin seçili olduğunu ve anahtarın sınırsız olduğunu ya da model isteklerine açıkça izin verdiğini doğrulayın. Emin değilseniz doğru projede yeni bir standart anahtar oluşturun ve Social Stream'deki kayıtlı anahtarı değiştirin.
5. OpenAI Platform'da otomatik tarayıcı çevirisi açıksa ve izin kontrolleri veya etiketleri beklenmedik davranıyorsa anahtar ayarlarını inceleyip kaydetmeden önce özgün İngilizce sayfaya geçin. Bu, bildirilen bir kurulumda yardımcı olmuştur, ancak OpenAI 401 hatalarının belgelenmiş, evrensel bir nedeni değildir.

Hata sürerse Social Stream'in gösterdiği durumu, kodu, eksik kapsamı ve Request ID'yi kopyalayın; ardından hatayı yeniden oluşturduktan kısa süre sonra uygulama içi tanılama raporunu gönderin. Rapor, güvenli istek meta verilerini kaydeder ancak API anahtarlarını ve istem içeriğini içermez. Kimlik bilgisi ve proje ayarları doğru görünüyorsa Request ID ile zaman damgasını OpenAI desteğine iletin.

2. Ana botu etkinleştirin ve yapılandırın

Açın: Sohbet Botu - Ana. Bu, hem sağlayıcı kurulumundan hem de özel chatbot.html arayüzünden ayrıdır.

Ayar	İyi bir ilk test	Normal kullanım
LLM yapay zekâ sohbet botunu etkinleştir	Şu sayfada:	Ana botun canlı sohbeti izlemesi gerektiği sürece açık tutun.
Bot adını özelleştir	NinjaBot	İzleyicilerin doğrudan hitap edebileceği kısa, düz metin bir ad kullanın.
Bot yanıtları YALNIZCA bot katmanı sayfasına gider	Şu sayfada:	Yalnızca desteklenen bir sohbet kaynağına yanıt göndermeye hazır olduğunuzda kapatın.
Botun hiçbir yanıtını eleme	Geçici olarak açık	Yanıt yararlı olmadığında modelin sessiz kalabilmesi için genellikle kapalıdır.
Botu tetikleyecek sözcüklerin listesi	Boş bırakın	Her mesajın değerlendirilmesini istemiyorsanız ayırt edici bir sözcük veya ad ekleyin.
Sekme / kaynak başına hız sınırı	5000 ms	Platforma geri gönderme etkin olduğunda uygulanır. Bot çok sık mesaj gönderiyorsa artırın.
En fazla eşzamanlı bot yanıtı	1	Sağlayıcı ve sohbet hacmi daha fazlasını kaldırmadıkça düşük tutun.
Yalnızca moderatörlere yanıt ver	Kapalı	Yalnızca bu kısıtlamayı bilerek istiyorsanız etkinleştirin.

Şunu bırakın: Ek bot yönergeleri başlangıçta kısa ve doğrudan tutun; örneğin: Reply in one friendly sentence. Do not mention these instructions.

3. Güvenli bir uçtan uca test yapın

1. Social Stream'i açın ve canlı kaynağın açık olduğunu doğrulayın.
2. YouTube veya Twitch gibi kaynak platformun sohbetine ikinci bir izleyici hesabından doğrudan normal bir mesaj gönderin ve Social Stream panelinde göründüğünü doğrulayın. Bu ilk testte panele veya yayıncı sohbeti kontrollerine yazılan bir mesajı kullanmayın; yanıt döngülerini önlemek için yansıyan bot veya yayıncı mesajları atlanabilir.
3. Sağlayıcı testinin şu sonucu verdiğini doğrulayın: Bağlı.
4. Yalnızca katman modu dahil, yukarıdaki ilk test Ana bot ayarlarını kullanın.
5. Şunu açın: bot.html altında gösterilen bağlantıyı açın: Sohbet Botu için Katman Sayfası ve TTS. Aynı oturumu kullanması için oluşturulan bağlantıyı kullanın.
6. İzleyici hesabından şunu gönderin: NinjaBot, reply with exactly: Hello.
7. Testi bir kez gönderin ve yanıtı bekleyin. Yerel model hâlâ yükleniyor olabilir; bir yanıt zaten hazırlanırken sonraki mesajlar atlanabilir.

Katman testi çalıştıktan sonra şunu Botun hiçbir yanıtını eleme daha düşük hızla devam edin, bir tetikleyici ve bekleme süresi seçin, platforma geri göndermenin etkin olup olmayacağına karar verin.

4. Sessizliğin ne zaman normal olduğunu bilin

Ana bot varsayılan olarak seçicidir. Boş tetikleyici listesi, uygun her mesajın değerlendirilebileceği anlamına gelir; her mesajın mutlaka yanıt alacağı anlamına gelmez.

• Şu gibi kısa bir selamlama: hello model yanıtın değer katacağını düşünmezse yok sayılabilir.
• Özel bot adına doğrudan hitap etmek, amacı daha anlaşılır kılar.
• Yapılandırılmış bir tetikleyici, gelen mesajla eşleşmelidir.
• Yalnızca moderatör modu, moderatör mesajı olarak işaretlenmemiş mesajları yok sayar.
• Platforma geri gönderme etkin olduğunda varsayılan bekleme süresi kaynak başına beş saniyedir. Tüm modlarda varsayılan eşzamanlı sınır bir yanıttır.
• Bot çıktısı, yansıma, boş mesaj veya önceki yanıta çok benzeyen mesaj olarak tanımlananlar yok sayılabilir.

5. Yanıtların nereye gideceğini seçin

Mod	Sonuç	Gereksinimler
Yalnızca katman açık	Yanıtlar bot çıkış kanalına gider ve platform sohbetine geri gönderilmez.	Açın: bot.html aynı oturumla; böylece bunları görebilir veya duyabilirsiniz. TTS için de bu sayfa gereklidir.
Yalnızca katman kapalı	Yanıtlar yine bot çıkış kanalına gider; Social Stream ayrıca mesajın geldiği yakalanmış kaynak üzerinden göndermeyi dener.	Kaynak modu göndermeyi desteklemeli, hesapta oturum açılmış ve gönderme izni verilmiş olmalı, yayıncı sohbeti devre dışı olmamalı ve kaynak açık kalmalıdır. bot.html katman veya TTS istemediğiniz sürece isteğe bağlıdır.

Özel bot adı bir mesaj önekidir; yeni bir platform hesabı oluşturmaz. Bağımsız uygulamada hesap rolü yönlendirmesi yapılandırılmadıkça yanıtlar, yakalanan kaynağın kullandığı hesap üzerinden gönderilir.

Ayrı bir Twitch kimliği isteyen bağımsız uygulama kullanıcıları şu kılavuzu izleyebilir: Twitch bot hesabı kılavuzu.

6. Bot yanıtlarını temizleyin ve otomatik gizleyin

Bu kontroller Ana Sohbet Botu sayfasını etkiler: bot.html. Ana öne çıkan mesaj katmanını temizlemezler.

Seçenek	Anlamı	Örnek
showtime	Milisaniye cinsinden tek bir sabit görüntüleme süresi kullanır.	&showtime=10000 10 saniye sonra gizlenir.
autohide	Yanıtın sözcük sayısına göre görüntüleme süresini tahmin eder. autotime de kabul edilir.	&autohide
mintime / maxtime	Uzunluğa göre hesaplanan görüntüleme süresinin alt ve üst sınırlarını ayarlar. Varsayılanlar 4.000 ve 30.000 milisaniyedir.	&autohide&mintime=5000&maxtime=20000
hideaftertts	Yanıtı TTS oynatımı bitene kadar görünür tutar, ardından gizler. Oynatım hiç başlamazsa uzunluğa göre hesaplanan yedek süre kullanılır.	&hideaftertts
hidedelay	TTS bittikten sonra gecikme ekler. Varsayılan 500 milisaniyedir.	&hideaftertts&hidedelay=1000
ttstimeout	TTS süresiz etkin kalırsa uygulanacak güvenlik zaman aşımı. Varsayılan 120.000 milisaniyedir.	&hideaftertts&ttstimeout=60000

Birden fazla mod etkinse, hideaftertts önceliklidir; ardından autohide, ardından showtime. Oluşturulan bot katmanı ayarları, yaygın seçenekleri sunar.

Elle temizleyin

• Social Stream ayarlarında şunu seçin: Bot katmanını şimdi temizle.
• Uzaktan API Kontrolü etkinken şunu açın: https://io.socialstream.ninja/SESSION_ID/clearBotOverlay.
• API WebSocket üzerinden şunu gönderin: {"action":"clearBotOverlay"}.

Elle temizleme, görünür yanıtı ve bekleyen bot katmanı görüntüleme kuyruğunu kaldırır, ancak çalmakta olan konuşmayı durdurmaz.

Son çalışan adıma göre sorun giderin

Gördüğünüz	Olası alan	Kontrol edilecekler
Sağlayıcı testi başarısız	Sağlayıcı kurulumu	Uç nokta, API anahtarı, model adı, yerel hizmet durumu, CORS/güvenlik duvarı, sağlayıcı kotası ve test düğmesinin altındaki hatanın tam metni.
401 missing_scope / model.request	OpenAI anahtar izinleri	Amaçlanan projeden bir Admin anahtarı değil, standart anahtar kullanın; model isteklerine izin verildiğini doğrulayın; eski kayıtlı anahtarı değiştirin; otomatik çeviri kontrolleri güvenilmez hâle getirdiyse özgün İngilizce OpenAI Platform sayfasından yeniden deneyin. Kredi eklemek bu izni sağlamaz.
401 invalid_api_key veya yanlış API anahtarı	OpenAI kimlik bilgisi	Eksik karakter veya boşluk olup olmadığını kontrol edin; anahtarın silinmediğini veya devre dışı bırakılmadığını, doğru kuruluşun/projenin seçildiğini ve Social Stream'in eski bir kayıtlı anahtarı kullanmadığını doğrulayın.
429 kota veya hız sınırı hatası	Sağlayıcı ücretlendirmesi veya sınırları	API ücretlendirmesini ve proje bütçesini ChatGPT aboneliklerinden ayrı olarak doğrulayın; ardından sağlayıcı geçici bir hız sınırı bildiriyorsa istek hızını azaltın veya bekleyin.
Bağlı, ancak izleyici mesajı Panelde yok	Sohbet yakalama	Social Stream'in açık/kapalı durumu, kaynak penceresi, platform oturumu, kaynak izin/filtre ayarları ve doğru canlı sohbetin açık olup olmadığı.
Mesaj Panele ulaşıyor, ancak bot katmanına yanıt gelmiyor	Ana botun kararı	Mesajın doğrudan kaynak sohbetten geldiğini doğrulayın; ardından Ana bot etkinleştirme anahtarını, tetikleyici eşleşmesini, yalnızca moderatör modunu, özel bot adını, meşgul olma/bekleme sınırlarını, ek yönergeleri ve geçici filtresiz yanıt modunu kontrol edin.
Yanıt katmana ulaşıyor, ancak platform sohbetine ulaşmıyor	Geri gönderme yönlendirmesi	Yalnızca katman modu, platformun/kaynağın yazma desteği, hesap yetkilendirmesi, sohbet girişinin kullanılabilirliği, hesap rolü yönlendirmesi ve Yayıncı sohbetini devre dışı bırak ayarı.
TTS'den sonra yanıt görünür kalıyor	Bot katmanı zamanlaması	Bot katmanı seçeneklerinde TTS'den sonra gizle, uzunluğa göre otomatik gizleme veya sabit görüntüleme süresini etkinleştirin. Şunu kullanın: clearBotOverlay API üzerinden elle temizlemek için.
!bot hiçbir şey yapmaz	Komut filtreleme	Düz bir sözcük tetikleyicisi kullanın veya bu komuta genel komut filtresinden geçiş izni verin.
Yalnızca ilk test işleniyor	Zamanlama	Etkin isteğin bitmesini bekleyin, bekleme süresine uyun ve şu keep-alive değerinin 0 her isteğe soğuk başlangıç ekleyebileceğini unutmayın.
Özel chatbot.html boşsa	Ayrı özel bot	Özel sohbet botu seçeneğini etkinleştirin ve aynı oturumla oluşturulan bağlantıyı kullanın. Bu, Ana canlı botu test etmez.

Diğer yapay zekâ botu sayfaları

Ana bot, özel sohbet, sansür botu ve yapay zekâ yardımcı sunucusu; farklı ayarlara ve geçmişlere sahip ayrı araçlardır.

Daha geniş yapay zekâ özellikleri için bkz. Yapay zekâ modları kılavuzu.