Co to są Agent Skills?
Autor: Redakcja Domeny.ForSale Opublikowano
W skrócie: Agent Skills to pakiety instrukcji, materiałów pomocniczych i opcjonalnych skryptów, które agent AI może wykorzystywać do konkretnych zadań. Zamiast za każdym razem tłumaczyć mu firmową procedurę, można zapisać ją jako skill, czyli umiejętność dostępną do ponownego użycia. Taki pakiet nie trenuje modelu i sam w sobie nie daje mu nowych uprawnień — podpowiada, jak wykonać pracę przy użyciu dostępnych narzędzi.
Z czego składa się Agent Skill?
Agent AI to system oparty na modelu językowym, który może planować kolejne kroki i korzystać z narzędzi, na przykład odczytywać pliki lub uruchamiać kod. Skill dostarcza mu uporządkowanej wiedzy o określonym zadaniu: kiedy je podjąć, jak postępować i po czym rozpoznać poprawny wynik.
W formacie Agent Skills centralnym elementem pakietu jest plik SKILL.md. Zawiera metadane, w tym nazwę i opis umiejętności, oraz właściwe instrukcje zapisane w Markdown. Obok mogą znajdować się skrypty, dokumentacja referencyjna, szablony i inne zasoby potrzebne podczas pracy.
Przykładowa struktura wygląda tak:
raport-kampanii/
├── SKILL.md
├── scripts/
│ └── sprawdz_dane.py
├── references/
│ └── definicje-metryk.md
└── assets/
└── szablon-raportu.md
W tym przykładzie SKILL.md opisuje sposób przygotowania raportu, dokument z metrykami wyjaśnia firmowe definicje, a skrypt sprawdza dane wejściowe. Nie każdy skill potrzebuje wszystkich tych elementów. Dla prostej procedury redakcyjnej wystarczy sam plik z instrukcjami.
Jak agent wybiera i uruchamia umiejętność?
Środowisko obsługujące Agent Skills może najpierw udostępnić modelowi tylko nazwy i krótkie opisy dostępnych umiejętności. Kiedy zadanie pasuje do konkretnego opisu, agent odczytuje pełną instrukcję, a następnie — jeśli to potrzebne — dodatkowe materiały. Taki sposób działania nazywa się stopniowym ujawnianiem informacji: szczegóły trafiają do kontekstu modelu dopiero wtedy, gdy są potrzebne.
Dzięki temu agent nie musi otrzymywać całej dokumentacji firmy przy każdym pytaniu. Opis umiejętności powinien jednak jasno wskazywać sytuacje jej użycia. „Pomaga w marketingu” jest mniej użyteczne niż „Przygotowuje miesięczny raport kampanii z pliku CSV według firmowych definicji wskaźników”.
Szczegóły zależą od aplikacji: umiejętność może zostać dobrana automatycznie albo wskazana przez użytkownika. Samo zapisanie katalogu na dysku nie oznacza, że dowolny chatbot go znajdzie i obsłuży. Miejsce instalacji, sposób aktywacji oraz obsługiwane elementy formatu trzeba sprawdzić w aktualnej dokumentacji danego narzędzia.
Czym skill różni się od promptu, narzędzia i MCP?
Prompt to polecenie przekazywane modelowi. Skill także zawiera instrukcje, ale opakowuje je w zasób do wielokrotnego użytku, z opisem zastosowania i ewentualnymi plikami pomocniczymi. Nie jest więc nowym modelem ani efektem jego dodatkowego treningu.
| Element | Główna rola | Przykład |
|---|---|---|
| Prompt | Określa bieżące zadanie | „Przygotuj raport za sierpień” |
| Skill | Opisuje sposób wykonania zadania | Procedura raportowania z definicjami metryk |
| Narzędzie | Wykonuje konkretną operację | Odczyt CSV lub wysłanie wiadomości |
| MCP | Standaryzuje udostępnianie narzędzi i zasobów aplikacji AI | Dostęp do danych z firmowego systemu |
MCP, czyli Model Context Protocol, może zapewniać połączenie z zewnętrznym systemem, natomiast skill wyjaśniać, jak wykorzystać dostępne dane w określonym procesie. Te rozwiązania mogą się uzupełniać. Instrukcja „pobierz wyniki z CRM” nie zapewni jednak dostępu do CRM, jeśli agent nie ma odpowiedniego połączenia i uprawnień.
Kiedy Agent Skills mają praktyczny sens?
Najlepszym kandydatem jest powtarzalne zadanie, które ma rozpoznawalny początek, określone reguły i sprawdzalny rezultat. Może to być przegląd kodu według zasad zespołu, przygotowanie dokumentu z szablonu albo kontrola jakości danych. Jednorazowe pytanie zwykle nie uzasadnia tworzenia osobnego pakietu.
Załóżmy, że zespół co miesiąc analizuje eksport wyników kampanii. Skill może nakazywać sprawdzenie kolumn, rozpoznanie waluty, obliczenie wskaźników według ustalonych definicji i przygotowanie raportu w stałym układzie. Powinien też określać, co zrobić przy brakujących danych — na przykład poprosić o uzupełnienie pliku zamiast zgadywać wartości.
Aby przygotować pierwszą umiejętność:
- Wybierz jedną procedurę, którą dziś regularnie wyjaśniasz agentowi.
- Opisz dane wejściowe, kolejne kroki i oczekiwany wynik.
- Dodaj warunki zatrzymania pracy, takie jak brak wymaganej kolumny.
- Dołącz wyłącznie potrzebne szablony lub materiały referencyjne.
- Przetestuj pakiet na poprawnym przykładzie oraz na danych niepełnych lub błędnych.
Oceniaj nie tylko wygląd odpowiedzi, ale też poprawność obliczeń, przestrzeganie ograniczeń i reakcję na braki. Sam fakt użycia skilla nie gwarantuje prawidłowego rezultatu.
Jak bezpiecznie korzystać z cudzych skills?
Pakiet pobrany z zewnątrz traktuj jak obcy kod i obcą instrukcję operacyjną. Przeczytaj SKILL.md, sprawdź skrypty oraz wymagane zależności. Zwróć szczególną uwagę na polecenia wysyłające dane do sieci, usuwające pliki lub odczytujące sekrety.
Skill nie przyznaje uprawnień, ale może nakłonić agenta do niewłaściwego wykorzystania tych, które już ma. Uruchamiaj nieznane pakiety w izolowanym środowisku, z minimalnym dostępem do plików i usług. Operacje takie jak publikacja, wysyłka wiadomości czy zmiana danych produkcyjnych powinny wymagać odpowiedniej kontroli, a nie tylko deklaracji zapisanej w instrukcji.
Na początek wybierz procedurę wykonywaną na kopii danych, bez możliwości publikowania lub usuwania plików. Dopiero po sprawdzeniu wyników zdecyduj, czy umiejętność powinna dostać dostęp do rzeczywistego procesu.
Zobacz też: Co to jest MCP?
Przeczytaj także
