Yapay zekaya yazdır

Hiç kod bilmesen bile bir yapay zeka asistanına N'oluyo'nun dokümanını verip çalışan bir bot yazdırabilirsin. İşin sırrı yapay zekaya doğru referans dosyasını vermek, ne istediğini net tarif etmek ve botun şifresi olan token'ı gizli tutmaktır.

1. Portaldan uygulamanı aç ve token'ı .env dosyasına koy

1. Geliştirici portalına git, N'oluyo hesabınla giriş yap ve Yeni uygulama düğmesine bas.

2. Botuna bir görünen ad (örneğin Karşılama Botu) ve küçük harfli bir kullanıcı adı (örneğin karsilama_botu) verip Oluştur'a bas.

3. Ekranda yalnızca bir kez gösterilen token değerini Kopyala ile al.

4. Bilgisayarında botun için boş bir klasör aç (örneğin benim-botum), içinde .env adında düz metin bir dosya oluştur ve token'ı yalnızca oraya yaz:

BOT_TOKEN=buraya_kopyaladigin_token_gelecek

Ardından uygulama sayfasının Ekleme bağlantısı bölümünden botun ihtiyaç duyacağı izinleri seç (başlangıç için Kanalları görüntüle, Mesaj gönder, Mesaj geçmişini oku yeterlidir), Bağlantıyı aç'a bas ve botu deneme sunucuna ekle.

Botun kanaldaki normal mesajların metnini okuyacaksa (örneğin küfür süzgeci ya da !selam gibi ünlemli komutlar için) portaldaki Ayrıcalıklı intent'ler bölümünden Mesaj içeriği'ni açmayı unutma. Yalnızca / eğik çizgi komutu ve buton kullanacaksan buna gerek yoktur.

2. Yapay zekaya hangi doküman dosyasını vereceksin

Yapay zeka araçları N'oluyo API'sini ezbere bilmez; dokümanı vermezsen başka sohbet platformlarının adreslerini ve kütüphanelerini uydurur. Kullandığın araca göre şu seçeneklerden birini indirip sohbete ekle:

3. Kopyalanmaya hazır istem

Yukarıdaki doküman dosyasını (llms-kisa.txt veya llms-full.txt) sohbete ekledikten sonra aşağıdaki kutuyu kopyalayıp yapıştır, en altındaki [BURAYA BOTUN NE YAPACAĞINI YAZ] satırını kendi istediğin işle değiştir:

Sana ekte N'oluyo geliştirici dokümanını (llms-kisa.txt veya llms-full.txt) veriyorum. Yalnızca bu dokümandaki kurallara, rotalara ve olay adlarına uyarak N'oluyo için çalışan bir bot yaz.

Kesin kurallar:
1. Başka hiçbir sohbet platformunun kütüphanesini, adresini veya olay yapısını kullanma. Resmi `noluyo-bot` paketini (Node.js 22+ ESM) kullan; gerekirse yalnızca dokümanın açıkça söylediği standart API adresini (`https://noluyo.net/api/v1`) çağır.
2. Bot token değerini benden isteme ve koda düz metin olarak asla yazma. Kod token'ı ortam değişkeninden (`.env` dosyasından `node --env-file=.env bot.mjs` ile `process.env.BOT_TOKEN`) okusun.
3. Bana oluşturmam gereken tüm dosyaları (`package.json`, `.gitignore`, `.env.example`, `bot.mjs`) tam içerikleriyle, hiçbir yeri `// ...` diye kısaltmadan ver; `.gitignore` içinde `.env` ve `node_modules` mutlaka bulunsun.
4. Bu bot için geliştirici portalında açmam gereken ayrıcalıklı intent'leri (`GUILD_MEMBERS`, `GUILD_PRESENCES`, `MESSAGE_CONTENT`) ve sunucuda bota vermem gereken izinleri adım adım söyle.
5. Etkileşimlere (`INTERACTION_CREATE`) 3 saniye içinde yanıt ver; embed görseli gerekiyorsa dış URL yerine yalnızca `attachment://` kullan; `4004` ve `4014` gibi yeniden bağlanılmaması gereken kapanış kodlarında sonsuz döngüye girme.
6. Sonunda botu Windows, macOS ve Linux terminalinde nasıl kurup çalıştıracağımı tek tek komutlarla anlat.

İstediğim bot şu işi yapacak:
[BURAYA BOTUN NE YAPACAĞINI YAZ]

Python tercih ediyorsan istemdeki 1. ve 2. maddede noluyo-bot Python paketini (noluyo_bot, Python 3.11+) ve os.environ["BOT_TOKEN"] istediğini belirtmen yeterlidir.

4. Botunu nasıl tarif etmelisin

Yapay zeka belirsiz cümlelerde tahmin yürütür; tetikleyiciyi (ne olunca?), aksiyonu (ne yapacak?) ve sınırı (kim kullanabilir, hangi kanalda?) tek paragrafta açıkça yaz.

İyi tarif örnekleri (5 örnek):

1. Karşılama mesajı: "Sunucuya yeni bir üye katıldığında (GUILD_MEMBER_ADD), HOSGELDIN_KANAL_ID ortam değişkenindeki kanala yeni üyeyi etiketleyerek 'Aramıza hoş geldin!' yazan ve sunucu kurallarını özetleyen mavi renkli bir embed kartı atan bot."

2. Butonla rol seçici: "/rol-paneli eğik çizgi komutunu yalnızca ManageRoles izni olan yöneticiler çalıştırabilsin. Komut kanala 'Duyuru bildirimlerini almak için butona bas' mesajı ve bir buton göndersin; üye butona bastığında DUYURU_ROL_ID rolü onda yoksa versin, varsa geri alsın ve sonucu yalnızca basan kişinin gördüğü (ephemeral) bir mesajla bildirsin."

3. Sözcük süzgeci: "Kanalda yazılan mesajlarda .env içindeki YASAKLI_KELIMELER listesinde geçen bir sözcük varsa mesajı silsin, aynı kanala yazarı etiketleyip 'Bu sözcük yasak.' diyen bir uyarı bıraksın ve 10 saniye sonra kendi uyarı mesajını da silsin."

4. Butonlu anket: "/anket komutu soru, secenek1 ve secenek2 adında üç zorunlu metin seçeneği alsın. Kanala iki butonlu bir kart göndersin; her üye yalnızca bir kez oy verebilsin, oy değiştirirse eski oyu düşsün ve kartın üstündeki oy sayıları anında güncellensin."

5. Zaman aşımı komutu: "/sustur komutu bir uye (kullanıcı), dakika (1 ile 60 arası tam sayı) ve isteğe bağlı sebep alsın; yalnızca ModerateMembers izni olanlar kullanabilsin. Hedef üyeyi o süre kadar zaman aşımına alsın ve DENETIM_KANAL_ID kanalına kimin kimi neden susturduğunu yazan bir kayıt mesajı atsın."

Kaçınman gereken belirsiz tarifler (3 kötü örnek):

• *"Bana her şeyi yapan güzel bir moderasyon botu yaz."* — Hangi komutların olacağı, kimin kullanacağı ve ne ceza verileceği belirsizdir; yapay zeka yarım kalan onlarca komut üretir.

• *"Sunucudaki küfürleri engellesin ve insanlara özelden uyarı atsın."* — N'oluyo'da botlar kimseye ilk DM'yi atamaz (403 bot_forbidden); kurala aykırı istek botun sürekli hata almasına yol açar.

• *"Ses kanalındaki konuşmaları dinleyip yazıya döken bot yap."* — N'oluyo'da botlar seste yalnızca yayın yapar, hiçbir koşulda ses alamaz ve kimseyi duyamaz.

5. Yapay zekanın sık yanılgıları ve nasıl düzeltilir

Yapay zeka bazen kendi eski alışkanlıklarına döner. Kodda şunlardan birini görürsen kendisine hatırlatıp düzelttir:

6. Çalıştırmak, hatayı yapıştırmak ve botu açık tutmak

Bilgisayarında Node.js ya da Python kurulu değilse önce Kurulum sayfasındaki adımları tamamla. Sonra klasöründe terminali açıp yapay zekanın verdiği kurulum ve çalıştırma komutunu uygula:

npm install
node --env-file=.env bot.mjs

Hata çıkarsa ne yapmalı? Kırmızı bir hata metni görürsen panikleme; ilk seferde küçük bir izin ya da ayar eksiği çıkması çok doğaldır. Terminaldeki hata satırlarını kopyalayıp yapay zekaya yapıştır (.env dosyasının içeriğini ve token'ı asla yapıştırma!). En sık karşılaşılan hata mesajlarının anlamını kendin de Sık hatalar sayfasından bir dakikada kontrol edebilirsin.

Bittiğini nasıl anlarsın?

• Terminalde botunun bağlandığını söyleyen satırı (... bağlandı / READY) görüyorsun,

• Sunucunun üye listesinde botun çevrimiçi görünüyor,

• İstediğin komutu veya olayı denediğinde bot 1–2 saniye içinde beklediğin yanıtı veriyor ve terminalde kırmızı hata satırı çıkmıyor.

Botun kendi bilgisayarında sorunsuz çalıştığında, bilgisayarını kapattığında da açık kalmasını istiyorsan Botu açık tut rehberine geç.

Bu sayfayı yapay zekaya verirsen

Sırada ne var

• Kurulum: Node.js, Python, terminal ve .env kurulumunun ekran çıktılarıyla anlatımı

• Sık hatalar: 4014, boş content, 403 ve "etkileşim başarısız" çözümleri

• Botu açık tut: botunu bir Linux sunucuda 7/24 kesintisiz çalıştırmak