İstem Rehberi
Yazmadan önce karar verin, parçalar halinde oluşturun, gerçek içerik kullanın ve her isteği doğru agentın önüne koyun. Bu alışkanlıklar, tek satırlık fikirleri tamamlanmış sonuçlara dönüştürür.
Yazmadan önce karar verin, parçalar halinde oluşturun, gerçek içerik kullanın ve her isteği doğru agentın önüne koyun. Bu alışkanlıklar, tek satırlık fikirleri tamamlanmış sonuçlara dönüştürür.
Proje sohbetinde başlayın. Değiştirmek istediğiniz projenin sohbetini açın, ardından rolü işe uygun olan agentı seçin veya ona hitap edin. Hangi agentın uygun olduğundan emin değilseniz, oluşturmaya başlamadan önce ekibin netleştirmesini isteyin.
Bu rehber, agent ekibinizden sürekli olarak daha iyi sonuçlar almanızı sağlayan teknikleri bir araya getirir. Bunların hiçbiri özel bir yetenek gerektirmez. Mesele nasıl biçimlendirdiğiniz değil, ne söylediğinizdir. İster ilk isteğinizi yazıyor olun ister olgun bir projeyi iyileştiriyor olun, aynı ilkeler geçerlidir: net düşünce girerse, net sonuç çıkar.
Oluşturmadan önce ekibin soru sormasına izin verin
Daha iyi bir sonuç almanın en etkili yollarından biri şudur: bir istek büyük veya belirsiz olduğunda, ekibin doğru tahmin etmesini ummak yerine sorular sormasını teşvik edin. Ne istediğinizi belirtin, ardından sona şu satırı ekleyin:
Başlamadan önce ne istediğimi tam olarak anlamak için ihtiyaç duyduğunuz her şeyi bana sorun.
Çoğu zaman, sınır durumları, hedef kitleler veya ödünleşimler gibi konularda kendi başınıza yanıtlamayı düşünmeyeceğiniz sorular alırsınız. Bunları en başta netleştirmek bir dakikaya mal olur; bunları oluşturma sonrasında fark etmek ise yeniden çalışma gerektirir. Sonuç, ilk denemede niyetinize çok daha yakın olur.
Adım 1: Yazmadan önce karar verin
Ne oluşturduğunuzu bilin
Başta birkaç dakika düşünmek, sonrasında çok sayıda yeniden istem yazmaktan kurtarabilir. Başlamadan önce şu dört basit soruya yanıt verebildiğinizden emin olun: ne oluşturuyorsunuz, bu kimin için, insanlar bunu neden kullanır ve onların yapmasını en çok istediğiniz ana eylem nedir.
Bu ana eylem genellikle CTA olarak adlandırılır; İngilizce call to action ifadesinin kısaltmasıdır. Bu, kullanıcıların seçmesini en çok istediğiniz düğme, bağlantı veya sonraki adımdır; örneğin Sign Up, Book a Demo, Start Free veya Buy Now.
Tam bir teknik şartname yazmanız gerekmez. Amaç yalnızca projeye net bir yön vermektir. Başlangıç noktanız ne kadar belirgin olursa, aklınızdakine uyan bir sonuç üretmek o kadar kolay olur.
Serbest çalışanlara yönelik bir bütçeleme uygulaması için tek sayfalık bir site oluşturun. Ana CTA “Start Saving Smarter.” olsun. Büyük yazı tipleri ve çarpıcı renklerle cesur, etkileyici bir görünüm kullanın.
Yalnızca ekranları değil, yolculuğu da taslaklayın
İyi tasarım, ekranların üzerinde olduğu kadar aralarında da yaşar. Kullanıcınızın izlediği yolu düşünün: ilk olarak ne görüyor, güveni ne oluşturuyor, harekete geçmesi için ona ne güven veriyor ve bu eylem nereye götürüyor? Üç aşamalı basit bir taslak bile — hero, kanıt, harekete geçirici mesaj — isteklerinizi dramatik biçimde daha etkili hale getirir, çünkü artık her bölümün var olmak için bir nedeni ve bir sonrakine bağlanmak için bir nedeni vardır.
Görsel yönü erkenden belirleyin
Stili sonradan uyarlamaktan ziyade en başta belirlemek çok daha kolaydır. Bir yön seçin: sakin ve zarif, cesur ve yıkıcı, premium ve şık; ardından bunu ilk isteğinizde ekibin uygulayabileceği ton kelimeleriyle belirtin: minimal, playful, cinematic, developer focused. Bu kelimeler süsleme olmanın ötesindedir: daha ilk bileşenden itibaren tipografiyi, boşlukları, rengi, gölgeyi ve köşe yarıçapını şekillendirirler. Her şeyin tutarlı kalması için sonraki isteklerde aynı stil satırını yeniden kullanın.
Sakin, iyi yaşamdan ilham alan bir tasarım kullanın: yumuşak gradyanlar, soluk toprak tonları, yuvarlatılmış köşeler, geniş iç boşluklar. Genel ton nazik ve güven verici olsun.
Adım 2: Sonuç veren istekler yazın
Uygulamaları değil, sonuçları tanımlayın
Oluşturma adımlarını değil, istediğiniz sonucu tanımlayın. Örneğin, “Üç seçenekli bir fiyatlandırma bölümü ekleyin ve ortadakini öne çıkarın” demek, sayfanın tam olarak nasıl kurulması gerektiğini açıklamaktan daha faydalıdır. Neyin görünmesi gerektiğine ve bunun neden önemli olduğuna odaklanın; nasıl oluşturulacağına ekip karar verebilir.
Sayfalarla değil, parçalarla çalışın
Tek bir bileşenle sınırlı istekler — bir hero, bir özellik ızgarası, bir referans satırı, bir fiyatlandırma tablosu — size netlik ve kontrol sağlar. Bir parça hedefi tutturmazsa, etrafındaki her şeyi yeniden üretmek yerine yalnızca o parçayı ayarlarsınız. Bir blok oluşturun, gözden geçirin, iyileştirin, sonra bir sonrakine geçin. Tam sayfa isteği gürültü üretir; bileşen isteği sinyal üretir.
Bir özellik bölümü oluşturun: ortalanmış bir başlık, ardından yan yana üç kart; her birinde bir simge, bir başlık ve tek satırlık bir açıklama olsun. Yumuşak gölgeler, hover durumunda hafif yükselme.
Gerçek kelimeler kullanın
Yer tutucu metin sorunları gizler; gerçek metin onları ortaya çıkarır. Gerçek bir başlık iki satıra ihtiyaç duyabilir; gerçek bir CTA ise fiil olarak daha iyi çalışabilir. Kullanıcının gerçekten okuyacağı şeyi yazın; taslak olsa bile, içerik gerçek olduğunda yerleşimler, boşluklar ve tasarım kararları daha iyi hale gelir.
Hero başlığı: “Design Calmly.” Alt metin: “Turn stress into structure.” CTA: “Start Building Free.” Metin odaklı yerleşim ve cömert dikey boşluk kullanın.
Gerçek öğeleri adlandırın
Sayfada ne istediğinizi tanımlamak için açık ve belirgin kelimeler kullanın. Tasarım terminolojisini bilmeniz gerekmez — kullanıcıların görmesi veya etkileşime girmesi gereken şeyleri adlandırmanız yeterlidir; örneğin bir profil kartı, bir düğme veya bir form.
Belirli istekleri oluşturmak, geniş kapsamlı olanlara göre daha kolaydır. İhtiyacınız olan temel öğeyle başlayın, ardından ayrıntıları teker teker ekleyin.
Fotoğraf, ad ve takip et düğmesi içeren bir profil kartı oluşturun. Adın yanına küçük bir “Verified” etiketi ekleyin ve biri üzerine geldiğinde kısa bir açıklama gösterin.
Adım 3: Hassasiyetle değiştirin
Her değişikliğin kapsamını belirleyin: ne değişecek, ne kalacak
Mevcut çalışmayı ayarlarken, her iki tarafı da açıkça belirtin: ne değişmeli ve ne değişmemeli. “Bunu daha iyi yap” yerine “değiştir”, “güncelle” ve “ayarla” gibi yönlendirici kelimeler kullanın ve beğendiğiniz kısımları sınırlandırın. Buradaki hassasiyet, yinelemenin gerilemeye dönüşmesini engeller.
CTA metnini “Get Started” olarak değiştirin ve yatay iç boşluğunu artırın. Mevcut renkleri, yazı tipini ve bu bölümdeki diğer her şeyi değiştirmeden bırakın.
Her seferinde tek bir anlamlı değişiklik yapın
Önce metni, sonra yerleşimi, sonra etkileşimleri güncelleyin ve bir sonraki isteğe geçmeden önce her sonucu kontrol edin. Küçük ve bilinçli adımlar cilalı bir ürüne dönüşür; tek bir mesajdaki on değişiklik ise belirsizliğe dönüşür ve bir şey ters gittiğinde buna hangi değişikliğin neden olduğunu bilemezsiniz.
Görev ortasındaki düzeltmeler sohbette yapılır. İstem Kuyruğu sohbetinizde kullanılabiliyorsa ve Agent çalışması etkinse, takip mesajları devam eden çalışmanın arkasında kuyruğa alınır. Başka bir kopya göndermeden önce mesajınızın kuyrukta göründüğünü doğrulayın. Kuyruk denetimleri görünmüyorsa yeniden göndermeyin: mevcut çalışmanın bitmesini bekleyin veya sohbetiniz bunu sağlıyorsa bir kesme denetimi kullanın, ardından takip mesajı göndermeden önce görev durumunu doğrulayın. Ayrıntılar için Project chat bölümüne bakın.
Arayüzün bir adım ötesini düşünün
Projenizin yalnızca cilalı görünmekten fazlasını yapması gerekiyorsa, görünümle birlikte davranışı da tanımlayın. Kullanıcıların oturum açtığında veya kapattığında ne gördüğünü, dinamik içeriğin nereden geldiğini ve arayüzün boş, yükleniyor ve hata durumlarını nasıl ele aldığını belirtin. Bu senaryolar etrafında tasarım yapmak için çalışan bir backend'e ihtiyacınız yoktur — bunları erken planlamak, daha sonra büyük UI yeniden çalışmalarını önlemeye yardımcı olur.
Kullanıcının oturumu açıksa, sağ üstte avatarını ve adını gösterin. Değilse, auth ekranına yönlendiren bir “Log In” düğmesi gösterin.
SSS
AI agent için etkili bir istemi nasıl yazarım?
İsteminizi şu temel öğelerle yapılandırın:
1. Bağlam — Sahneyi kurun. Ne oluşturduğunuzu ve şu anda durumun ne olduğunu açıklayın.
2. Hedef — İstediğiniz tam sonucu veya özelliği açıkça belirtin.
3. Gereksinimler ve Kısıtlamalar — Neyin değişmesi gerektiğini ve neyin dokunulmadan kalması gerektiğini net şekilde listeleyin.
4. Beklenen Sonuç — Başarının neye benzediğini tanımlayın (ör. UI davranışı, hata işleme, durumun kalıcılığı).
5. Referanslar — Mümkün olduğunda ekran görüntüleri, bağlantılar, iş akışı adımları veya kod örnekleri ekleyin. Paylaşmadan önce parolaları, doğrulama kodlarını, API anahtarlarını, çerezleri, kişisel verileri ve ödeme ayrıntılarını kaldırın.
Örnek: "Kenar çubuğu olan bir kontrol paneli oluşturuyorum. Kenar çubuğunun altına bir çıkış düğmesi ekleyin. Oturumu temizlemeli ve /login adresine yönlendirmeli. Kenar çubuğu düzenini veya gezinme bağlantılarını değiştirmeyin. Tıklandıktan sonra kullanıcı 1 saniye içinde giriş sayfasını görmeli."
Birden fazla özelliği içeren karmaşık istekleri nasıl ele almalıyım?
Karmaşık isteklerde, bunları daha küçük görevlere bölün:
1. Mevcut sorunu ve nihai hedefi belirtin.
2. Her alt görevi ayrı ayrı listeleyin (görev 1, görev 2, görev 3).
3. Sonrakine geçmeden önce her görevi doğrulayın.
4. En sonda tam akışı test edin.
Bu yaklaşım, Agent'tan aynı anda çok fazla şey yapmasını istemekten kaynaklanan beklenmedik değişiklikleri azaltır. Her istem, tek ve doğrulanabilir bir sonuca odaklanmalıdır.
Bir hatayı düzeltmek için nasıl istem yazarım?
Kullanışlı bir hata düzeltme istemi şunları içermelidir:
- Sayfa, özellik, ortam ve etkilenen kullanıcılar
- Sorunu yeniden üretmek için tam adımlar
- Gerçek davranış ve beklenen davranış
- Hatanın tam metni ve ne zaman oluştuğu
- İlgili ekran görüntüleri veya günlükler; parolalar, jetonlar, çerezler, kişisel veriler ve ödeme ayrıntıları kaldırılmış olmalıdır
- Neyin değişmeden kalması gerektiği
- Düzeltmenin nasıl doğrulanacağı ve hangi regresyon kontrollerinin çalıştırılacağı
Örnek: “Preview içindeki ödeme sayfasında, Submit seçildiğinde 500 hatası dönüyor. Beklenen: sipariş onaylanır ve kullanıcı teşekkür sayfasına ulaşır. Yeniden üretim: [adımlar]. Sepet toplamlarını veya ödeme akışını değiştirmeden nedeni düzeltin, ardından bir başarılı ve bir reddedilmiş ödeme durumunu doğrulayın. Ekli günlükten tüm gizli değerleri kaldırdım.”
Sayfa düzenini veya stilini değiştirmek için nasıl istem yazarım?
Sayfa değişiklikleri isterken şunları ekleyin:
1. Değiştirilecek belirli sayfa, modül ve öğe.
2. Mevcut durum ve hedef sonuç.
3. Referans bağlantıları veya ekran görüntüleri.
4. Değişmeden kalması gereken özellikler.
5. Kabul kriterleri (ör. hem masaüstünde hem mobilde çalışmalı).
Örnek: " /pricing sayfasında, plan kartı ızgarasını masaüstünde 2 sütundan 3 sütuna değiştirin. Mobil düzeni tek sütun olarak koruyun. Bu ekran görüntüsünü referans alın [ekleyin]. Kart içeriğini veya düğme stillerini değiştirmeyin."
Düzeltmelere rağmen agent sürekli yanlış değişiklikler yapıyorsa ne yapmalıyım?
Agent tekrar tekrar hedefi kaçırıyorsa, daha fazla talimat eklemek bazen daha fazla kafa karışıklığına yol açabilir. Bunun yerine:
1. Mevcut durumu koruyun — Çakışan düzeltmeler göndermeyi bırakın. Sohbetinizde bir Revert denetimi görünüyorsa, kullanmadan önce onay metnini okuyun, korumanız gereken sonraki değişiklikleri not edin ve ardından projeyi doğrulayın. Kapsam net değilse devam etmeyin; Project chat yönergelerini kullanın veya sansürlenmiş bir Chat Link ve ekran görüntüsüyle Destek ekibiyle iletişime geçin.
2. Gürültüyü temizleyin — Üstüne ek talimatlar bindirmek yerine, temel sorunu baştan temiz bir şekilde yeniden ifade edin.
3. Her seferinde tek görev — Devam etmeden önce tek bir sorunu çözmeye odaklanın.
Bir adım geri çekilip değişiklikleri kademeli olarak ele almak, genellikle tek bir istemde birden fazla çakışan sorunu çözmeye çalışmaktan çok daha hızlı şekilde sorunları çözer.