Custom Agents: własny Copilot do specyficznych zadań

Czego się nauczysz

• Kiedy custom agent ma sens, a kiedy wystarczy prompt file albo instructions
• Jak zbudowany jest plik .agent.md
• Jak używać toolsetów, handoffów i modeli do projektowania wyspecjalizowanych ról

Najgorszy custom agent to ten od wszystkiego

To bardzo częsty błąd.

Ludzie odkrywają custom agents i od razu próbują zbudować jednego super-agenta, który planuje, implementuje, recenzuje, odpala testy i jeszcze dba o bezpieczeństwo.

To zwykle kończy się przeciążonym toolsetem i rozmytą rolą.

Czym custom agent jest naprawdę

W aktualnej dokumentacji custom agent to trwała persona robocza zdefiniowana w pliku .agent.md.

Taki agent może określać:

• instrukcje zachowania
• dostępne narzędzia
• preferowany model
• dostęp do subagentów
• handoffy do kolejnych ról

To znaczy, że custom agent nie jest tylko zapisanym promptem. To środowisko wykonania dla konkretnego typu pracy.

Kiedy wybrać custom agenta

Najprostszy filtr jest taki:

• instructions: gdy reguły mają działać zawsze
• prompt file: gdy chcesz ręcznie odpalać workflow
• custom agent: gdy potrzebujesz trwałej roli z własnym zakresem narzędzi i zachowania

Jeśli zadanie wymaga zmiany narzędzi, modelu albo handoffów między rolami, custom agent jest sensownym wyborem.

Struktura pliku .agent.md

Dokumentacja pokazuje dwa główne elementy:

• YAML frontmatter
• body z instrukcjami agenta

W frontmatter najczęściej pracujesz z polami:

• name
• description
• argument-hint
• tools
• agents
• model
• user-invocable
• disable-model-invocation
• handoffs
• opcjonalnie hooks

Body jest miejscem na właściwą personę i zasady pracy.

Największa przewaga custom agenta: zawężenie narzędzi

To jest praktyczny rdzeń tematu.

Planner nie powinien mieć tego samego zestawu narzędzi co implementer. Reviewer bezpieczeństwa nie powinien działać tak samo jak agent od szybkiego prototypu.

Custom agent pozwala dopasować możliwości do roli.

To poprawia trzy rzeczy naraz:

• trafność działań modelu
• bezpieczeństwo
• przewidywalność workflow

Handoffs są ważniejsze niż wyglądają

Handoff to nie gadżet w UI. To sposób na budowanie sekwencyjnych workflow z kontrolą człowieka pomiędzy etapami.

Przykładowy przepływ wygląda tak:

• planner przygotowuje plan
• handoff do implementera startuje kodowanie
• handoff do reviewera odpala kontrolę jakości

To bardzo dobre rozwiązanie, bo nie próbujesz zmuszać jednej persony do robienia wszystkiego naraz.

Subagenci i custom agenci to nie to samo

To rozróżnienie trzeba mieć czyste.

Custom agent to zdefiniowana rola. Subagent to sposób delegacji zadania do izolowanego kontekstu.

Custom agent może być użyty jako subagent, ale dopiero po odpowiedniej konfiguracji. To nie jest automatyczne zrównanie pojęć.

Warto też znać historię nazwy

Docs wprost mówią, że custom agents były wcześniej znane jako custom chat modes. Jeśli trafisz na starsze materiały o .chatmode.md, miej z tyłu głowy, że aktualny format to .agent.md.

To ważne, bo w obiegu nadal krąży stara terminologia.

Dobre role są wąskie i jednoznaczne

Najczęściej najlepiej działają agenci o bardzo wyraźnej specjalizacji, na przykład:

• planner read-only
• implementer TDD
• reviewer security
• dokumentator

Gdy rola jest zbyt szeroka, agent zaczyna robić niepotrzebne skoki między trybami myślenia i narzędziami.

Tool priority też trzeba rozumieć

Jeśli używasz tools zarówno w custom agencie, jak i w prompt file, priorytet ma prompt file.

To ważne, bo pozwala budować warianty workflow ponad tym samym agentem, ale też łatwo prowadzi do nieporozumień, jeśli zapomnisz, skąd naprawdę bierze się końcowy zestaw narzędzi.

Ćwiczenie praktyczne

Zaprojektuj dwa custom agenty dla własnego repo:

1. Planner z dostępem tylko do narzędzi czytających.
2. Reviewer bezpieczeństwa z naciskiem na analizę ryzyk i minimalny zakres edycji.

Dla każdego określ:

• rolę i opis
• narzędzia
• model
• czy agent ma być widoczny w pickerze
• czy ma mieć handoff do kolejnego etapu

Na końcu sprawdź, czy żaden z agentów nie dostał narzędzi “na wszelki wypadek”.

Kluczowe wnioski

• Custom agent to trwała rola z własnym środowiskiem pracy, nie tylko zapisany prompt.
• Największą wartość daje zawężenie narzędzi i jasna specjalizacja.
• Handoffs pozwalają budować sekwencyjne workflow bez mieszania wszystkich ról w jednym agencie.
• Im bardziej precyzyjna persona, tym bardziej przewidywalne efekty.

Co dalej

Custom agents definiują role. Następny krok to skills, czyli przenośne capability packages, które agent może ładować wtedy, gdy są naprawdę potrzebne.