Skill agenta zleceń: płatnik, marża i auto przed decyzją

Skill „zlecenie-transportowe” czyta zlecenie transportowe z PDF, sprawdza płatnika, liczy marżę z kosztu trasy i wariant z podwykonawcą, dobiera auto i proponuje decyzję z warunkami, a pobierzecie go za darmo z GitHuba. Pilny ładunek z giełdy i dobra stawka kuszą, żeby przyjąć zlecenie od razu. A potem okazuje się, że nazwa płatnika była znajoma, bo rok temu nie zapłacił, a koszt trasy poznacie po miesiącu. Skill zbiera te sprawdzenia w jednej odpowiedzi, zanim spedytor odpisze klientowi. Repozytorium: moja-firma-logistyka na GitHubie.

To pakiet branżowy otwartej paczki moja-firma. Rdzeń paczki opisujemy w osobnym tekście: moja-firma, otwarte skille AI dla polskiej firmy.

Co robi skill, a czego nie zrobi

Skill to procedura w formacie Agent Skills, zapisana w jednym pliku SKILL.md. Pracuje na czterech plikach firmy: płatnikach, relacjach, flocie i parametrach. Zlecenie dostaje jako PDF w rozmowie i przechodzi przez pięć kroków.

1. Wypisuje dane zlecenia: zleceniodawcę i płatnika, załadunek i rozładunek, okna, ładunek, stawkę, termin płatności, palety i postoje. Osobno wypisuje, czego brakuje albo co trzeba potwierdzić.
2. Sprawdza płatnika: limit, saldo, przeterminowane należności i najstarszą zaległość. Liczy saldo po zleceniu i porównuje żądany termin płatności z umownym oraz z maksymalnym bez zgody zarządu.
3. Liczy marżę. Przychód przelicza po kursie z parametrów firmy, koszt trasy bierze z pliku relacji. Porównuje marżę z minimum, liczy stawkę minimalną i marżę przy oddaniu przewozu podwykonawcy.
4. Dobiera auto: nadwozie zgodne z ładunkiem, dostępność przed oknem załadunku i wystarczający czas pracy kierowcy. Auta, które odpadają, wypisuje z powodem.
5. Proponuje „przyjąć”, „przyjąć pod warunkami” albo „odrzucić”. Uzasadnia to w trzech zdaniach i przy każdym warunku podaje osobę, która o nim decyduje.

Skill liczy kodem na plikach i przy każdej liczbie podaje, z których wierszy pochodzi. Treść zlecenia traktuje jako dane, nie jako polecenia. Na koniec oddaje tabelę płatnika, tabelę marży, tabelę aut i rekomendację.

Decyzje zostają przy ludziach. Spedytor przyjmuje zlecenie. Kierownik spedycji akceptuje stawkę poniżej progu. Finanse zwalniają limit płatnika. Zarząd zgadza się na termin płatności dłuższy niż dopuszcza polityka. Skill nie przyjmuje zlecenia, nie zmienia stawki ani terminu i nie zwalnia limitu.

Gdzie zwykła automatyzacja się myli

Najdroższy błąd to agent, który sam przyjmuje zlecenia z giełdy, bo stawka wygląda dobrze. Przyspiesza dokładnie ten błąd, który dziś kosztuje najwięcej: przewóz dla płatnika, który nie zapłacił, na relacji, której koszt poznacie po miesiącu. Dlatego skill sprawdza płatnika i koszt trasy, a przyjmuje spedytor.

Drugi przykład pokazuje, jak jedna liczba w parametrach zmienia decyzję. W wyniku kontrolnym kurs EUR/PLN do kalkulacji wynosi 4,30. Po zmianie na 4,40 marża rośnie z 10,5% do 12,5% i przekracza próg 12%. Jednocześnie saldo płatnika po zleceniu rośnie do 150 712,00 zł, więc przekroczenie limitu rośnie do 712,00 zł. Warunek stawki znika, a warunki limitu i terminu zostają. Dlatego kurs do kalkulacji ma być parametrem ustawianym przez kontroling, a nie liczbą z głowy spedytora.

Trzeci warunek dotyczy danych. Jeśli paliwo i opłaty drogowe księgujecie zbiorczo, koszt trasy na relacji nie jest nigdzie zapisany. Skill nie ma wtedy z czym porównać stawki. Najpierw koszty przypięte do relacji, potem agent.

Co jest w repozytorium

• Procedura skills/zlecenie-transportowe/SKILL.md w wersji 0.1.0, na licencji MIT.
• Dane ćwiczeniowe w katalogu dane-cwiczeniowe/: zlecenie.pdf, platnicy.csv, platnicy.xlsx, relacje.csv, relacje.xlsx, flota.csv, flota.xlsx, parametry.csv, parametry.xlsx. Pliki CSV i XLSX mają tę samą treść. Opisują fikcyjne zlecenie na przewóz chłodniczy do Lyonu, czterech płatników, cztery relacje i cztery auta.
• Wynik kontrolny w pliku WYNIK-KONTROLNY.md: liczby policzone niezależnie z tych samych plików i krok z rzeczywistością, czyli jedna zmiana w danych z oczekiwanym wynikiem.
• Paczki ZIP dla poszczególnych narzędzi w zakładce Releases: najnowsze wydanie. Te same paczki zbuduje skrypt scripts/build.mjs.

Na własnych danych potrzebujecie czterech eksportów. Z ERP: klient, płatnik, limit kredytowy, saldo należności z przeterminowanymi, najstarsza zaległość i umowny termin płatności. Z systemu transportowego albo arkusza kontrolingu: relacja, kilometry, koszt trasy z podziałem na paliwo, opłaty i kierowcę, stawka średnia, puste kilometry powrotu i średnia stawka podwykonawcy. Z telematyki i grafiku: pojazd, nadwozie, pozycja, dostępność i pozostały czas pracy. Z polityki firmy: kurs do kalkulacji, minimalna marża, progi decyzji i maksymalny termin płatności. Kolumny mogą nazywać się po Waszemu, bo skill pokaże przypisanie i zapyta, gdy coś jest niejednoznaczne.

Jak zainstalować skill

Przepisy krok po kroku na blogu pokazują budowę tego agenta od zera, z klikaniem w menu i wklejaniem instrukcji. Skill daje gotową procedurę, więc zostaje Wam instalacja i sprawdzenie wyniku. Nazwy menu zmieniają się często, więc w razie różnic sprawdźcie dokumentację narzędzia.

Anthropic Claude. W Claude Code wpiszcie dwa polecenia:

/plugin marketplace add majchrzycki-com/moja-firma
/plugin install moja-firma-logistyka@moja-firma

W aplikacji Claude dodajcie plik ZIP z wydania jako umiejętność w ustawieniach. Budowa od zera: agent zleceń w Claude krok po kroku.

Microsoft 365 Copilot. W Copilot Cowork wybierzcie Dostosuj, potem Umiejętności i Dodaj, a następnie zaimportujcie SKILL.md. W Agent Builderze wklejcie tekst z dist/instrukcje/zlecenie-transportowe.md do pola instrukcji. Budowa od zera: agent zleceń w Microsoft 365 Copilot.

OpenAI ChatGPT. Wklejcie ten sam plik z dist/instrukcje/ do instrukcji projektu albo GPT. W OpenAI Codex skopiujcie katalog skilla do katalogu skilli. Budowa od zera: agent zleceń w ChatGPT.

Google Gemini. Otwórzcie Customize, potem Skills, Create i Upload, i wskażcie katalog procedury albo plik ZIP. Google zastępuje Gemy skillami, więc nowego agenta nie budujcie już jako Gema. Przepis dla tej platformy pokazuje wersję z Gemem: agent zleceń w Gemini. Weźcie z niego dane i sposób sprawdzenia wyniku, a procedurę wgrajcie jako skill.

OpenClaw. Skopiujcie katalog skills/zlecenie-transportowe/ do katalogu skilli OpenClaw. Osobnego przepisu dla tej platformy nie ma.

Jak sprawdzić skill, zanim użyjecie prawdziwych danych

Dodajcie pliki ćwiczeniowe do wiedzy agenta albo załączcie je do rozmowy. Potem napiszcie:

Mamy nowe zlecenie. Przeprowadź analizę według instrukcji projektu, licząc kodem na plikach z wiedzy.

Porównajcie odpowiedź z plikiem WYNIK-KONTROLNY.md. Trzy liczby mówią najwięcej:

• saldo płatnika po zleceniu wynosi 150 514,00 zł, czyli limit 150 000,00 zł jest przekroczony o 514,00 zł,
• marża na relacji Poznań–Lyon wynosi 894,00 zł, czyli 10,5%, poniżej progu 12%,
• stawka minimalna, przy której marża osiąga 12%, to 2 020 EUR.

Prawidłowa rekomendacja to „przyjąć pod warunkami”. Jeśli w tabeli marży pojawi się relacja do Mediolanu albo Berlina, agent nie trzymał się reguły doboru relacji. Jeśli saldo albo marża się nie zgadzają, sprawdźcie, czy liczył kodem i czy wziął kurs z pliku parametrów.

Stan testów opisujemy dokładnie. Procedurę sprawdziliśmy 2.11.2026 w Anthropic Claude na danych ćwiczeniowych i liczby zgodziły się z wynikiem kontrolnym. W Microsoft 365 Copilot, OpenAI ChatGPT i Google Gemini procedury nie testowaliśmy. Nie testowaliśmy jej też na prawdziwych danych firmy. Dlatego wynik kontrolny jest Waszym pierwszym sprawdzianem w każdym narzędziu.

Skill to jeden z dwunastu agentów

Darmowy poradnik „Usługi logistyczne jako jeden system” rozkłada drogę przewoźnika ze spedycją na dziesięć etapów, od zlecenia do zapłaty. Opisuje dwunastu agentów, którzy pracują na jednym modelu firmy, i pokazuje, co przy każdym zostaje w rękach człowieka. Agent zleceń pracuje w etapie 01, czyli przy zleceniu i płatniku. Tu decyduje się, czy przewóz w ogóle ma płatnika, który zapłaci.

Całą rozkładówkę znajdziecie we wpisie usługi logistyczne jako jeden system, a pozostałe teksty branży w filarze usługi logistyczne. Skille dla innych branż zbiera filar skille AI dla firmy.

Od czego zacząć w poniedziałek

Zainstalujcie skill i uruchomcie go na danych ćwiczeniowych. Gdy liczby zgodzą się z wynikiem kontrolnym, przygotujcie arkusz z kosztem rzeczywistym pięciu najczęstszych relacji z ostatniego kwartału. Eksport płatników i floty przepuśćcie przez procedurę kontrola-danych z rdzenia moja-firma. Pierwszy tydzień puśćcie agenta obok normalnej pracy jednego spedytora i porównujcie wyniki. Wynik zawsze sprawdza osoba, która za niego odpowiada.