Open in
Prompt stil kılavuzu
Bir ThunderPhone sesli AI ajanının promptunu nasıl yazıp düzenleyeceğiniz: prompt inceleme kontrollerinin kullandığı yönergeler ve bulgularında atıf yapılan kimlikler.
Bu rehber; oluşturucuda, Copilot'ta veya API üzerinden çalışan bir kodlama ajanıyla sesli AI ajanı istemi yazan ya da düzenleyen herkes içindir. İstem inceleme aracı bunu değerlendirme ölçütü olarak kullanır ve rehber kimliklerine (P1, W2 ve benzerleri) atıfta bulunur.
Arayan kişi ajanı bir kez, konuşma hızında duyar ve geriye kaydıramaz. Ajan her turda istemi okur ve ifadelerini yakından takip eder. Aşağıdaki her şeyi bu iki gerçek şekillendirir.
Yapı
P1. Yeni bir resepsiyon görevlisine brifing verirmiş gibi yazın. Kısa bir giriş, yapay zeka ajanının kim olduğunu ve kimin için çalıştığını belirtir. Ardından arama, gerçekleştiği sırayı izler: nasıl başladığı, nelerin öğrenileceği, nelerin doğrulanacağı, nasıl sona erdiği. Her kural, aramanın uygulandığı bölümünde yer alır. Okuyucu her paragraf için şunu sorabilmelidir: "bu işletmeyi yöneten biri bunu yazmış olabilir mi?" Öğrenilmesi gerekenler, yalnızca arayanın kim olduğunu ve ona nasıl ulaşılacağını değil, işletmenin talep doğrultusunda harekete geçmek için ihtiyaç duyduğu bilgileri kapsar.
P2. Sade başlıklar, altında düz yazı. "Kim olduğunuz", "Çağrı", "Bilgiler" ve "Aktarma" gibi başlıklar faydalıdır. Makine tarzı yapı ise faydalı değildir: numaralı kural kılavuzları, camelCase veya kod benzeri başlıklar, uzun tireli kural listeleri, başta bir araç başvurusu ve "aşağıdaki 4. bölüme bakın" gibi çapraz başvurular. Listeler, ajanın başvuracağı veriler (çalışma saatleri, fiyatlar, adres) için uygundur.
P3. Konuşma tarzını bir kez, kısaca belirtin. Ajanın arama boyunca nasıl konuştuğu (kısa birinci tekil şahıs ifadeleri, sıcak, sade sözcükler; bkz. S2) üst kısımda kısa bir paragrafta yer alır. Belirli bir adıma özgü her şey o adımda yer alır.
P4. Bilgileri davranıştan ayırın. Çalışma saatleri, fiyatlar, konumlar, politikalar ve diğer bilgiler; çağrı akışına dağılmak yerine istemin bilgi bölümünde veya bilgi tabanında yer alır. Uzun kataloglar ve SSS'ler bilgi tabanına aittir. Ajan yalnızca kendisine verilen bilgileri söyleyebilir.
İçerik
C1. Senaryolar değil, ilkeler ve olgular. Ajanın neyi başarmaya çalıştığını ve neyi bilmesi gerektiğini açıklayın. "Arayan X derse Y deyin" dallanmalarını, öngörülen sorulara yönelik senaryolu yanıtları ve hazır kalıpları çıkarın. Yapılandırılmış açılış selamlaması, senaryolu olan tek öğedir.
C2. Düzeltme genel ilkeyi belirtir. Bir istem değişikliği gözlemlenen bir hataya yanıt verdiğinde, değişiklik o tek duruma yönelik bir yama değil, genel bir ilke veya eksik bir olgu ekler. Hatalı aramanın ayrıntıları (adları, numaraları, tam ifadeleri) istemin dışında kalır.
C3. Eklemek yerine çıkarmayı tercih edin. Bir hata fazla özel, fazla geniş veya kötü konumlandırılmış mevcut bir kurala dayanıyorsa, yanına karşı kural eklemek yerine bu kuralı değiştirin veya kaldırın.
C4. Bazı kararları istem değil, ayarlar verir. Bunlar ajan ayarlarıdır ve bunlar hakkında istem metni yok sayılır veya ayarlarla çakışır: bir araç çalışırken söylenenler (araç başlangıç satırı, doldurma ifadeleri), sessizlik kontrolü ve sessizlikten sonraki son eylem, tekrar okumanın temposu, dil değiştirme biçimi, kayıt bildirimi ve ilk olarak ajanın mı yoksa arayanın mı konuşacağı. İstemi bunun yerine sonuca yönlendirin ("kaydetmeden önce e-posta adresini onaylayın") ve ayarı yapılandırın. Açılış selamlamasının kendisi isteme yazılır.
C5. Örnekler, ajanın söyleyeceği cümlelerdir. Ajan örnek ifadeleri neredeyse kelimesi kelimesine kopyalar; bu nedenle her örnek eksiksiz, doğal bir konuşma cümlesi olmalıdır ve birkaç farklı örnek tek bir örnekten daha etkilidir. Bunları zorunlu satır olarak değil, örnek olarak sunun ("Örneğin, şöyle diyebilirsiniz ..."). "Hâlâ doğru mu?" gibi kısa etiketler sesli söylendiğinde kesik duyulur.
C6. Kendi müşterilerimizin aramalarından örnek kullanmayın. Örnekler durumu genel ifadelerle açıklar veya uydurma bir işletme kullanır.
C7. İstem, geliştirmeyle ilgili değil, arayanlar içindir. Arayanlar, istemde yazan her şeyi yayına alındıktan sonra duyar; bu nedenle istem, geliştirme, test veya uyumluluk durumu hakkında notlar içermez ("bu sürüm test içindir", rezervasyon adındaki "TEST", "sözleşmeler imzalanana kadar"). Ayrıca işletmenin istemediği feragatnameleri, sorumluluk sınırlamalarını ve kapanış özetlerini de içermez; örneğin bir planı kabul etmenin neyi oluşturmadığı veya hâlâ onaylanmamış olanların özeti gibi. Yapay zeka ajanı arayanın sorduğunu yanıtlar ve durur; işletme istediğinde bir uyarı ekler. Eksik bir bilgi veya sistem sınırı, sağlanmadığına ya da taleplerin nasıl kaydedildiğine dair bir not olarak değil, yapay zeka ajanının ne yaptığı şeklinde yazılır ("fiyatlar için ofisten geri arama teklif edin"); ayrıca taslaktan kalmış rastgele bir ad veya başlık gibi hiçbir şey bırakılmaz.
İfade biçimi
W1. Ne yapılacağını açıkça ve bir kez söyleyin. İstenen davranışı günlük sözcüklerle bir talimat olarak belirtin: "Arayanın düzeltebilmesi için sipariş numarasını rakam rakam tekrar okuyun." Bunu, geçerli olduğu yerde bir kez söyleyin.
W2. Vurgu kullanmayın. IMPORTANT, NOTE veya CRITICAL etiketleri; güç katmak için büyük harfli sözcükler; ünlem işaretleri; "Kötü:" ve "İyi:" çiftleri; yapılmaması gerekenlere ilişkin bloklar kullanmayın. Güç katmak için kullanılan "asla", "her zaman" ve "zorunludur" gibi sözcükler de buna dahildir. Vurgu, modelin dikkatini tek bir kurala çeker ve aramanın geri kalanında daha kötü performans göstermesine neden olur. Ajan bir yönergeyi yok saydığında, yönergeyi daha yüksek sesle değil, daha açık, daha özel veya daha iyi konumlandırılmış hâle getirin.
W3. Davranışa neden olan yapıyı düzeltin. Ajanın yaptığı bir şeye karşı kural eklemeden önce, onu bu davranışa yönlendiren ifadeyi veya yapıyı bulun: modelin harfiyen doldurduğu bir şablon, iki anlama gelen bir terim, hızlı bir modelin gevşek yorumladığı bir if-else dalı. Onu değiştirin.
W4. Özel olan, genelden daha etkilidir. "En erken iki uygun saati sunun, ardından hangisinin uygun olduğunu sorun" ifadesi, "randevu planlamaya yardımcı olun" ifadesinden daha etkilidir. Belirsiz yönergeler belirsiz davranışlar üretir.
W5. Bir şey hakkında soru sormadan önce onu arayın. Arayan, salt okunur bir arama aracının kontrol edebileceği bir şeyden (ürün, sipariş veya mevcut rezervasyon gibi) bahsettiğinde, yapay zeka ajanı arayanın kullandığı sözcüklerle kontrol eder; ardından yalnızca sonuç gerektiriyorsa ek soru sorar. "Arayanın belirttiği ürünün stok durumunu kontrol edin ve bulduklarınızı söyleyin" ifadesi, "markayı, bedeni ve varyantı netleştirin, ardından stok durumunu kontrol edin" ifadesinden daha iyidir: önce netleştirmesi söylenen bir ajan soru sormaya devam eder ve kontrol hiç çalışmaz. Bu yalnızca aramalar için geçerlidir. Bir şeyi rezerve eden, değiştiren, iptal eden veya kaydeden bir araçtan önce yapay zeka ajanı ayrıntıları arayanla yine de doğrular.
Konuşma
S1. Her turda tek soru sorun ve soru turu bitirsin. Bir sorudan sonra söylenen her şey, arayanın yanıtının üzerine konuşur. Açıklamaları sorudan önce yapın.
S2. Kısa turlar, tam konuşma cümleleriyle. Arayan ayrıntı istemedikçe bir veya iki kısa cümle kullanın. Sözlü seçenekleri birkaçla sınırlayın. Kısa, kırpılmış cümleler değil az sayıda kelime demektir: yapay zeka ajanı, iyi bir resepsiyonistin telefonda konuştuğu gibi, birinci tekil şahısta tam cümlelerle konuşur; örneğin "Bunu şimdi sizin için rezerve edeceğim" veya "Sizi pazartesi saat ona yazdım." Not tarzı parçalar ("Bunu sizin için ayarlıyorum.", "Tamamlandı.", "Not edildi.") sesli söylendiğinde kaba duyulur; e-posta ifadeleri ise ("Lütfen unutmayın ki ...", "Rica ederim ...", "Umarım bu yardımcı olur") söylenmekten çok okunmuş gibi duyulur. İstemin konuşma tarzı paragrafı bunu açıkça ister; örneğin: "Her turu bir veya iki cümleyle sınırlayın ve telefondaki bir resepsiyonist gibi birinci tekil şahısta konuşun."
S3. Kulak için yazın. Ajanın söylediklerinde markdown, semboller ve sesin garip okuyacağı gösterimlerden kaçının (bölü işaretleri, ve işaretleri, "@", ".com", binlik ayırıcılar, boşluksuz telefon numaraları). Ajanın bir araca aktardığı e-posta adresi veya hesap numarası gibi olgular ve değerler tam yazılı biçimlerinde kalır; birinin ayrıca sesli söylenmesi gerekiyorsa, yeniden yazmak yerine yanında nasıl söylendiğini ekleyin. Alışılmadık adların veya kısaltmaların nasıl söylendiğini yazın ve yeni terimleri saklamadan önce ajanın sesinde dinleyin.
S4. Hata yapılması maliyetli olabilecek bilgileri doğrulayın. Numaralar, e-posta adresleri, adresler ve kodlar, verildikleri biçimde, arayan bunları verdikten hemen sonraki yanıtta ve sonraki sorudan önce bir kez tekrar edilir; her tekrar okumada tek bir değer yer alır. Varsayılan olarak ad, söylendiği şekilde kabul edilir ve tekrar edilmez; yapay zeka ajanı yazılışını yalnızca alışılmadık veya belirsiz olduğunda ve bir kez sorar. İşletmenin, kayıtlarıyla eşleştirmek veya bu adla rezervasyon yapmak gibi nedenlerle adın tam olarak bilinmesine ihtiyacı olduğunda, istem bunu belirtir ve yapay zeka ajanı adı harf harf tekrar eder. Tekrar okuma, arayanın bir değeri düzeltme fırsatıdır, bir engel değildir: arayan sonraki ayrıntıyla yanıt verirse veya düzeltmeden konuşmaya devam ederse değeri kabul etmiş olur ve kabul edilen değer yeniden sorulmaz. İşletmenin geri arayacağı veya mesaj göndereceği telefon numarası istisnadır: numaranın tekrar edilmesi turu sonlandırır ve arayanın yanıtını bekler. Rakam rakam okunmasını isteyen bir istem, yalnızca bu şekilde okunacak değerleri belirtir (telefon numarası, kod); ev numarası, fiyat, saat veya tarih insanların bunları normalde söylediği şekilde söylenir. İstem neyin doğrulanacağını belirtir; tekrar okumanın temposunu platform belirler.
Yineleme
I1. Bir değişikliği korumadan önce test edin. Düzenlenmiş taslakta ajanın geliştirme veri kümesini yeniden çalıştırın ve mevcut sürümle karşılaştırın: değişikliğin hangi örnekleri düzelttiğini, hangilerini bozduğunu belirleyin. Yanıtları, arayanın duyacağı şekilde okuyun. Arayanın fark edeceği her şey bir ayrıntı değil, sorundur.
I2. Ayrılmış küme bir kez kontrol edilir. Yalnızca geliştirme veri kümesinde ayarlama yapın. Bir değişiklik hazır olduğunda test kümesini çalıştırın ve sonucunu olduğu gibi raporlayın. Test sonuçlarını gördükten sonra yapılan bir değişiklik için yeni test örnekleri gerekir.
I3. Yamalar biriktiğinde yeniden düzenleyin. Çok sayıda küçük düzeltme toplanmış bir istem P1'den sapar: kurallar tekrarlanır, çakışır veya yönettikleri adımdan uzakta yer alır. Bu durumda, istediği tüm davranışları koruyarak istemi bu yapıda yeniden yazın. Her davranışı korundu, birleştirildi, yeniden ifade edildi veya çıkarıldı olarak listeleyin ve hiçbir şeyi sessizce çıkarmayın. Geliştirme veri kümesini önce ve sonra yeniden çalıştırın; yeniden düzenleme davranışı değil, ifadeyi değiştirmelidir.
I4. İstemden önce yapılandırmayı kontrol edin. Bazı sorunlar istemden kaynaklanmaz: harfleri yanlış duymak bir işitme sınırıdır (Plus işitmeyi deneyin); yavaş bir yanıt, zeka veya işitme katmanından ya da konuşma sonu algılama ayarından kaynaklanabilir. Metni yeniden yazmadan önce yapılandırma kaynaklı olasılıkları eleyin.