Korzystanie z umiejętności AI i zarządzanie nimi
Umiejętność to zestaw instrukcji wielokrotnego użytku, które Asystent inżyniera może wykonywać, aby realizować określone zadanie w bardziej spójny sposób. Umiejętność określa sposób wykonania konkretnego zadania inżynierskiego — jego cel, zakres, wymagane dane wejściowe i kolejne kroki — tak aby za każdym razem uzyskiwać spójny wynik, niezależnie od tego, kto i kiedy ją uruchamia, bez konieczności każdorazowego podawania tych samych instrukcji przez użytkownika.
Umiejętność można traktować jako:
-
Powtarzalny proces inżynierski
-
Standard organizacji zapisany w postaci możliwej do wykonania
-
Sposób na zebranie wiedzy eksperckiej i umożliwienie jej ponownego wykorzystania
Umiejętności są wywoływane automatycznie przez sztuczną inteligencję, która wybiera je i stosuje na podstawie Twojego zamiaru. Nie musisz zapamiętywać poleceń ani ręcznie wybierać umiejętności. Gdy wysyłasz wiadomość, Asystent inżyniera:
-
Analizuje Twój zamiar i bieżący kontekst.
-
Przegląda umiejętności dostępne w obszarze roboczym.
-
Porównuje Twoją prośbę z polem Short Description każdej umiejętności, aby ustalić, które z nich są odpowiednie.
-
Wybiera najlepiej dopasowaną umiejętność.
-
Postępuje zgodnie z polem Instructions umiejętności, aby wykonać zadanie.
-
Zwraca wynik do sprawdzenia.
Na przykład gdy wyślesz Rewrite these requirements using our company writing standard, Asystent inżyniera rozpoznaje zamiar (ujednolicenie wymagań), identyfikuje umiejętność, której krótki opis najlepiej pasuje do tej prośby, wykonuje zdefiniowane w niej instrukcje i zwraca poprawione wymagania.
Przykłady użycia umiejętności
-
Break Down Complex Requirements – analizowanie wybranych wymagań i dzielenie ich na mniejsze, niezależnie testowalne wymagania z zachowaniem pierwotnego zamiaru.
Przykładowe polecenie:
Break down these requirements. -
Apply Requirement Writing Standards – przeglądanie wymagań i przeredagowywanie ich zgodnie z obowiązującymi w organizacji wytycznymi dotyczącymi formułowania wymagań. Typowe kontrole obejmują wykrywanie niejednoznaczności, nieweryfikowalnych sformułowań, brakujących podmiotów i niejasnych kryteriów akceptacji.
Przykładowe polecenie:
Rewrite these requirements according to our requirement quality standard. -
Translate Requirements – tłumaczenie wymagań z jednego języka na inny z zachowaniem znaczenia technicznego, terminologii, identyfikatorów i odniesień zapewniających identyfikowalność.
Przykładowe polecenie:
Translate these requirements to German. -
Classify Requirements – stosowanie do wymagań schematu klasyfikacji obowiązującego w organizacji, obejmującego takie kategorie jak elektronika, mechanika, oprogramowanie, bezpieczeństwo funkcjonalne, cyberbezpieczeństwo lub inne taksonomie specyficzne dla firmy.
Przykładowe polecenie:
Classify these requirements according to our applicability model. -
Generate Verification Criteria – analizowanie wymagań i proponowanie metod weryfikacji, kryteriów akceptacji lub warunków testowych, które pozwalają wykazywać zgodność zawsze w ten sam sposób.
Przykładowe polecenie:
Generate verification criteria for these requirements. -
Summarize a Specification/Section/Group of Requirements – generowanie zwięzłego i uporządkowanego podsumowania specyfikacji, sekcji wymagań lub zestawu wymagań.
Przykładowe polecenie:
Summarize the selected requirements.
Zestaw dostępnych umiejętności jest zarządzany w oknie AI Skills, otwieranym po kliknięciu przycisku
w prawym górnym rogu panelu Engineering Assistant. W tym oknie możesz dodawać nowe umiejętności oraz zmieniać i usuwać istniejące.
-
Istniejące umiejętności są wyświetlane w sekcji Workspace Skills po lewej stronie okna. Umiejętności domyślne znajdują się pod nagłówkiem Default Skills (i są oznaczone na liście po lewej stronie ikoną kłódki – , natomiast umiejętności niestandardowe, utworzone przez użytkownika, znajdują się pod nagłówkiem Workspace Skills. Kliknij pozycję, aby wyświetlić szczegóły wybranej umiejętności.
-
Aby włączyć lub wyłączyć wybraną umiejętność, użyj opcji Skill Enabled / Skill Disabled na banerze u góry okna. Wyłączona umiejętność nie jest używana przez Asystenta inżyniera. Włączone umiejętności są oznaczone na liście po lewej stronie zieloną kropką , a wyłączone — pustym kółkiem
-
Aby dodać nową umiejętność, kliknij przycisk
w lewym dolnym rogu okna. Na liście pojawi się pozycja nowej umiejętności. Uzupełnij pola Name, Short Description i Instructions nowej umiejętności, a następnie kliknij przycisk
w prawym dolnym rogu.
Szczegółowe informacje o poszczególnych polach znajdziesz w rozwijanej sekcji Dobre praktyki definiowania umiejętności poniżej.
-
Aby utworzyć kopię istniejącej umiejętności, wybierz ją na liście, a następnie kliknij przycisk
w lewym dolnym rogu. Zostanie użyta oryginalna nazwa umiejętności z przyrostkiem COPY. -
Aby edytować istniejącą umiejętność niestandardową, wybierz ją na liście, zmień jej pola zgodnie z potrzebami, a następnie kliknij przycisk
w prawym dolnym rogu.
-
Aby usunąć istniejącą umiejętność niestandardową, wybierz ją na liście, kliknij przycisk
w prawym dolnym rogu, a następnie potwierdź usunięcie.
Dobre praktyki definiowania umiejętności
Dobrze zdefiniowana umiejętność pomaga sztucznej inteligencji zrozumieć dwie rzeczy:
-
Kiedy należy użyć umiejętności
-
Co sztuczna inteligencja powinna zrobić po uruchomieniu umiejętności
Informacje te są zawarte w trzech polach, z których każde pełni inną funkcję:
-
Name – pomaga rozpoznać umiejętność.
-
Short Description – pomaga sztucznej inteligencji zdecydować, kiedy umiejętność jest odpowiednia.
-
Instructions – określa sposób postępowania sztucznej inteligencji po wybraniu umiejętności.
Szczegółowe informacje o poszczególnych polach znajdziesz w poniższych sekcjach.
Nazwa
Name powinna być krótka, jasna i ukierunkowana na działanie. Powinna pomagać szybko zrozumieć, do czego służy dana umiejętność. Dobra nazwa zwykle opisuje działanie oraz rodzaj danych inżynierskich, na których pracuje umiejętność.
Dobra nazwa umiejętności powinna być:
-
Na tyle konkretna, by odróżniać daną umiejętność od innych
-
Na tyle krótka, by można ją było łatwo znaleźć wzrokiem na liście umiejętności
-
Skoncentrowana na głównym zadaniu wykonywanym przez umiejętność
-
Sformułowana w sposób naturalny i zrozumiały dla użytkowników
Unikaj zbyt szerokich lub ogólnych nazw. Jeśli nazwa mogłaby pasować do wielu różnych zadań, prawdopodobnie nie jest wystarczająco konkretna.
Krótki opis
Short Description pomaga AI zrozumieć, czego dotyczy umiejętność i kiedy należy ją uruchomić. To pole jest ważne, ponieważ nie musisz ręcznie wybierać umiejętności. Asystent analizuje Twój prompt, porównuje go z dostępnymi umiejętnościami i decyduje, czy dana umiejętność jest odpowiednia.
Dobry krótki opis powinien wyjaśniać:
-
Jakie zadanie wykonuje umiejętność
-
Jakiego rodzaju danych inżynierskich dotyczy
-
Kiedy należy jej używać
-
Jaki wynik ma zapewnić
Krótki opis powinien być zwięzły, ale nie ogólnikowy. Powinien zawierać wystarczająco dużo kontekstu, aby AI mogła odróżnić tę umiejętność od podobnych.
Słaby krótki opis wskazuje jedynie dziedzinę, której dotyczy umiejętność. Dobry krótki opis wyjaśnia konkretne zadanie, oczekiwany kontekst i sytuację, w której należy uruchomić umiejętność. Na przykład zamiast pisać, że umiejętność „pomaga w pracy z wymaganiami”, należy wyjaśnić, czy ocenia ona jakość wymagań, rozbija złożone wymagania na prostsze, tłumaczy ich treść, wykrywa sprzeczności, generuje kryteria weryfikacji czy wykonuje inne konkretne działanie.
Im lepiej krótki opis wyjaśnia cel umiejętności i kontekst jej użycia, tym trafniej asystent może zdecydować, kiedy ją zastosować.
Instrukcje
Instructions określają, co AI ma zrobić po wybraniu umiejętności. To najważniejsze pole pozwalające kontrolować zachowanie umiejętności. Krótki opis pomaga AI zdecydować, kiedy użyć umiejętności, natomiast instrukcje określają sposób jej działania.
Dobre instrukcje powinny zawierać jasne wskazówki krok po kroku. Powinny opisywać nie tylko wynik końcowy, lecz także sposób rozumowania i ograniczenia, których AI ma przestrzegać podczas jego tworzenia.
Instrukcje powinny wyjaśniać:
-
Co AI powinna przeanalizować w pierwszej kolejności – zanim asystent cokolwiek zmieni lub wygeneruje, powinien zazwyczaj zrozumieć zamysł inżynierski, kontekst, strukturę lub zależności.
-
Jakie kroki AI powinna wykonać – działanie należy podzielić na jednoznaczne kroki, aby wynik był powtarzalny i przewidywalny.
-
Co AI powinna zachować – może to obejmować pierwotny zamysł, identyfikatory wymagań, terminy techniczne, jednostki, wartości, ograniczenia, odniesienia, zakres zastosowania, hierarchię lub kontekst powiązań umożliwiających śledzenie.
-
Czego AI nie może robić – dobrze zdefiniowane umiejętności wyraźnie zabraniają AI wymyślania brakujących szczegółów inżynierskich, zmieniania zamysłu, wprowadzania nowych założeń lub stosowania zmian bez sprawdzenia przez użytkownika.
-
Jak AI powinna postępować w przypadku niepewności – jeśli brakuje informacji, są one niejednoznaczne lub niewystarczające, umiejętność powinna nakazywać AI wyraźne wskazanie problemu zamiast zgadywania.
-
Jaki format wyniku jest oczekiwany – umiejętność powinna określać, czy wynikiem ma być tabela, lista punktowana, przeredagowany tekst, podsumowanie, lista kontrolna czy raport o określonej strukturze.
Dobre instrukcje są szczególnie ważne w pracy inżynierskiej, ponieważ asystent może pracować z danymi wpływającymi na specyfikacje, walidację, decyzje projektowe lub dalsze wdrożenie. Umiejętność powinna więc kierować działaniem AI tak, aby była pomocna, ale nie nadmiernie pewna swoich odpowiedzi.
Inne uwagi
-
Celem nie jest napisanie długiego promptu. Celem jest określenie jasnej procedury działania dla AI.
-
Zadbaj o wąski zakres umiejętności
Umiejętność powinna dobrze wykonywać jedno powtarzalne zadanie.
Jeśli umiejętność próbuje robić zbyt wiele rzeczy, asystentowi trudniej jest ustalić, kiedy jej użyć, a użytkownikom trudniej zaufać wynikom. Na przykład jedna umiejętność nie powinna łączyć dekompozycji wymagań, tłumaczenia, oceny jakości, analizy powiązań umożliwiających śledzenie i generowania metod weryfikacji, chyba że działania te celowo stanowią część jednego ściśle określonego procesu.
Jeśli cel umiejętności wymaga wielu niepowiązanych działań, podziel ją na osobne umiejętności.
-
Jasno określ granice
Dobrze zdefiniowane umiejętności mają jasno określone granice.
Jest to szczególnie ważne podczas pracy z wymaganiami, specyfikacjami i danymi inżynierskimi. Asystent powinien wiedzieć, co wolno mu zmieniać, co powinien jedynie sugerować i czego nigdy nie wolno mu zakładać.
Przydatne ograniczenia obejmują:
-
Nie zmieniaj pierwotnego zamysłu inżynierskiego
-
Nie wymyślaj wartości, ograniczeń ani decyzji projektowych
-
Nie usuwaj identyfikatorów ani odniesień
-
Nie zakładaj brakujących metod weryfikacji
-
Nie wprowadzaj zmian automatycznie bez sprawdzenia przez użytkownika
-
Nie traktuj niejasnych informacji jako faktów
Jasne granice zmniejszają ryzyko uzyskania wiarygodnie brzmiących, ale błędnych wyników prac inżynierskich.
-
-
Określ format wyniku
Umiejętność powinna wskazywać AI, w jakiej formie ma zwrócić wynik.
Spójny format wyników ułatwia ich przeglądanie, porównywanie i ponowne wykorzystanie.
W zależności od umiejętności wynikiem może być:
-
Tabela
-
Lista punktowana
-
Przeredagowane wymaganie
-
Raport o określonej strukturze
-
Lista kontrolna
-
Podsumowanie
-
Lista proponowanych zmian
-
Zestaw pytań lub otwartych kwestii
Format wyniku powinien odpowiadać celowi umiejętności. Na przykład w przypadku umiejętności służących do przeglądu często dobrze sprawdzają się tabele z kolumnami zawierającymi problem, wyjaśnienie i zalecenie. W przypadku umiejętności służących do przeredagowywania tekstu często sprawdza się przedstawienie tekstu oryginalnego, proponowanej wersji i uzasadnienia.
-




