Beceri tasarımı içerik yönergeleri
Beceri tasarımını kendiniz için daha kolay hale getirmek ve kullanıcılarınızın tutarlı ve kullanımı kolay beceriler yaşamasını sağlamak için bu yönergeleri izleyin.
- Beceri adı
- Beceri formu başlığı
- Beceri tanımı
- Beceri simgesi
- Beceri girişi
- Beceri çıktısı
- Beceri tümcecikleri
- Sonraki adımları öner
- Bildirimler
- Stil notları
Beceri adı
Beceri unvanı olarak da bilinen beceri adı, becerinin amacını kullanıcıya bildirmelidir. Başka bir deyişle, beceriyi kullanmak kullanıcı için ne yapar.
- (fiil) an (makale) email (isim)
- (fiil) adayları (çoğul isim) bulun
İyi adlandırılmış bir beceri, eylemi gösterir ve bir fiille başlar.
Bir beceri akışı, sonuca odaklanır: beceri grubunu kullanma hedefi.
Beceri adı birden çok yerde görüntülenir:
- Beceri kataloğundaki beceri döşemeleri
- Ana sayfadaki beceri döşemeleri
- Beceri formları başlıkları
- Ekip becerileri sayfası
- Becerilerin geliştirilmesi ve geliştirilmesi
Beceri adının görüntülendiği 2 beceri döşemesi tipi vardır:


DO 'lar ve DON' T ' ler
Bu en iyi uygulamalara dayalı olarak, bir beceri adı oluşturmak için aşağıda "DOS" ve "DON ' T" yer alır.
DOS

- Beceri adlarının Fiil + belirsiz makale + isimiçinde yazıldığından emin olun.
- Beceri adlarının eylem ya da amaca dayalı olduğundan emin olun.
- Cümle stili büyük/küçük harf kullanımı.
- Beceri adlarını kısa ama anlamlı kılın.

DON 'T' ler
- Bir sonraki satıra gitmesi ya da kesilmesi için beceri adlarını çok uzun süre yazmayın.

- Boşluk yerine nokta, alt çizgi ya da tire kullanmayın.

- Bütün kapakları kullanma.

- Beceri adlarını özelliğe dayalı yapma.

Beceri formu başlığı
Beceri formu başlığı için, tümce büyük/küçük harf kullanın ve yalnızca ilk harfi büyük harfle yazın.
DO 'lar ve DON' T ' ler
Bir beceri formu başlığı oluştururken aşağıdaki DOS ve DON 'T' leri göz önünde bulundurun.
DOS

Giriş alanı başlığı için, ilk sözcüğün yalnızca ilk harfinin büyük harfle yazıldığı Tümce harfini kullanın.
DON 'T' ler
- Giriş alanı başlığı için tüm büyük başlıkları kullanmayın.

Latince terimleri via, örn., vb. gibi kullanmayın.
Boşluk yerine alt çizgi kullanmayın.

Beceri açıklaması
Beceri adının altındaki satır, .yaml ya da .json dosyasındaki "Açıklama" dır, ancak gerçekte bir açıklama değildir. Bu metin, en fazla 15 sözcük (bir cümle), beceri, ne için kullanıldığı ya da bu becerinin genel hedefe nasıl katkı sağladığı hakkında daha fazla bilgi sağlamak için beceri adının bir devamı niteliğinde.
Metin çok uzunsa ("..."), Kullanıcının, metnin geri kalanını gösteren araç ipucu kutusunu göstermek için imleci üzerine getirmesi gerekir.
Örnek:

Beceri tanımı, aşağıdaki örnekler gibi birden çok yerde görünür. Açıklamaları yazarken açıklamanın yerini ve kullanılabilir alanı göz önünde bulundurun:
- Katalogdaki beceri döşemeleri
- Beceri formları başlıkları
- Beceri sayfası
- Becerilerin geliştirilmesi ve geliştirilmesi
DO 'lar ve DON' T ' ler
Beceri tanımı oluştururken aşağıdaki DOS ve DON 'T' leri göz önünde bulundurun.
DOS
- Kullanıcılara becerinin ne yaptığı hakkında daha fazla bilgi verin, ancak eklenecek başka bir şey yoksa açıklamayı boş bırakın.

DON 'T' ler
- Beceri adını açıklama olarak kullanmayın; yani, söylenecek başka bir şey yoksa, beceri adını yinelemek yerine tanımı boş bırakın.

Beceri simgesi
Her becerinin en az bir simgesi olmalıdır. Simge, beceriyi çalıştırmak için kullanılan uygulamayı ya da uygulamaları temsil eder. Birden çok uygulama varsa, beceriye birden çok simge atfedilir.
Beceri simgesi birden çok yerde görünür. Kullanılacak simgenin boyutunu belirlerken yerleşimlerini göz önünde bulundurun:
- Beceri kataloğundaki beceri döşemeleri
- Ana sayfadaki beceri döşemeleri
- Beceri formları başlıkları
- Becerilerin geliştirilmesi ve geliştirilmesi
Bir simgenin iki boyutu vardır:


DO 'lar ve DON' T ' ler
Beceri simgesi eklerken aşağıdaki DOS ve DON 'T' leri göz önünde bulundurun.
DOS
- Açıkça görülebilen beceri simgelerini kullanın.
![]()
- Sertifikalı beceri simgelerini kullanın. Simgeyi kullanmadan önce Yasal ve İçerik bölümüne danışın.
![]()
- Güncellenen ve en son simgeleri kullanın.
![]()
DON 'T' ler
- Okunması zor olan beceri simgelerini kullanmayın. Bu örnekteki simge, görmesi zor olacak ek metin içerir.
![]()
- Beceriyi temsil etmek için herhangi bir rasgele simge kullanmayın, yalnızca o beceride kullanılan uygulamaların simgeleri kullanın.
![]()
- Bir simgenin eski bir sürümünü kullanmayın.
![]()
Beceri girişi
Alan başlıkları ve yardımcı metin
Birçok beceri, kullanıcıların alanlardan ( parametreler, özelliklerya da değerlerolarak da bilinir) oluşan bir formu tamamlamalarını gerektirir.
Tutarlılığı sağlamak için becerileriniz için .json ve .yaml dosyalarında bu stil yönergelerini izleyin.
Alan başlıklarına ilişkin DOS ' ları göz önünde bulundurun.
DOS
Alan başlıkları
Alan başlıklarını kısa tutun, ideal olarak 4 sözcükten az.
Alan başlıklarının teknik bir bakış açısından değil, kullanıcı açısından anlamlı olduğundan emin olun.
Yalnızca ilk harfin ya da ilk sözcüğün büyük harfle yazılacağı anlamına gelen Tümce stili büyük harfle alan başlıkları yazın. Kural dışı durum, URL gibi kullanıma hazırdır. Bu kelimeler büyük büyük olmalı.

- .json veya .yaml dosyasında "Ad" ile "Ad" ve "Soyadı" ile "Soyadı" olarak değiştirerek kültürel farklılıklara saygı gösterin.

Alan yardımcısı ve yer tutucu metni
Yardımcı metin, kullanıcıya ek yardım ya da bağlam sağlar. Genellikle doğru veri biçimini açıklamak için kullanılır, yer tutucu metni, nelerin girileceği hakkında ipuçları veya örnekler sağlar.
DO 'lar ve DON' T ' ler
Yardımcı ve yer tutucu metni için DOS ve DON 'T' leri dikkate alın.
DOS
Yardımcı metni kısa tutun. İlk tümceden sonra kod, metnin geri kalanını daha fazla göster bağlantısında gizler.
Özelliğin ne olduğuna odaklanın, ne olduğuna değil. "Belirtim" ya da "Belirtim" den önce "Belirtir" ifadesini atlayın.
title:
açıklamaya izin ver:"İster" ile "olsun, ister olmasın" terimini atlayın, çünkü "olsun ya da olmasın" terimi "olsun ya da olmasın" anlamına gelir.
Eğik çizgiler belirsiz olduğundan ("ve" ya da "ya da" anlamına gelebilirler) kaçınma:
Eyalet/İl
,
İl ya da Bölgesi olmalıdırHTTP/HTTPs uç noktaları
şu olmalıdır:
HTTP ya da HTTPs uç noktaları

- .json ya da .yaml dosyasına iki çift tırnak işareti koyarak tanım olarak alan başlığını yinelemek yerine tanımı boş bırakın: ""

DOS
- Açıklama alan başlığını yineler, ancak başka bir şey söylemez. Bunun yerine iki çift tırnak işareti ("") kullanın Bunun yerine .json ya da .yaml dosyasında.

Giriş alanı
Tek ve çok satırlı metin alanlarını uygun şekilde kullanın.


Zorunlu ve isteğe bağlı alanlar
Form tasarımında, zorunlu alanlar üstte ve isteğe bağlı alanlar Daha fazla göster bölümünde gösterilir. Daha fazla göster bölümünde, zorunlu alanları en üstte, isteğe bağlı alanları en altta olacak şekilde alanlarınızı düzenleyin.

Alan doğrulaması
Bir giriş geçersiz olduğundan kullanıcının beceriye devam etmesini önler ve durumlarda alan doğrulaması yapılmalıdır.
İki tip alan doğrulaması vardır:
- Hata
- Uyarı

Otomatik tamamlama önerisi
Bir kullanıcı bir konum seçtikten sonra, Gönderi konumu ve İş ülkesi gibi diğer alanlar otomatik olarak tamamlanır.

Tablo bileşeni-seçiciler
Uygun seçicileri (tablo) kullanın.
Bir tabloya seçiciler eklerken aşağıdakileri göz önünde bulundurun:
DOS
- Kullanıcının birden çok öğe seçmesini istediğinizde onay kutularını kullanın.

- Kullanıcının bir öğe seçmesine izin vermek için bir radyo düğmesi kullanın.

Tablo bileşeni-üstbilgi
Tablo üstbilgisini kısa tutun, ideal olarak en fazla 6 sözcük.
Bir tabloya üstbilgi eklerken aşağıdakileri göz önünde bulundurun:
DOS
- Veri tablosu başlıklarının, yalnızca ilk harfin büyük harfle büyük harfe dönüştürüldüğü Tümce stilini kullandığından emin olun.

- Veri tablosu başlığının bir satırdan uzun olmasına izin vermeyin.

Çizelge bileşeni-açıklama
Yalnızca daha fazla bilgi eklediğinde, çizelgeye ilişkin bir açıklama ekleyin.
DO 'lar ve DON' T ' ler
Bir tabloya üstbilgi eklerken aşağıdaki DOS ve DON 'T' leri göz önünde bulundurun.
DOS
- Tablo açıklamasını kısa yapın.

DON 'T' ler
- Çizelge tanımlamasını birden çok satır yapma.

- Tablo üstbilgisini yineler ise bunu eklemeyin.
Beceri çıkışı
Beceri çıkışı (bazen "yanıtlar" olarak da adlandırılır), kullanıcılar beceri kullandıktan sonra döndürülen bilgilerdir. Bu çıkış, sağlanan girişin karşılığıdır. Sohbet çubuğunun üstündeki sohbet alanındaki kullanıcılara sunulur. Çıktının ne olduğu, yeteneğin ne için kullanıldığına tamamen bağlıdır.
Çıktı, beceri kullanımının çeşitli noktalarında ortaya çıkar ve kullanıcılarımıza platformdan geldiği gibi görünür. Bir konuşma olduğunu hayal edin ve çıktı yanıtlarını yazın, sanki kullanıcıyla bir konuşma yapıyormuş gibi, ama ilk kişiyi kullanma ("senin için x yaptım").
Kullanıcılar beceri kataloğundan bir beceri seçtiğinde ve bunu kullandığında (Kullan düğmesini tıklatır), çıktının beceri seçimini onaylaması ve beceriyi tamamlamak için süreci iletmeye başlaması gerekir.
Örnek
Beceri kullanıldığında kullanıcıya ne sağlanır
- Bir sonraki en iyi beceriyle birlikte metinli geribildirim

- Sonraki en iyi beceriyle birlikte veri tablosu

- Becerinin tamamlanmasıyla ilgili bir kadeh kaldırma bildirimi

Bir beceri arka planda çalıştığında

Örnek senaryo
Bir kullanıcı, E-posta becerisi gönder 'i tıklatır ve Kullan' ı tıklatır. Bunu yaparak kullanıcı, platformun bir e-posta göndermesini istiyor. Konuşma alanında, " Tabii. Önce bu formu doldurmanız gerekiyor. " Kullanıcı sohbet çubuğunda "E-posta gönder" ya da bu beceriyi tetikleyen başka bir sözcük grubu yazdıysa aynı davranış ortaya çıkar.
Görevi tamamladıktan sonra kullanıcı aşağıdaki çıktıyı alır:
- E-posta
rebeccas@example.comadresine başarıyla gönderildi. - E-posta 3 adaya başarıyla gönderildi.
Örnek sözcük grupları
- Tamam. Burada adaya GreyPine' den ebeveyn izni hakkında söyleyebileceklerin bir taslağı var.
Mülakatları zamanlamanız istendiğinde:
- 4 adayın mülakatları başarıyla planlandı.
- İşte planlı mülakatların ayrıntıları.
Beceri kümesinde bir beceri olmadığında:
- Bu yetenek yetenek setinde yok. Aşağıdaki önerileri göz önünde bulundurun:
Çıktı (yanıtlar) yazarken aşağıdaki DOS ve DON 'T' leri göz önünde bulundurun.
DO 'lar ve DON' T ' ler
DO
- Etkin sesle yazın (subject + fiil, bu durumda "İptal ettiniz"). "İptal edildi" yazımını not edin. ABD İngilizcesi bir "l" dir.


Bir görevi tamamlaması istendiğinde bunları yöneticinize söyleyecekmiş gibi gelen yanıtları yazın.
- Tabii ki. Önce bu formu doldurmanız gerekiyor.
- E-posta gönderiliyor ...
İstemciler watsonx platformuyla iletişim kurar, ancak dijital bir varlıkla iletişim kurmaz. Kişisel "I" zamirini hiçbir şekilde yanıtlar için kullanamayız veya yanıtları kişiselleştirmeyiz. Karşılama "Yetenek kataloğuna bak ve işe başlayalım." diyor. ve sohbet çubuğu "Ne yapmak istiyorsun?" diyor.

DON 'T' ler
Çıktıyı (yanıtları) kişileştirmesek de, sohbet edebiliyoruz. Bunu nasıl söyleyeceğinizi düşünün ve sonra kendinizi tepkiden çıkarın. Örneğin, "E-postayı gönderdim." yazmak yerine, "E-posta gönderildi." yazın.

Pasif sesle yazmayın (bu durumda "sizin tarafıdan iptal edildi").

Yanıtları kişiselleştirmesek de, robot gibi ses çıkarmaktan kaçınmalıyız. Bir görevi tamamlamak için kullanılan beceriyi belirtmeyin:
- "E-posta gönderme becerisini tamamlayacağım."
- " Elbette. Sizin için {name of skill} becerisini tamamlayacağım. "

Tümcecikler
Sözcük grupları, bir beceriyi bulmak ve kullanmak için istemcinin sohbet kutusuna ne yazacağını ifade eder.
Bir tümceciğin iki temel öğesi vardır: fiil ve isim.
Fiil
Herkes aynı eylemi tanımlamak için aynı fiili kullanmaz, bu yüzden bir kişinin bu eylemi yapmaya gönderme yapabileceği çeşitli şekillerde beyin fırtınası yapın. Örneğin, E-posta gönder becerisi için bir kullanıcı "E-posta ..." yazabilir. ya da "Mesaj ...", Bu beceriyi tetiklemek için "gönder" fiilinden ziyade "e-posta" ya da "ileti" fiilinin kullanılması. Başka bir örnek, bir kullanıcı bir şey almak istediğinde (örneğin, adayların listesi) "Al" yazabilir.
Becerileri tetiklemek için sözcük grupları oluştururken ne kadar çok fiil kullanırsanız, becerinin bulunma olasılığı da o kadar artar.
İsim
İsim, bir insan, yer ya da bir şeydir ve herkes olayları aynı şekilde ifade etmez. Örneğin, bir şeye "e-posta" diyebilirsiniz, ancak başka biri buna "mesaj" ya da "not" diyebilir.
Becerileri tetiklemek için sözcük grupları oluşturduğunuzda ne kadar çok eşanlamlı (aynı anlama gelen farklı isimler) kullanırsanız, becerinin bulunma olasılığı o kadar artar.
Yanlış yazılmış sözcükleri içer
Yanlış yazılmış kelimelerden korkma. Kullanıcılarımızın çok hızlı yazdıkları, ne yazdıklarına dikkat etmedikleri ya da doğru yazımı bilmedikleri için ihtiyaç duydukları beceriyi bulmamalarını istemiyoruz. Tüm olası metin hatalarını beyin fırtınası yapın ve bunları sözcük gruplarınıza ekleyin.
DO 'lar ve DON' T ' ler
Bu en iyi uygulamalara dayanarak aşağıdakiler, sözcük grupları oluşturmak için "DOS" ve "DON ' T" lerdir.
DOS
Yanlış yazım hataları ekleyin.
Düşünebildiğiniz kadar farklı fiil ekleyin.
Düşünebildiğiniz kadar farklı isim ekleyin.
DON 'T' ler
Kısa bir tümcecik listesi vardır. En az 15-20 sözcük grubu yoksa NLP sizin için sözcük grupları oluşturur.
Sonraki adımları öner
Platformu "Sırada ne yapmak istiyorsunuz?" diye sorarak hizmet kullanıcısına bırakmak yerine Boş bir sohbet alanından başka bir şey olmadan, hizmet kullanıcılarınızın gereksinim duyabileceği bir sonraki isteğe bağlı becerileri sunarak sonraki adımları önerin.
Aşağıdaki görüntüler, sonraki adımların nasıl önerileceğine ilişkin örneklerdir:



DO 'lar ve DON' T ' ler
Aşağıda, sonraki adımları önermek için "DOs" ve "DON ' Ts" ifadelerini göz önünde bulundurun.
DOS

- Çağrılacak seçenekleri tıklatan becerilerin adlarını eşleştirmek için isteğe bağlı beceriler yazın (fiil + makale + isim). Bu stil konuşmaktır.
- Kullanıcının önceki becerilerden sonra, platformun kendileri için yaptıklarını yaptıysa kullanabileceklerini hayal edebileceğiniz beceriler önerin.
DON 'T' ler

- Makaleler olmadan isteğe bağlı olarak beceri yazmayın çünkü bu onları daha teknik ve daha az konuşsal yapar.
- Son kullanılan beceriyle hiçbir ilgisi olmayan beceriler önerme.
Bildirimler
Eyleme dönüştürülebilir bildirimler, bir hata nedeniyle tamamlanamamış ya da kullanıcıdan giriş gerektiren bir görevle ya da beceriyle ilgilidir. Farklı bildirim tiplerinin nasıl yazılacağını öğrenmek için aşağıdaki örneklere bakın.
Örnekler
- "İş tanımlamasını yaratmak için girişiniz gereklidir." "İş tanımı yaratma becerisinin girişe ihtiyacı vardır."
- "İş tanımlaması yaratılamadı."
The <name of skill>yerine tamamlanamadı. "
Kullanıcılara becerinin eyleminin neden tamamlanamadığını söylediğinizden emin olun. Ortaya çıkmış olabilecek hatalar hakkında şeffaf olun ve mümkünse, kullanıcıların bu hataları çözmelerine yardımcı olmak için yol gösterici olun.
Bilgilendirici bildirimler bir güncelleştirmeyi paylaşır ve işlem gerektirmez.
Örnekler
- "Ekibinize yeni bir kullanıcı eklendi."
- "Artık ..."
Gösterilecek bir şey olmadığında boş durum bildirimleri görüntülenir. Başlık, veri yerleştirildikten sonra alanda ne olacağını iletir. Başlığın altındaki metin, kullanıcılara alanı doldurmak için neler yapabileceklerini gösterir.
Örnek
Beceri ekleyerek başlayın
Çeşitli kaynaklardan becerilere erişmeye başlamak ve bunları geliştirmek için Beceriler ekle seçeneğini tıklatın.
Başlığın bir nokta ile bitmediğini unutmayın.
Stil notları
İnsanlar metin yazdıklarında, sayıları 1-9 arası ya da 10 'dan büyük olmasına bakılmaksızın sayı olarak yazarlar. Miktarı ne olursa olsun sayıları sayı olarak belirtin.
Bir sonraki adım olarak beceri öneremiyorsanız, "Sırada ne yapmak istiyorsunuz?" yazın. "Şimdi ne yapmak istersin?" yerine. Watson Orchestra stiliyle eşleşmesi ve doğrudan olması için.