Wytyczne dotyczące treści projektu umiejętności
Postępuj zgodnie z poniższymi wytycznymi, aby ułatwić sobie projektowanie umiejętności i zapewnić użytkownikom umiejętności, które są spójne i łatwe w użyciu.
- Nazwa umiejętności
- Tytuł formularza umiejętności
- Opis umiejętności
- Ikona Kwalifikacja
- Dane wejściowe umiejętności
- Dane wyjściowe umiejętności
- Frazy umiejętności
- Sugeruj następne kroki
- powiadomienia
- Uwagi dotyczące stylu
Nazwa kwalifikacji
Nazwa umiejętności, zwana również tytułem umiejętności, musi informować użytkownika o zamiarze umiejętności. Innymi słowy, co użycie umiejętności robi dla użytkownika.
- Wyślij (komendę) an (artykuł) email (rzeczownik)
- Find (verb) candidates (rzeczownik w liczbie mnogiej)
Dobrze nazwana umiejętność wskazuje działanie i rozpoczyna się od czasownika.
Przepływ umiejętności koncentruje się na wyniku: celu, jakim jest użycie grupy umiejętności.
Nazwa umiejętności pojawia się w wielu miejscach:
- Kafle umiejętności w katalogu umiejętności
- Kafelki umiejętności na stronie głównej
- Tytuły formularzy kwalifikacji
- Strona umiejętności zespołu
- Budowanie i podnoszenie kwalifikacji
Istnieją dwa typy kafli umiejętności, w których pojawia się nazwa umiejętności:


DOs i DON ' Ts
Na podstawie tych sprawdzonych procedur można utworzyć nazwę umiejętności na podstawie następujących nazw: "DOs" i "DON ' Ts".
DOS

- Upewnij się, że nazwy umiejętności są napisane w Verb + rodzajniku nieokreślonym + rzeczowniku.
- Upewnij się, że nazwy umiejętności są oparte na działaniach lub zamiarach.
- Używaj wielkich liter w stylu zdań.
- Nazwy umiejętności powinny być krótkie, ale znaczące.

DON ' Ts
- Nazwy umiejętności nie powinny być zbyt długie, aby można je było przejść do następnego wiersza lub zostać obcięte.

- Nie należy używać kropek, znaków podkreślenia ani myślników zamiast spacji.

- Nie używaj wszystkich czapek.

- Nie należy tworzyć nazw umiejętności na podstawie ich funkcji.

Tytuł formularza kwalifikacji
W przypadku tytułu formularza umiejętności należy używać przypadku zdania i używać tylko pierwszej litery wielkiej litery.
DOs i DON ' Ts
Podczas tworzenia tytułu formularza kwalifikacji należy wziąć pod uwagę następujące DOs i DON ' Ts.
DOS

Jako tytułu pola wejściowego należy używać słowa Sentence case, w którym tylko pierwsza litera pierwszego słowa jest zapisana wielkimi literami.
DON ' Ts
- Nie należy używać wszystkich wielkich liter w tytule pola wejściowego.

Nie należy używać łacińskich terminów, takich jak via, np.
Nie należy używać znaków podkreślenia zamiast spacji.

Opis kwalifikacji
Linia poniżej nazwy umiejętności jest "Opis" w pliku .yaml lub .json, ale tak naprawdę nie jest to opis. Ten tekst jest kontynuacją nazwy umiejętności, aby dostarczyć więcej informacji, w nie więcej niż 15 słów (jedno zdanie), o umiejętności, do czego jest używana, lub o tym, w jaki sposób ta umiejętność przyczynia się do osiągnięcia ogólnego celu.
Jeśli tekst jest zbyt długi (zawiera "..."), Użytkownik musi umieścić nad nim wskaźnik myszy, aby wyświetlić pole podpowiedzi, które zawiera pozostałą część tekstu.
Przykład:

Opis kwalifikacji pojawia się w wielu miejscach, na przykład w następujących przykładach. Podczas pisania opisów należy wziąć pod uwagę położenie opisu i dostępne miejsce:
- Kafle umiejętności w katalogu
- Tytuły formularzy kwalifikacji
- Strona Umiejętności
- Budowanie i podnoszenie kwalifikacji
DOs i DON ' Ts
Podczas tworzenia opisu kwalifikacji należy wziąć pod uwagę następujące DOs i DON ' Ts.
DOS
- Należy podać użytkownikom więcej informacji o umiejętnościach, ale pozostawić opis pusty, jeśli nie ma więcej informacji do dodania.

DON ' Ts
- Nie należy używać nazwy umiejętności jako opisu, co oznacza, że jeśli nie ma nic więcej do powiedzenia, należy pozostawić opis pusty zamiast powtarzać nazwę umiejętności.

Ikona kwalifikacji
Każda kwalifikacja musi mieć co najmniej jedną ikonę. Ta ikona reprezentuje aplikację lub aplikacje, które są używane do uruchamiania kwalifikacji. Jeśli używanych jest wiele aplikacji, do kwalifikacji przypisywanych jest wiele ikon.
Ikona kwalifikacji pojawia się w wielu miejscach. Podczas określania wielkości ikony, która ma być używana, należy wziąć pod uwagę ich położenie:
- Kafle umiejętności w katalogu umiejętności
- Kafelki umiejętności na stronie głównej
- Tytuły formularzy kwalifikacji
- Budowanie i podnoszenie kwalifikacji
Istnieją dwa rozmiary ikony:


DOs i DON ' Ts
Podczas dodawania ikony kwalifikacji należy wziąć pod uwagę następujące elementy: DOs i DON ' Ts.
DOS
- Używaj ikon umiejętności, które są wyraźnie widoczne.
![]()
- Użyj certyfikowanych ikon umiejętności. Przed użyciem tej ikony należy skonsultować się z działem prawnym i działem treści.
![]()
- Użyj zaktualizowanych i najnowszych ikon.
![]()
DON ' Ts
- Nie używaj ikon umiejętności, które są trudne do odczytania. Ikona w tym przykładzie zawiera dodatkowy tekst, który byłby trudny do wyświetlenia.
![]()
- Nie używaj żadnych losowych ikon do reprezentowania umiejętności, tylko ikon aplikacji używanych w tej umiejętności.
![]()
- Nie należy używać starej wersji ikony.
![]()
Dane wejściowe umiejętności
Tytuły pól i tekst programu pomocy
Wiele umiejętności wymaga od użytkowników wypełnienia formularza składającego się z pól (zwanych również parametrami, właściwościamilub wartościami).
Aby zapewnić spójność, należy postępować zgodnie z poniższymi wytycznymi dotyczącymi stylu w plikach .json i .yaml dla swoich kwalifikacji.
Poniżej przedstawiono czynności do wykonania dla tytułów pól.
DOS
Tytuły pól
Tytuły pól są krótkie, najlepiej mniej niż 4 słowa.
Upewnij się, że tytuły pól mają sens z perspektywy użytkownika, a nie z perspektywy technicznej.
Tytuły pól są pisane wielkimi literami w stylu zdania, co oznacza, że tylko pierwsza litera lub pierwsze słowo jest pisane wielką literą. Wyjątkiem są inicjały, takie jak adres URL. Te słowa muszą być we wszystkich czapkach.

- Należy szanować różnice kulturowe, zmieniając "Imię" na "Imię" i "Nazwisko" na "Nazwisko" w pliku .json lub .yaml.

Program pomocy pola i tekst zastępczy
Tekst programu pomocy udostępnia użytkownikowi dodatkową pomoc lub kontekst. Często używany w celu wyjaśnienia poprawnego formatu danych, tekst zastępczy zawiera wskazówki lub przykłady wprowadzenia.
DOs i DON ' Ts
Rozważmy następujące elementy: DOs i DON ' Ts dla programu pomocy i tekstu zastępczego.
DOS
Zachowaj skrócony tekst programu pomocy. Po pierwszym zdaniu kod ukryje resztę tekstu w odsyłaczu Pokaż więcej.
Skup się na tym, czym jest właściwość, a nie na tym, co robi. Pomiń słowo "określa" lub "wskazuje" przed "czy".
title: Allow
description: określa, czy ...Należy pominąć słowo "czy" z słowem "czy", ponieważ termin "czy" oznacza "czy".
Należy unikać ukośników, ponieważ są one niejednoznaczne (mogą oznaczać "i" lub "lub"):
Stan/prowincja
powinna mieć wartość
Stan lub prowincjaPunkty końcowe HTTP/HTTPs
powinny być
punktami końcowymi HTTP lub HTTPs

- Zamiast powtarzać tytuł pola jako opis, należy pozostawić opis pusty, umieszczając dwa znaki cudzysłowu w pliku .json lub .yaml: ""

DOS
- Nie dołączaj opisu, gdy opis powtarza tytuł pola, ale nie mówi nic innego. Zamiast tego należy użyć dwóch podwójnych cudzysłowów ("") w pliku .json lub .yaml.

Pole wejściowe
Użyj odpowiednio jednowierszowych i wielowierszowych pól tekstowych.


Pola wymagane i opcjonalne
W projekcie formularza wymagane pola są wyświetlane u góry, a pola opcjonalne w sekcji Pokaż więcej . Pola należy uporządkować w taki sposób, aby wymagane pola były wyświetlane u góry, a pola opcjonalne-u dołu, w sekcji Pokaż więcej .

Weryfikacja pola
Weryfikację pola należy przeprowadzić w sytuacjach, unikając konieczności kontynuowania pracy przez użytkownika, ponieważ wpis jest niepoprawny.
Istnieją dwa typy weryfikacji pól:
- Błąd
- Ostrzeżenie

Sugestia automatycznego zakończenia
Po wybraniu lokalizacji przez użytkownika pozostałe pola, takie jak Miejsce publikacji i Kraj zadania , są wypełniane automatycznie.

Komponent tabeli-selektory
Użyj odpowiednich selektorów (tabela).
Podczas dodawania selektorów do tabeli należy wziąć pod uwagę następujące elementy DOs.
DOS
- Aby użytkownik mógł wybierać wiele elementów, należy użyć pól wyboru.

- Użyj przełącznika, aby umożliwić użytkownikowi wybranie jednego elementu.

Komponent nagłówka tabeli
Zachowaj zwięzły nagłówek tabeli, najlepiej nie więcej niż 6 słów.
Podczas dodawania nagłówka do tabeli należy wziąć pod uwagę następujące elementy.
DOS
- Upewnij się, że w tytułach tabel danych używane są wielkie litery w stylu zdań, w których tylko pierwsza litera jest zapisana wielkimi literami.

- Nie zezwalaj, aby tytuł tabeli danych był dłuższy niż jeden wiersz.

Komponent tabeli-opis
Dołącz opis tabeli, ale tylko wtedy, gdy dodaje więcej informacji.
DOs i DON ' Ts
Podczas dodawania nagłówka do tabeli należy wziąć pod uwagę następujące elementy DOs i DON ' Ts.
DOS
- Skróć opis tabeli.

DON ' Ts
- Opis tabeli nie może być dłuższy niż jeden wiersz.

- Nie dołączaj go, jeśli powtarza nagłówek tabeli.
Dane wyjściowe kwalifikacji
Dane wyjściowe umiejętności, czasami nazywane "odpowiedziami", to informacje, które są zwracane po użyciu umiejętności przez użytkowników. Dane wyjściowe odpowiadają podanym danym wejściowym. Jest on prezentowany użytkownikom w obszarze konwersacji nad paskiem rozmowy sieciowej. To, czym są dane wyjściowe, zależy w pełni od tego, do czego są używane umiejętności.
Dane wyjściowe pojawiają się w różnych punktach wykorzystania umiejętności i są wyświetlane naszym użytkownikom jako pochodzące z platformy. Wyobraź sobie, że jest rozmowa dzieje się i pisać odpowiedzi wyjściowe, które czytają, że jest rozmowa dzieje się z użytkownikiem, ale nie używać pierwszej osoby ("zrobiłem x dla ciebie").
Gdy użytkownicy wybierają umiejętność z katalogu umiejętności i korzystają z niej (klika przycisk Użyj), dane wyjściowe muszą potwierdzić wybór umiejętności i rozpocząć komunikację z procesem w celu ukończenia kwalifikacji.
Przykład
Co jest udostępniane użytkownikowi, gdy używana jest kwalifikacja
- Opinie tekstowe wraz z najlepszymi umiejętnościami

- Tabela danych wraz z kolejną najlepszą umiejętnością

- Powiadomienie o wzniesieniu toast za ukończenie kwalifikacji

Gdy umiejętność działa w tle

Przykładowy scenariusz
Użytkownik klika opcję Wyślij wiadomość e-mail, a następnie klika opcję Użyj. W ten sposób użytkownik wysyła do platformy żądanie wysłania wiadomości e-mail. W obszarze konwersacji zwraca "Jasne". Musisz tylko najpierw wypełnić ten formularz. " To samo zachowanie może wystąpić, jeśli użytkownik wpisał na pasku czatu "Wyślij wiadomość e-mail" lub inną frazę, która wyzwala tę umiejętność.
Po zakończeniu zadania użytkownik otrzymuje następujące dane wyjściowe:
- Wiadomość e-mail została pomyślnie wysłana na adres
rebeccas@example.com. - Wiadomość e-mail została pomyślnie wysłana do 3 kandydatów.
Przykładowe frazy
- Ok. Poniżej przedstawiono wersję roboczą tego, co można powiedzieć kandydatowi o urlopie rodzicielskim w GreyPine.
Na prośbę o zaplanowanie rozmów kwalifikacyjnych:
- Pomyślnie zaplanowano rozmowy kwalifikacyjne z 4 kandydatami.
- Oto szczegóły zaplanowanych wywiadów.
Jeśli kwalifikacja nie znajduje się w zestawie umiejętności:
- Ta umiejętność nie jest w zestawie umiejętności. Należy rozważyć następujące sugestie:
Podczas zapisywania danych wyjściowych (odpowiedzi) należy wziąć pod uwagę następujące elementy: DOs i DON ' Ts.
DOs i DON ' Ts
DO
- Napisz aktywny głos (temat + czasownik, w tym przypadku "Anulowałeś"). Należy zwrócić uwagę na pisownię słowa "anulowano". Angielski (Stany Zjednoczone) to jeden l.


Napisz odpowiedzi, które brzmią podobnie do tych, które można by powiedzieć przełożonemu, gdy zostanie wyświetlona prośba o wykonanie zadania.
- Oczywiście. Najpierw należy wypełnić ten formularz.
- Wysyłanie wiadomości e-mail ...
Klienty komunikują się z platformą watsonx , ale nie z jednostką cyfrową. Nie możemy używać osobistego zaimka "I" w odpowiedziach lub uosabiać odpowiedzi w jakikolwiek sposób. Pozdrowienia mówią "Sprawdź katalog umiejętności i chodźmy do pracy." a na pasku czatu jest napisane "Co chcesz zrobić?"

DON ' Ts
Chociaż nie możemy uosabiać wyników (odpowiedzi), możemy być konwersacyjne. Pomyśl, jak byś to powiedział, a potem wynoś się z odpowiedzi. Na przykład zamiast pisać "I sent the email.", write "Wiadomość e-mail została wysłana."

Nie pisz w biernym głosie (czasownik przez Ciebie, w tym przypadku "anulowany przez Ciebie").

Chociaż nie możemy uosabiać odpowiedzi, powinniśmy unikać brzmiących jak robot. Nie wspominaj o umiejętnościach, które są używane do wykonania zadania:
- "Dokończę umiejętność Wyślij e-mail."
- " Jasne. Ukończę dla Ciebie umiejętność {name of skill} . "

Frazy
Fraza jest to, co klient wpisuje w polu rozmowy sieciowej, aby znaleźć i wykorzystać umiejętności.
Fraza ma dwa kluczowe elementy: czasownik i rzeczownik.
Komenda
Nie każdy używa tego samego czasownika do opisania tego samego działania, więc burza mózgów może odnosić się do różnych sposobów, do których dana osoba może się odnosić do tego działania, które jest umiejętnością. Na przykład w przypadku umiejętności Wyślij wiadomość e-mail użytkownik może wpisać "Wiadomość e-mail ..." lub "Komunikat ...", za pomocą czasownika "email" lub "message" zamiast czasownika "send", aby wyzwolić tę umiejętność. Inny przykład: użytkownik może wpisać "Pobierz", jeśli chce uzyskać coś, na przykład listę kandydatów.
Im więcej czasowników używasz podczas tworzenia fraz, aby wyzwolić umiejętności, tym większe prawdopodobieństwo, że umiejętność zostanie znaleziona.
Rzeczownik
Rzeczownik jest osobą, miejscem lub rzeczą, i nie każdy odnosi się do rzeczy w ten sam sposób. Na przykład można nazwać coś "e-mail", ale ktoś inny może nazwać to "wiadomość" lub "notatka".
Im więcej synonimów (różne rzeczowniki, które oznaczają to samo) używasz podczas tworzenia fraz, aby wyzwolić umiejętności, tym większe prawdopodobieństwo, że umiejętność zostanie znaleziona.
Uwzględnij błędnie napisane słowa
Nie bój się błędnie napisanych słów. Nie chcemy, aby nasi użytkownicy nie znaleźli potrzebnych im umiejętności, ponieważ pisali zbyt szybko, nie zwracali uwagi na to, co pisali, lub nie znali poprawnej pisowni. Brainstorm wszystkie możliwe błędy tekstowe i uwzględnić je w swoich frazach.
DOs i DON ' Ts
Na podstawie tych sprawdzonych procedur można wygenerować frazy "DOs" i "DON ' Ts".
DOS
Uwzględnij błędy pisowni.
Dołącz tyle różnych czasowników, ile możesz sobie pomyśleć.
Dołącz dowolną liczbę różnych rzeczowników.
DON ' Ts
Mają krótką listę fraz. NLP generuje frazy dla Ciebie, jeśli nie masz przynajmniej 15-20 zwrotów.
Proponuj następne kroki
Zamiast pozostawić to użytkownikowi serwisu, pytając platformę: "Co chcesz zrobić dalej?" z pustym polem rozmowy sieciowej sugerować kolejne kroki, oferując kolejne opcjonalne umiejętności, których może potrzebować użytkownik usługi.
Poniższe obrazy są przykładami sugerowania kolejnych kroków:



DOs i DON ' Ts
Do sugerowania kolejnych kroków należy wziąć pod uwagę następujące elementy: "DOs" i "DON ' Ts".
DOS

- Napisz opcjonalne umiejętności, aby dopasować się do nazw umiejętności kliknięcie opcji wywoła (czasownik + artykuł + rzeczownik). Ten styl jest konwersacyjny.
- Czy sugerować umiejętności, które można sobie wyobrazić, że użytkownik używa po poprzednich umiejętności, jeśli zrobił sobie to, co platforma właśnie dla nich.
DON ' Ts

- Nie pisz opcjonalnie umiejętności bez artykułów, ponieważ to sprawia, że brzmią one bardziej technicznie i mniej konwersacyjnie.
- Nie sugeruj umiejętności, które nie mają nic wspólnego z ostatnią umiejętnością, która została użyta.
Powiadomienia
Powiadomienia wymagające podjęcia działań odnoszą się konkretnie do zadania lub umiejętności, których nie można wykonać z powodu błędu lub które wymagają danych wejściowych od użytkownika. Poniższe przykłady przedstawiają sposób pisania różnych typów powiadomień.
Przykłady
- "Dane wejściowe są wymagane do utworzenia opisu zadania." zamiast "Umiejętności tworzenia opisu stanowiska wymagają danych wejściowych."
- "Nie można utworzyć opisu zadania." Zamiast
The <name of skill>nie można było zakończyć. "
Pamiętaj, aby poinformować użytkowników, dlaczego nie można było wykonać czynności związanych z umiejętnością. Należy być przezroczystym w przypadku błędów, które mogły wystąpić, oraz, o ile to możliwe, udostępnić wskazówki ułatwiające użytkownikom rozwiązywanie tych błędów.
Powiadomienia informacyjne współużytkują aktualizację i nie wymagają działania.
Przykłady
- "Nowy użytkownik został dodany do zespołu."
- "Masz teraz dostęp do ..."
Puste powiadomienia o stanie są wyświetlane, gdy nie ma nic do wyświetlenia. Tytuł zawiera informacje o tym, co będzie w obszarze po zapełnieniu go danymi. Tekst poniżej tytułu informuje użytkowników, co mogą zrobić, aby zapełnić obszar.
Przykład
Rozpocznij od dodania umiejętności
Kliknij opcję Dodaj umiejętności , aby rozpocząć uzyskiwanie dostępu do umiejętności z różnych źródeł i ich rozszerzanie.
Należy zauważyć, że tytuł nie kończy się kropką.
Uwagi dotyczące stylu
Gdy ludzie piszą tekst, zapisują liczby jako liczby, niezależnie od tego, czy są od 1 do 9, czy od 10. Tak więc należy wskazać liczby jako liczby bez względu na ilość.
Jeśli nie możesz zasugerować umiejętności jako następnych kroków, napisz "Co chcesz zrobić dalej?" zamiast "Co chcesz zrobić dalej?" aby dopasować styl Watson Orchestrate i być bezpośrednim.