Agent zleceń w Claude: przepis w sześciu krokach

W sześciu krokach zbudujecie w Claude agenta, który czyta zlecenie transportowe, sprawdza płatnika wobec limitu i przeterminowań, liczy marżę ze stawki i kosztu trasy na tej relacji oraz dobiera auto, które może je wziąć. Agent kładzie spedytorowi na biurku rekomendację „przyjąć, przyjąć pod warunkami albo odrzucić” z listą warunków i osobą, która o każdym decyduje — ale nie przyjmuje zlecenia, nie zmienia stawki i nie zwalnia limitu. Stan funkcji sprawdzony 15.10.2026 w dokumentacji projektów Claude.

To przepis do karty agenta zleceń z serii o usługach logistycznych jako jednym systemie. Pracujemy na danych ćwiczeniowych: zlecenie na przewóz chłodniczy do Lyonu, czterech płatników, cztery relacje, cztery auta i parametry firmy. Wszystko jest fikcyjne, łącznie z chłodnią, która chce wysłać palety do Francji.

Gotowy skill. Procedurę agenta zleceń transportowych z tego przepisu znajdziecie jako gotowy skill w otwartym repozytorium moja-firma-logistyka na GitHubie, razem z danymi ćwiczeniowymi i wynikiem kontrolnym. Działa w Claude, Microsoft 365 Copilot, ChatGPT i Gemini. Jak z niego skorzystać.

Co zbudujesz

Projekt w Claude ze stałymi instrukcjami i czterema plikami wiedzy. Do nowej rozmowy w projekcie wrzucasz PDF ze zleceniem i po kilkudziesięciu sekundach dostajesz cztery rzeczy, które dziś kosztują spedytora godzinę telefonów do finansów, kontrolingu i dyspozytora.

Wejście	Co robi agent	Wynik
Zlecenie transportowe w PDF	wypisuje dane zlecenia i braki	lista danych, pytań do klienta i rzeczy do potwierdzenia
Płatnicy	sprawdza limit, saldo, przeterminowania, termin płatności	tabela płatnika z saldem po zleceniu i przekroczeniem
Relacje i parametry	liczy przychód, koszt trasy, marżę, stawkę minimalną, wariant z podwykonawcą	tabela marży wobec progu
Flota	dobiera auto pod nadwozie, dostępność i czas pracy	tabela aut: pasuje, odpada z powodem, pomysł na powrót
Wszystko razem	proponuje rekomendację z warunkami	„przyjąć pod warunkami” i lista warunków z decydentem

Czego potrzebujesz

• Konta Claude na planie, który ma projekty. Projekty są na wszystkich planach, także darmowym (do pięciu projektów), ale udostępnianie zespołowi działa na planach Team i Enterprise.
• Włączonej funkcji „Code execution and file creation”. Bez niej Claude nie otworzy pliku XLSX i nie policzy niczego kodem — a w tym przepisie liczenie „z głowy” jest zakazane (pliki i wykonywanie kodu).
• Danych ćwiczeniowych: zlecenie.pdf, platnicy.xlsx, relacje.xlsx, flota.xlsx, parametry.xlsx. Ten sam komplet w CSV i w jednym archiwum: agent-ul-dane-cwiczeniowe.zip.

Czego ten agent nie zrobi

Nie przyjmie zlecenia i nie ustali stawki. Przyjęcie należy do spedytora, stawka poniżej progu do kierownika spedycji, zwolnienie limitu do finansów, a termin płatności dłuższy niż dopuszcza polityka — do zarządu. Agent pokazuje, ile ten przewóz naprawdę kosztuje, czy płatnik mieści się w limicie i które auto może pojechać, żeby te decyzje zapadły na danych, a nie na tym, że „nazwa płatnika jest znajoma”.

Nie zastąpi też porządku w danych. Jeśli koszt trasy na relacji nie jest nigdzie zapisany, bo paliwo i opłaty drogowe księgujecie zbiorczo, agent nie ma z czym porównać stawki — i to jest najczęstszy powód, dla którego pierwsze podejście do takiego agenta kończy się ładną tabelą z pustą kolumną. W prawdziwej firmie zacznijcie od jednego arkusza z kosztem rzeczywistym pięciu najczęstszych relacji z ostatniego kwartału. Dopiero potem agent.

Krok 1. Włącz wykonywanie kodu

Jeśli pracujesz sam: Settings → Capabilities → włącz „Code execution and file creation”. W organizacji na planie Team funkcja jest domyślnie włączona, ale właściciel organizacji może ją wyłączyć; sprawdza się ją w Organization settings → Capabilities.

Powinieneś zobaczyć przełącznik w pozycji włączonej. Jeśli go nie ma albo jest szary, poproś właściciela organizacji — dalsze kroki bez tego nie zadziałają.

Krok 2. Utwórz projekt

Lewy pasek → Projects → „+ New Project”. Nazwa: „Agent zleceń”. Opis jest tylko dla ludzi; Claude go nie czyta. Na planie Team wybierz „Keep it private” na czas testów — udostępnisz projekt w kroku 6, kiedy wynik będzie sprawdzony.

Krok 3. Wpisz instrukcje agenta

W projekcie kliknij „Set project instructions”, wklej poniższy tekst i zapisz przyciskiem „Save instructions”. Instrukcje obowiązują w każdej rozmowie tego projektu.

Jesteś agentem zleceń w firmie transportowej (własna flota chłodni i plandek plus podwykonawcy).
Pracujesz na plikach z wiedzy projektu:
- platnicy.xlsx: klienci i płatnicy z limitem kredytowym, saldem, przeterminowaniami
  i umownym terminem płatności,
- relacje.xlsx: powtarzalne relacje z kosztem trasy (średnia z ostatnich przewozów),
  stawką średnią, pustymi kilometrami powrotu i średnią stawką podwykonawcy,
- flota.xlsx: auta, kierowcy, pozycja, dostępność i pozostały czas pracy w tygodniu,
- parametry.xlsx: kurs EUR/PLN do kalkulacji, minimalna marża na relacji, progi decyzji
  i maksymalny termin płatności bez zgody zarządu.

Gdy dostaniesz zlecenie transportowe (PDF w rozmowie), zrób kolejno:
1. Wypisz dane zlecenia: zleceniodawca i płatnik, miejsce załadunku i rozładunku, okna,
   ładunek (palety, masa, temperatura, wymagania), stawka i waluta, termin płatności,
   palety, postoje. Osobno wypisz, czego brakuje albo co trzeba potwierdzić.
2. Sprawdź płatnika w platnicy.xlsx: limit, saldo, przeterminowane i najstarsza zaległość,
   umowny termin płatności. Policz saldo po zleceniu = saldo + stawka × kurs
   i o ile przekroczy limit. Porównaj termin płatności ze zlecenia z umownym
   i z maksymalnym bez zgody zarządu.
3. Policz marżę. Przychód w PLN = stawka × kurs z parametrów. Koszt trasy weź z relacje.xlsx
   dla relacji, której miasta odpowiadają rejonom załadunku i rozładunku (miejscowość pod
   Poznaniem = Poznań, dzielnica Lyonu = Lyon) i której nadwozie odpowiada ładunkowi.
   Marża = przychód − koszt trasy; marża % = marża / przychód. Porównaj z minimalną marżą
   i policz stawkę minimalną w EUR, przy której marża osiąga minimum (zaokrąglij w górę
   do pełnych 10 EUR). Policz też marżę przy oddaniu podwykonawcy:
   przychód − średnia stawka podwykonawcy × kurs.
4. Dobierz auto z flota.xlsx: nadwozie zgodne z ładunkiem, dostępne przed oknem załadunku,
   czas pracy wystarczający na dojazd i trasę. Auta, które odpadają, wypisz z powodem.
   Zwróć uwagę na auta, które szukają powrotu w rejonie rozładunku.
5. Zaproponuj: „przyjąć”, „przyjąć pod warunkami” albo „odrzucić”. Uzasadnij w trzech
   zdaniach i wypisz warunki, każdy z osobą, która o nim decyduje
   (spedytor, kierownik spedycji, finanse, zarząd).

Zasady:
- Licz kodem na plikach, nie z pamięci. Przy każdej liczbie podaj, z których wierszy pochodzi.
- Nie dopisuj relacji, aut ani płatników, których nie ma w plikach. Brak danych nazwij wprost.
- Nie przyjmujesz zlecenia, nie zmieniasz stawki ani terminu płatności i nie zwalniasz limitu.
  To decyzje spedytora, kierownika spedycji, finansów i zarządu.
- Wynik: tabela płatnika, tabela marży, tabela aut, rekomendacja z warunkami.
  Na końcu przygotuj plik XLSX z tymi tabelami do pobrania.

Dwie rzeczy w tej instrukcji są celowe. Kurs i próg marży agent bierze z pliku parametrów, nie z własnej wiedzy o rynku — dzięki temu zmiana jednej liczby w jednym pliku zmienia wszystkie wyliczenia, co sprawdzisz w kroku z rzeczywistością. A każdy warunek w rekomendacji ma przypisaną rolę, więc spedytor od razu wie, do kogo z nim iść.

Krok 4. Dodaj wiedzę projektu

W panelu wiedzy po prawej stronie kliknij „+” i dodaj platnicy.xlsx, relacje.xlsx, flota.xlsx oraz parametry.xlsx. Limit to 30 MB na plik; nasze pliki ważą kilka kilobajtów.

Zlecenia nie dodawaj do wiedzy. Wiedza projektu to Wasi płatnicy, relacje, flota i parametry — rzeczy, które obowiązują w każdej rozmowie. Zlecenie jest sprawą na dziś i trafia do pojedynczej rozmowy.

Krok 5. Uruchom agenta na zleceniu

W projekcie rozpocznij nową rozmowę, załącz zlecenie.pdf i napisz:

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

Powinieneś zobaczyć, że Claude uruchamia kod, czyta cztery arkusze i odpowiada w kolejności z instrukcji: dane zlecenia i braki, płatnik, marża, auta, rekomendacja. Na końcu pojawi się plik XLSX do pobrania.

Sprawdź wynik na danych kontrolnych

Porównaj odpowiedź z tabelami poniżej. Liczby policzyliśmy niezależnie z tych samych plików.

Płatnik: Chłodnie Wielkopolskie (T-0310)	Wartość
Limit kredytowy	150 000,00 zł
Saldo należności	142 000,00 zł, w tym przeterminowane 9 800,00 zł (najstarsza zaległość 12 dni)
Zlecenie w PLN	1 980 EUR × 4,30 = 8 514,00 zł
Saldo po zleceniu	150 514,00 zł — przekroczenie limitu o 514,00 zł
Termin płatności	żądany 60 dni; umowny 45; maksymalny bez zgody zarządu 45

Marża: Poznań → Lyon (chłodnia)	Wartość
Przychód	8 514,00 zł
Koszt trasy	7 620,00 zł (w tym paliwo 3 350, opłaty drogowe 1 180, kierowca 2 140)
Marża	894,00 zł, czyli 10,5% — poniżej progu 12%
Stawka minimalna dla 12%	2 020 EUR
Wariant z podwykonawcą (średnio 1 850 EUR)	koszt 7 955,00 zł, marża 559,00 zł

Auto	Status	Dlaczego
PO 1234K, chłodnia	pasuje	we Wrocławiu, wolne od 21.09 18:00, 31 h czasu pracy; dojazd ok. 160 km na załadunek 22.09 rano
PO 9012M, plandeka	odpada	bez agregatu, nie nadaje się do 2–8 °C
PO 3456N, chłodnia	odpada	zajęta do 23.09, nie zdąży na załadunek 22.09
PO 5678L, chłodnia	nie zdąży na załadunek	stoi w Lyonie i szuka powrotu — pomysł dla planisty: zamiana ról, PO 5678L bierze powrót z Francji, a PO 1234K jedzie do Lyonu

Prawidłowa rekomendacja to „przyjąć pod warunkami”: stawka minimum 2 020 EUR, żeby marża osiągnęła 12%, albo akceptacja 10,5% przez kierownika spedycji; termin płatności 45 dni, bo 60 wymaga zgody zarządu; płatnik po zleceniu przekracza limit o 514 zł i ma 9 800 zł przeterminowane od 12 dni, więc zwolnienie należy do finansów; palety EUR 1:1 i rejestrator temperatury do potwierdzenia dyspozytorowi. W brakach agent powinien wskazać termin odpowiedzi (19.09, godz. 15:00), cztery wolne godziny postoju na każdym miejscu do porównania z Waszą umową ramową oraz temperaturę 2–8 °C przy ładunku opisanym jako mrożonki — to pytanie do klienta, nie założenie.

Jeśli w tabeli marży pojawi się relacja do Mediolanu albo Berlina, agent nie trzymał się reguły doboru relacji. Jeśli saldo po zleceniu albo marża się nie zgadzają, sprawdź, czy rzeczywiście liczył kodem i czy wziął kurs z pliku parametrów.

Krok z rzeczywistością

Dane w firmie się zmieniają, a agent musi to zauważyć bez zmiany instrukcji. Otwórz parametry.xlsx, zmień kurs EUR/PLN do kalkulacji z 4,30 na 4,40, zapisz plik i podmień go w wiedzy projektu.

Zadaj w nowej rozmowie to samo pytanie. Przychód powinien wzrosnąć do 8 712,00 zł, marża do 1 092,00 zł, czyli 12,5% — próg 12% jest teraz spełniony, a stawka minimalna spada do 1 970 EUR. Wariant z podwykonawcą daje 572,00 zł marży. Saldo płatnika po zleceniu rośnie do 150 712,00 zł, więc przekroczenie limitu rośnie do 712,00 zł. W rekomendacji warunek stawki powinien zniknąć, a warunek limitu i terminu płatności zostać.

Jedna liczba w jednym pliku przesunęła marżę z „poniżej progu” na „w progu” i jednocześnie pogorszyła sytuację płatnika. Właśnie dlatego kurs do kalkulacji ma być parametrem firmy ustawianym przez kontroling, a nie liczbą z głowy spedytora.

Krok 6. Udostępnij zespołowi i podłącz pocztę

Kiedy wynik zgadza się z danymi kontrolnymi, udostępnij projekt: na planach Team i Enterprise „Can view” dla spedytorów, którzy z agenta korzystają, „Can edit” dla osoby, która odpowiada za instrukcje i wiedzę — zwykle kierownika spedycji albo kontrolingu, bo to oni pilnują progu marży i kursu.

Zlecenia przychodzą mailem i z portali, więc następnym krokiem jest konektor poczty. Właściciel organizacji włącza konektor Gmail albo Microsoft 365 (przy Microsoft 365 potrzebna jest jeszcze jednorazowa zgoda administratora Microsoft Entra), a potem każdy użytkownik łączy swoje konto sam: Customize → Connectors → „Connect”, a w rozmowie włącza konektor w menu „+”. Uwaga praktyczna: konektor Gmail daje Claude tylko metadane załączników, nie ich treść, więc PDF ze zleceniem i tak trzeba zapisać na dysku albo wgrać do rozmowy (konektory Google Workspace).

Typowe problemy

Objaw	Przyczyna	Co zrobić
Nie da się wgrać XLSX albo nie ma pliku do pobrania	wyłączone „Code execution and file creation”	włączyć w Settings → Capabilities albo poprosić właściciela organizacji
W tabeli jest relacja albo auto, których nie ma w pliku	model dopowiada zamiast liczyć	w rozmowie poproś o numery wierszy i ponowne policzenie kodem
Marża się nie zgadza	agent wziął kurs z własnej wiedzy zamiast z parametry.xlsx	przypomnij regułę z instrukcji: kurs z pliku parametrów
Agent wybrał plandekę do przewozu chłodniczego	pominął wymaganie temperatury z PDF	poproś o ponowne wypisanie wymagań ładunku i dobór aut od nowa
U kolegi agent zachowuje się inaczej	kolega rozmawia poza projektem	pracujcie tylko w rozmowach wewnątrz projektu
Konektor jest włączony, a Claude nie widzi poczty	użytkownik nie połączył swojego konta	Customize → Connectors → „Connect”, potem „+” w rozmowie

Co dalej

Na własnych danych potrzebujecie czterech eksportów. Z ERP: klient, płatnik, limit kredytowy, saldo należności, w tym przeterminowane, najstarsza zaległość w dniach, umowny termin płatności, status współpracy. Z systemu transportowego albo z arkusza kontrolingu: relacja, kilometry, czas jazdy, koszt trasy z ostatnich przewozów z podziałem na paliwo, opłaty i kierowcę, stawka średnia, puste kilometry powrotu, średnia stawka podwykonawcy. Z telematyki i grafiku: pojazd, typ nadwozia, kierowca, pozycja, dostępny od, pozostały czas pracy. Z polityki firmy: kurs do kalkulacji, minimalna marża, progi decyzji, maksymalny termin płatności. Nazwy kolumn mogą być Wasze — wtedy poprawcie je w instrukcji.

Ten sam agent w innych narzędziach:

• Agent zleceń w Microsoft 365 Copilot
• Agent zleceń w ChatGPT
• Agent zleceń w Gemini

Pełną kartę agenta zleceń — co czyta, co może sam, co zatwierdza człowiek i czym go mierzyć — znajdziecie we wpisie o płatniku sprawdzonym i stawce z kosztu trasy.