İlk istemlerin neden başarısız olduğunu öğrenin: çoğu hata daha iyi kelime kullanmaktan değil, eksik örnek veri, kullanıcı rolleri ve istisnalardan kaynaklanır.

Yazan kişinin gözünde ilk istem net görünebilir ama yine de hedefi kaçırabilir. Sorun genellikle ifade şekli değildir. Sorun, isteğin arkasındaki eksik gerçeklerdir.
İnsanlar zayıf bir istemi daha akıllı, daha uzun veya daha cilalı yaparak düzeltmeye çalışırlar. Ancak daha iyi bir ifade, hiç dahil edilmemiş bilgilerin yerini alamaz. Model yeterli bağlama sahip olmadığında yine yanıt vermek zorundadır. O yüzden boşlukları olası tahminlerle doldurur.
Bu tahminler ilk bakışta faydalı görünebilir. Sonra çatlaklar belirir. Çıktı kullanıcılarınıza, verilerinize veya ürününüzün başa çıkması gereken garip durumlara uymayabilir.
"Küçük bir ekip için bir CRM oluştur" gibi bir istek yeterince spesifik gibi durur, ama temel soruları dışarıda bırakır:
Bu ayrıntılar olmadan model sorununuzu çözmüyor; ortalama bir sürümünü çözüyor.
Sohbet tabanlı uygulama oluşturucularda da bunu görürsünüz. Birisi Koder.ai'den dahili bir araç oluşturmasını isterse platform hızlı ilerleyebilir, ama ilk sonuç yine alınan bağlama bağlıdır. İstem örnek kayıtları, ekip rolleri veya özel durumlardan bahsetmiyorsa uygulama düzgün görünebilir ama önemli parçaları yanlış yapabilir.
Zayıf ilk çıktılar AI'nın görevde kötü olduğunun kanıtı değildir. Çoğu zaman görev yeterince açıklanmamıştır. Model başlığı alır, çalışır detayları almaz.
Gerçek değişim, "Bunu daha iyi nasıl ifade ederim?" sormayı bıraktığınızda ve "Modelin zaten bildiğini varsaydığım hangi gerçekler var?" diye sormaya başladığınızda gerçekleşir. Bu genellikle aynı cümleyi beş kez yeniden yazmaktan daha hızlı sonuç verir.
Çoğu ilk istem bağlam eksikliğinden başarısız olur, yanlış kelime kullanımından değil.
İnsanlar cümleyi yeniden yazar, daha resmi terimler takar ve ekstra talimatlar ekler. Ama daha büyük sorun modelin hala çok fazla geçerli yanıta sahip olmasıdır. Üç tür bağlam bu seçenekleri hızla daraltır: gerçek örnek veriler, kullanıcı rolleri ve istisnalar.
Örnek veri görevi somutlaştırır. Bir müşteri panosu isterseniz bunun on farklı anlamı olabilir. Birkaç örnek kayıt hangi alanların olduğunu, hangilerinin dağınık olduğunu ve en çok neyin önemli olduğunu gösterir.
Kullanıcı rolleri de en az bunun kadar önemlidir. Bir kurucu, satış temsilcisi, yönetici ve destek görevlisi aynı ekranı, tonu veya izinleri istemez. Rolleri atlıyorsanız model genellikle herkesi harmanlayıp hiçbirine iyi uymayan belirsiz bir orta yol üretir.
İstisnalar ise insanların çok geç fark ettiği parçadır. Bir ödeme başarısız olursa, bir alan eksikse, bir kullanıcının sadece okunur erişimi varsa veya iki kayıt çelişiyorsa ne olur? Bu kurallar olmadan model bu boşluğu bir tahminle doldurur.
Koder.ai üzerinden sohbetle basit bir CRM inşa eden birini düşünün. "Ekip için bir CRM oluştur" geniştir. Üç örnek kontak ekleyin, satış temsilcilerinin anlaşmaları düzenleyebildiğini, yöneticilerin raporları dışa aktarabildiğini belirtin ve bir lead'in e-posta adresi yoksa ne olması gerektiğini söyleyin. Sonuç, model tanımlanmış bir problemi çözdüğü için çok daha faydalı olur.
Bu ayrıntılar istemleri sadece uzun yapmaz; görevi daha küçük, daha net ve yanlış anlaşılması zor hale getirir.
Model verilen verilerin nasıl göründüğünü görebildiğinde bir istem çok daha iyi olur. Birçok kişi görevi tarif eder ama ham materyali hiç göstermez.
Özet, tablo, form veya temizleme kuralı istiyorsanız, gerçek şeye benzeyen 3 ila 5 küçük örnek ekleyin. Özel veya kusursuz olmalarına gerek yok; sadece girişin şeklini göstermeliler.
Örneğin, Koder.ai kullanan bir kurucu basit bir CRM için lead puanlama kuralları isteyebilir. "Yeni leadleri aciliyet ve bütçeye göre puanla" mantıklı görünür, ama yine tahmine açık noktalar bırakır. Daha iyi bir istem birkaç örnek lead içerir: şirket büyüklüğü, bütçe aralığı, istenen özellik ve zaman çizelgesi gibi alanlar.
İyi örnek veri genellikle dört şeyi yapar:
Son nokta göründüğünden daha önemlidir. Girişiniz bir destek talepleri listesi ve ideal çıktınız öncelik, sahip ve sonraki adım içeren bir tabloysa, o yapıda bir örnek gösterin. Model genellikle deseni takip eder.
Zayıf bir istem "Bu siparişleri düzenle." der. Daha güçlü olanı "Aşağıdaki örnekleri kullanarak her siparişi customer_name, item_count, rush ve notes alanlarını içeren JSON'a çevir." der. Artık görev somutlaşmıştır.
Örnek veri ayrıca gizli sorunları erken ortaya çıkarır. Bazı kayıtların tarih kullandığını, bazılarının "ASAP" yazdığını ve bir müşterinin fiyat alanını boş bıraktığını fark edebilirsiniz. Bu vakalar görünür olduğunda model rastgele seçimler yapmak yerine bunları daha güvenilir ele alır.
Model doğru cevabı veremezse kimin için olduğunu bilmiyordur. Bir kurucu, bir yönetici ve bir müşteri aynı panoyu isteyebilir ama yine de çok farklı şeylere ihtiyaç duyarlar.
Sadece "bir proje panosu oluştur" derseniz, AI kimin ne görmesi ve yapması gerektiğini tahmin etmek zorunda kalır. Bu tahmin genellikle karışık ekranlara, eksik kontrollere veya yanlış hissettiren erişimlere yol açar.
İstemi yazarken her rolü adlandırın ve net sınırlar verin. Kimin kayıt oluşturabileceğini, kimin düzenleyebileceğini, kimin işi onaylayabileceğini, kimin sadece görüntüleyebileceğini ve her rolün asla erişmemesi gerekenleri söyleyin.
Bu son kısım çok önemlidir. Bir müşteri kendi siparişini takip etmeye ihtiyaç duyabilir ama diğer müşterilerin verilerini asla görmemeli. Bir yönetici talepleri onaylayabilir ama fatura ayarlarını değiştirmemeli. Bir admin tam görünürlüğe, hesap kontrollerine ve ekip performansına erişim gerekebilir.
Küçük bir örnek bunu görmeyi kolaylaştırır. Koder.ai'de bir CRM veya müşteri portalı inşa ettiğinizi hayal edin. İsteminiz "Kurucu tüm anlaşmaları oluşturabilir, düzenleyebilir, onaylayabilir ve görüntüleyebilir. Satış yöneticileri ekiplerinin sahip olduğu anlaşmaları düzenleyebilir ve belirli bir limite kadar indirim onaylayabilir. Müşteriler yalnızca kendi tekliflerini ve faturalarını görüntüleyebilir." derse platform baştan daha iyi seçimler yapabilir.
Örtüşme normaldir, ama açık olmalı. Bazen bir yönetici aynı zamanda onaycıdır. Bazen bir destek lideri müşteri kayıtlarını düzenleyebilir ama dışa aktaramaz. Eğer iki rol izinleri paylaşıyorsa bunu söyleyin. Eğer bir fark bir önemli yöndeyse, onu da belirtin.
İyi istemler sadece özellikleri tanımlamaz. Sorumlulukları tanımlar. Model her kişiyi bildiğinde doğru cevabı üretmek çok daha kolay olur.
Bir istem net görünebilir ama gerçek veriler karıştığında çöker. Bu genellikle talimatın normal yolu kapsaması ama gerçek hayatta ortaya çıkan tuhaf durumları hiç ele almamasıyla olur.
Daha iyi sonuçlar istiyorsanız sadece ideal girdiyi tarif etmeyin. Bir şey eksik, tekrar eden, geçersiz veya boş olduğunda ne olması gerektiğini söyleyin. Bu küçük kurallar genellikle şık ifade tarzından daha önemlidir.
Bir CRM için basit bir müşteri formunu düşünün. Temiz bir test vakası tam ad, e-posta, şirket ve telefon içerir. Gerçek gönderimler genellikle bu kadar düzenli değildir. Biri telefonu boş bırakır, başka biri aynı e-postayı iki kere girer, üçüncüsü tarih alanına anlamsız şeyler yazar.
Birkaç açık kural birçok garip davranışı önler:
Son nokta kolayca kaçırılır. Birçok istem sistemi "kullanıcıya yardım et" dediği için boşlukları kötü varsayımlarla doldurur. Daha iyi bir istem ne zaman durulacağını, ne zaman takip sorusu sorulacağını ve ne zaman işlemi reddedeceğini belirtir.
Ayrıca bir talep bir işletme kuralını bozduğunda ne olacağını tanımlamak yardımcı olur. Örneğin, bir iade talebi 30 günden eskiyse otomatik işleme koymayın; kuralı açıklayın ve manuel incelemeye gönderin. Bir kullanıcı görevin takım dışındaki birine atamaya çalışırsa değişikliği reddedin ve nedenini belirtin.
Her şeyi tahmin etmeniz gerekmez. Sadece gerçek zarar, kafa karışıklığı veya zaman kaybına yol açacak birkaç istisnayı kapsayın. Genellikle bir demosu akıllı gösteren ile insanların güvenebileceği bir iş akışı arasındaki fark budur.
Basit başlayın. En iyi istem genellikle üretmek istediğiniz sonuç hakkında tek bir açık cümleyle başlar. Uzun bir giriş değil, zekice bir numara değil; işi söyleyin: bir kayıt akışı yaz, destek biletlerini özetle veya bir satış ekibi için CRM planla.
Sonra eksik çalışma bağlamını pratik bir sırayla ekleyin:
Kısa bir örnek bunun neden işe yaradığını gösterir. "Bir görev uygulaması oluştur" demek yerine, "Beş kişilik bir pazarlama ekibi için bir görev uygulaması oluştur. Yöneticiler işi atayabilir. Ekip üyeleri sadece kendi görevlerini güncelleyebilir. Eğer bir teslim tarihi eksikse görevi tahmin etmek yerine 'plansız' olarak işaretle. Bu örnek verileri kullan..." deyin.
Bu versiyon modele sağlam bir şey verir. Örnek veri biçimi gösterir, roller sınırları belirler ve istisna garip davranışı önler.
Bir sohbet tabanlı oluşturucu kullanıyorsanız (ör. Koder.ai), bu sıra platformun ekranları, mantığı veya veritabanı yapısını üretmeden önce uygulamayı daha doğru planlamasına da yardımcı olur. Daha iyi istemler genellikle ifade şekliyle değil, sisteme gereken gerçekleri vermekle ilgilidir.
Sohbet tabanlı bir oluşturucu kullanan bir kurucu basit bir müşteri kayıt uygulaması istemiyle başlayabilir: "Basit bir müşteri alma uygulaması oluştur."
Bu net gibi görünür ama sonuç genellikle genel olur. Uygulama ad, e-posta, telefon ve notlar gibi temel alanları içerebilir. Herkes için tek tip bir iş akışı oluşturabilir; resepsiyon görevlisi, yöneticiler ve servis personeli arasında fark olmayabilir.
İlk sonuç işe yaramaz demek değildir; sadece istemin sınırlarını yansıtır. Sistemde örnek müşteriler, personel rolleri ve karmaşık gerçek hayata dair kurallar yoktur.
Daha güçlü bir istem şu bağlamları ekler:
Örneğin, istem resepsiyon görevlisinin giriş formlarını oluşturup düzenleyebileceğini, bir yöneticinin kayıtları onaylayıp birleştirebileceğini ve servis personelinin yalnızca atanan müşterileri görüntüleyebileceğini söyleyebilir. Ayrıca bir yeni müşteri tam detaylarla gelirken bir geri gelen müşteri telefon numarasını değiştirmiş ve bir yönlendirme sadece kısmi bilgi içeriyor olabilir.
Sonra istisnalar gerçek farkı yaratır. Aynı e-posta veya telefon numarası iki kez görünürse uygulama yeni kayıt oluşturmadan önce personeli uyarmalıdır. Bir form anahtar ayrıntıları eksikse tamamlanmış bir kayıt yerine taslak olarak kaydetmelidir.
Bu ayrıntılar eklendiğinde bir sonraki sonuç genellikle işin gerçekten ihtiyaç duyduğu şeye çok daha yakın olur. Alanlar daha az rastgele hissedilir. Ekranlar gerçek işler için daha uygun olur. İş akışı, personelin geçici çözümler üretmesini gerektirmeden yaygın hataları ele alır.
İfade çok daha akıllı değildir; bağlam sadece daha zengin olmuştur.
Birçok istem zamanı havalı görünmeye çalışmakla boşa gider; asıl amaç olan netlik ikinci planda kalır. İnsanlar panoyu sunuyor gibi cilalı talimatlar yazar, ama model yine ne demek istediğinizi tahmin etmek zorunda kalır.
Gerçek detaylar içeren basit bir istem genellikle belirsiz kelimelerle dolu süslü bir istemden üstündür. "Meşgul mağaza yöneticileri için bir müşteri güncellemesi yaz" zaten "Profesyonel bir tonda etkileyici bir iletişim unsuru oluştur" demekten daha iyidir.
Yapılan yaygın bir hata da kurallar yığmak ama tek bir örnek bile vermemektir. Belirli bir format, ton veya ayrıntı düzeyi istiyorsanız küçük bir örnek gösterin. Kısa bir örnek, beş satır ekstra talimattan daha hızlı tahminde bulunmayı ortadan kaldırır.
Bir diğer hata da çıktıyı gerçekten kim kullanacaksa onu unutmaktır. Kurucu, destek görevlisi ve ilk kez bir müşteri için aynı cevap uygun olmamalıdır. Kullanıcı rollerini atladığınızda çıktı teknik olarak doğru olabilir ama hedef kitle için yanlış olur.
Bu uygulama oluşturmada da ortaya çıkar. "Takım için bir pano yap" diyorsanız ama takımın kim olduğunu hiç söylemiyorsanız sonuç sürüklenir. Bir satış yöneticisi, depo lideri ve muhasebeci farklı ekranlara, kelimelere ve eylemlere ihtiyaç duyar.
Kenar durumları da sessiz bir zaman tuzağıdır. Ekipler genellikle ilk taslaktan sonra istisnaları yama yaparak çözer. Bu, yeni kullanıcılar için çalışan ama geri gelen kullanıcılar, adminler veya eksik veriler için başarısız formlar gibi garip davranışlara yol açar.
Tekrarlanan bazı hatalar şunlardır:
Son hata, revizyonlar arasında çok fazla şeyi aynı anda değiştirmektir. Amacı, kitleyi, örnekleri ve kısıtlamaları aynı anda değiştirirseniz hangi değişikliğin fayda sağladığını bilemezsiniz. Her seferinde bir ana değişken değiştirin; istem çok daha hızlı gelişir.
Bir istem genellikle basit nedenlerle başarısız olur; ifade yeterince zekice olmadığı için değil. Göndermeden önce bir yabancı gibi okuyun. Eğer birinin arka plan bilgisi olmadan görevin ne olduğunu, başarının nasıl görüneceğini ve nelerden kaçınılacağını söyleyemiyorsa model tahmin edecektir.
Bu, Koder.ai gibi bir araçtan sohbet üzerinden bir uygulama, sayfa veya iş akışı oluşturmasını isterken daha da önemlidir; çünkü istemdeki küçük boşluklar sonucun daha büyük boşluklara dönüşmesine neden olabilir.
Bu son nokta kolayca kaçırılır. Kötü çıktılar genellikle modelin yardımcı olmaya çalışıp eksik detayları kendi başına doldurmasından kaynaklanır. Eğer modelin durup soru sormasını istiyorsanız, bunu açıkça söyleyin.
Basit bir test yardımcı olur: istemi bir kere okuduktan sonra bu soruları tahmin etmeden cevaplayabiliyor musunuz?
Eğer herhangi bir cevap belirsizse istem hâlâ yetersizdir. Birkaç ek bağlam satırı —özellikle örnek veriler, kullanıcı rolleri ve istisnalar— genellikle daha fazladan süslü bir ifadeden daha faydalıdır.
Yarın daha iyi sonuçlar istiyorsanız, önce zeki ifade peşinde koşmayın. Tekrar ettiğiniz görevler için yeniden kullanılabilir bir istem şablonu kaydedin. Basit bir yapı iyi işler: amaç, kullanıcı rolü, örnek girdi, beklenen çıktı ve istisnalar.
Sonra küçük bir bağlam kütüphanesi oluşturun. Birkaç gerçek veri örneği, yaygın kenar durum ve daha önce gördüğünüz hataları saklayın. Bir destek yanıtı için bu, bir normal bilet, bir kızgın müşteri mesajı ve cevap yerine yükseltilmesi gereken bir talep olabilir.
Kullanışlı bir rutin basittir:
Bu son adım en önemlisidir. Çıktı zayıfsa birçok kişi aynı talimatı üç kez yeniden yazar. Daha hızlı düzeltme genellikle eksik bağlamı yamamaktır, ifadenin cilalanması değil.
Cevap çok genel geliyorsa örnek verileri ekleyin. Yanlış ton veya yanlış ayrıntı düzeyi kullanıyorsa kullanıcı rolünü netleştirin. Garip vakalarda başarısız oluyorsa istisnaları açık ve sade bir dille listeleyin.
Notlarınızı kısa tutun. Her tekrarlayan görev için bir küçük doküman yeterlidir. Zamanla güvenilir ve hızlı kullanılabilen bir istem seti oluşturursunuz.
Aynı fikir sohbet üzerinden yazı yazmakla kalmayıp yazılım oluştururken de geçerlidir. Koder.ai insanların sohbet aracılığıyla web, sunucu ve mobil uygulamalar oluşturmasına izin verir; bu nedenle ilk yapının kalitesi sağladığınız bağlama çok bağlıdır. Bir kurucu bir CRM istediğinde örnek müşteri kayıtları, satış temsilcileri ve yöneticiler için rol kuralları ve çoğaltılmış kişiler veya onay adımları gibi birkaç istisna eklerse sonuç genellikle işletmenin gerçekten ihtiyaç duyduğu şeye çok daha yakın olur.
Mükemmel bir istem kütüphanesine ilk günden sahip olmanız gerekmez. İşe yarayan istemleri kaydedin, birkaç güçlü örneği yakın tutun ve ilk çıktıyı hızlı bir test olarak kabul edin. Daha akıllı ifade peşinde koşmak yerine eksik bağlamı düzelttiğinizde bir sonraki sonuç genellikle hızla iyileşir.
The best way to understand the power of Koder is to see it for yourself.