Wgrywasz do agenta plik ze skillem i agent ma nową umiejętność. Wygląda niegroźnie, ale każdy taki plik dokłada się do rachunku przy każdym pytaniu użytkownika — także wtedy, gdy agent wcale z niego nie korzysta. Jeśli budujesz agenta, który obsługuje kilka procesów, warto wiedzieć, co dokładnie czyta, zanim odpowie.
Z czego składa się skill?
Skill ma trzy części:
- nazwę,
- opis — po co jest i kiedy go użyć,
- instrukcję — co dokładnie ma zrobić, krok po kroku.
Gdzie skill pasuje wśród innych elementów agenta?
Agent w Copilot Studio składa się z czterech rodzajów elementów:
- Instrukcja — kim jest agent i w jakim kontekście działa. Jest zawsze.
- Wiedza (knowledge base) — dokumenty, na podstawie których agent odpowiada na pytania. Nie zawsze jest potrzebna.
- Narzędzia (tools) — akcje, które faktycznie coś wykonują: biblioteka w Pythonie, która tworzy PDF z wniosku urlopowego, albo Power Automate wysyłający maile i powiadomienia.
- Skille — opisy specyficznych, domenowych procedur, rozpisane krok po kroku.
Co agent czyta, zanim odpowie?
Agent nie czyta wszystkich skilli w całości. Czyta tabliczki — nazwy i opisy — i na ich podstawie wybiera, z którego skorzystać.
Wyobraź sobie rejestrację w przychodni. Przychodzi pacjent z wysypką na dłoniach. Na korytarzu są drzwi z tabliczkami: chirurg, endokrynolog, dermatolog. Rejestracja nie zagląda do każdego gabinetu, żeby sprawdzić, jak wygląda tam badanie — patrzy na tabliczki i kieruje pacjenta do dermatologa. Agent robi to samo z twoim pytaniem i opisami skilli.
Ile kosztuje skill? Trzy poziomy
- Katalog tabliczek — przy każdym pytaniu. Agent za każdym razem przegląda wszystkie dostępne tabliczki, chyba że instrukcja wprost wskazuje mu konkretny skill. Każdy podpięty skill to około 100 tokenów dokładanych do tokenów wejściowych każdej tury rozmowy. Przy 10 skillach to około 1000 tokenów na każde pytanie, zanim agent cokolwiek zrobi.
- Treść skilla — tylko po wybraniu. Gdy agent „otworzy drzwi gabinetu”, czyta całą zawartość skilla — maksymalnie około 5000 tokenów. Treść jest czytana dopiero wtedy, gdy skill zostanie wybrany.
- Dodatkowe pliki — na żądanie. Skill może zawierać skrypty, referencje i inne pliki. Agent wczytuje je dopiero wtedy, gdy wymaga tego instrukcja skilla — i wtedy dokładają kolejne tokeny.
Wniosek: z każdym podpiętym skillem rośnie poziom pierwszy, płacony przy każdym pytaniu. Skill, który w danym agencie nigdy nie zostanie użyty, to czysty koszt.
Jak zbudować skill zgodnie ze specyfikacją?
- Nazwa — małe litery i myślniki, maksymalnie 64 znaki.
- Opis — maksymalnie 1024 znaki.
- Instrukcja — w formacie Markdown, zalecane poniżej 500 linii.
Jeśli skill rośnie ponad tę granicę, zapytaj, czy nie obsługuje kilku procesów naraz. Specjalizacja medyczna z kilkoma podspecjalizacjami to raczej kilka osobnych skilli niż jeden ogromny.
Czy skill musi być jednym plikiem?
Nie, choć mało kto o tym mówi. Skill zwykle traktuje się jak pojedynczy plik Markdown, ale może być też paczką — folderem ze skryptami, referencjami i assetami. Skill do wniosków urlopowych mógłby mieć w assetach szablon wniosku, którego zawsze ma się trzymać, a w skryptach fragment kodu, który ten szablon obsługuje.
Jak napisać dobry opis?
Opis decyduje, czy agent w ogóle sięgnie po skill. Nazwa „obsługa urlopów” w agencie, który cały obsługuje urlopy, nic agentowi nie mówi. Dobry opis wygląda tak:
Dwa zdania: co skill robi i w jakich sytuacjach go użyć.
Czy da się skill wyłączyć?
W Copilot Studio — nie. Narzędzie albo serwer MCP to gotowy byt, który podpinasz i możesz wyłączyć. Skill to zbiór plików, a wszystkie podpięte skille są czytane, więc jedyny sposób to usunięcie skilla z agenta. Dlatego trzymaj skille osobno w projekcie, żeby po usunięciu nie budować ich od nowa.
Jak z tym żyć na co dzień?
W wielu firmach pierwszy agent powstaje „dla całego biura” i z miesiąca na miesiąc dostaje kolejne umiejętności na prośbę kolejnych działów. Po roku przy każdym pytaniu o urlop czyta też tabliczki od zamówień, floty i IT. Żeby do tego nie doszło:
- Trzymaj w agencie tylko skille, z których agent realnie korzysta.
- Zanim usuniesz skill, pobierz go.
- Nie trzymaj wersji roboczych na produkcyjnym agencie. Skill do zamawiania sprzętu IT podpięty pod agenta od wniosków urlopowych nic nie daje, a kosztuje.
- Ten sam skill w dwóch agentach to nie duplikat. Trzymaj bibliotekę skilli z boku i podpinaj je tam, gdzie są uzasadnione domenowo.
Instrukcja, wiedza, tool czy skill?
- Zasada ma obowiązywać zawsze, w każdej odpowiedzi → instrukcja agenta.
- Masz dokumenty źródłowe, z których agent ma cytować → wiedza.
- Agent ma coś wykonać → tool.
- Masz powtarzalną procedurę z wiedzą domenową → skill.
Najczęstszy błąd to wrzucanie wiedzy domenowej do głównej instrukcji. Instrukcja jest czytana w całości przy każdym pytaniu, a nie tylko jej „okładka”. To tak, jakby pracownik kadr przed odpowiedzią na każde pytanie czytał od deski do deski segregator z procedurami wszystkich działów.
Pięć najczęstszych błędów
- Opis napisany dla człowieka, nie dla agenta. Opis ma jasno mówić, do czego służy skill i kiedy go użyć.
- Treść skilla w głównej instrukcji. 300 linii procedur w instrukcji to koszt przy każdym pytaniu. Wydziel je do skilla.
- Jeden skill na wszystko. Jeśli skill robi się za duży, podziel go.
- Brak sprzątania. Niewykorzystywane skille na produkcji kosztują i wydłużają czas odpowiedzi, bo agent musi przejrzeć wszystkie tabliczki.
- Testowanie, czy skill działa, zamiast czy agent go wybiera. Sprawdzenie skilla w izolacji to za mało. Testuj na prawdziwych frazach użytkowników, czy opis prowadzi agenta do właściwego skilla we właściwym momencie.
Zanim dodasz kolejny skill, sprawdź, czy agent będzie go używał w tym konkretnym procesie. Jeśli nie — trzymaj go w bibliotece, nie w agencie.