Agent kampanii w Claude: rekord przychodu czy rekord marży?

W sześciu krokach zbudujecie w Claude agenta, który liczy marżę każdej kampanii „po wszystkim” — po zwrotach, koszcie towaru, prowizjach, opłatach za płatności, wysyłce, obsłudze zwrotów i reklamie — i stawia ją obok przychodu oraz zwrotu z wydatków na reklamę (ROAS). Agent wskazuje kampanie, które pobiły rekord przychodu przy marży bliskiej zera, i przygotowuje rekomendację dla marketingu. Niczego nie wyłącza i nie przesuwa budżetu. Stan funkcji sprawdzony 15.10.2026 w dokumentacji projektów Claude.

To przepis do karty agenta kampanii z serii o handlu wielokanałowym jako jednym systemie. Pracujemy na danych ćwiczeniowych sklepu z artykułami ogrodowymi: pięć kampanii z kwietnia 2026, 1015 zamówień i 88 zwrotów. Sklep, produkty i kwoty są fikcyjne.

Gotowy skill. Procedurę agenta rozliczenia kampanii z tego przepisu znajdziecie jako gotowy skill w otwartym repozytorium moja-firma-handel 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 z instrukcjami i planem kampanii w wiedzy. Na koniec miesiąca wrzucasz do rozmowy eksport zamówień i zwrotów, a agent odpowiada tabelą, której dziś szuka się w trzech panelach i jednym arkuszu księgowej.

Wejście	Co robi agent	Wynik
Plan kampanii z kosztem reklamy	przypisuje koszt do kampanii	koszt reklamy per kampania
Zamówienia z kwietnia	sumuje przychód, koszt towaru, prowizje, płatności, wysyłkę	rachunek każdej kampanii i sprzedaży bez kampanii
Zwroty z maja	łączy je z zamówieniami po numerze	zwroty przypisane do kampanii, która je przyniosła
Wszystko razem	liczy marżę i ROAS, oznacza kampanie	tabela, oznaczenia i rekomendacja do decyzji marketingu

Czego potrzebujesz

• Konta Claude z projektami. Projekty są na wszystkich planach, także darmowym (do pięciu projektów); 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 sum kodem (pliki i wykonywanie kodu). Funkcja zużywa więcej limitu użycia niż zwykła rozmowa.
• Danych ćwiczeniowych: kampanie.xlsx, zamowienia.xlsx, zwroty.xlsx. Ten sam komplet w CSV (UTF-8, separator średnik) i w jednym archiwum: agent-hw-dane-cwiczeniowe.zip.

Czego ten agent nie zrobi

Nie wyłączy kampanii i nie przesunie budżetu. Budżetem reklamowym i wyłączaniem kampanii zarządza marketing, a o kampanii bez marży, która ma „budować zasięg”, decyduje zarząd. Agent kładzie na stół rachunek, który pozwala tę decyzję podjąć na liczbach.

— Strefa promocji ma ROAS dwadzieścia dwa. Dokładamy budżet? — A zwroty już doszły? (Doszło czternaście z pięćdziesięciu.)

Ślepa automatyzacja szkodzi tu najbardziej przez kalendarz. Zwroty z kwietnia spływają przez cały maj. Gdyby agent rozliczył kampanię marketplace 5 maja, zobaczyłby 14 z 50 zwrotów i marżę 4 055,20 zł (5,3%). Po zamknięciu okna zwrotów zostaje z tego 827,93 zł. Reguła, która 5 maja automatycznie dołożyłaby budżet „rentownej” kampanii, dołożyłaby go do kampanii, która niemal nic nie zarobiła.

Drugi warunek brzegowy dotyczy danych. Jeśli w Waszym eksporcie zamówienia nie mają oznaczenia kampanii, a ten sam produkt nosi inny indeks w każdym kanale, agent policzy marżę starannie, ale na złych przypisaniach. Najpierw jedno oznaczenie kampanii w zamówieniu i jeden indeks produktu, potem agent.

Krok 1. Włącz wykonywanie kodu

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

Powinieneś zobaczyć przełącznik w pozycji włączonej. Jeśli jest szary, poproś właściciela organizacji, bo bez tego kolejne kroki nie zadziałają.

Krok 2. Utwórz projekt

Lewy pasek → Projects → „+ New Project”. Nazwa: „Agent kampanii”. Opis jest tylko dla ludzi, Claude go nie czyta. Na planie Team wybierz „Keep it private” do czasu, aż wynik zgodzi się z danymi kontrolnymi.

Krok 3. Wpisz instrukcje agenta

Kliknij „Set project instructions”, wklej tekst poniżej i zapisz przyciskiem „Save instructions”.

Jesteś agentem kampanii w sklepie sprzedającym w kilku kanałach
(sklep internetowy, marketplace, porównywarka cen).
W wiedzy projektu masz kampanie.xlsx: kampanie z kanałem, terminem, kosztem reklamy i rabatem.
Na początku rozmowy dostaniesz eksport miesiąca:
- zamowienia.xlsx: wartość netto, koszt towaru, prowizja kanału, opłata za płatność, koszt wysyłki;
  pusta kolumna kampania_id oznacza zamówienie bez kampanii,
- zwroty.xlsx: zwroty, połączone z zamówieniami kolumną nr_zamowienia.

Gdy poproszę o rozliczenie kampanii, zrób kolejno:
1. Pogrupuj zamówienia według kampania_id. Zamówienia bez kampanii pokaż jako „bez kampanii”.
2. Dla każdej grupy policz: liczbę zamówień i zwrotów, przychód netto, zwroty netto,
   koszt towaru po zwrotach (koszt towaru minus koszt towaru, który wrócił), prowizje,
   opłaty za płatności, wysyłkę, obsługę zwrotów i koszt reklamy z kampanie.xlsx.
3. Marża = przychód netto − zwroty netto − koszt towaru po zwrotach − prowizje
   − opłaty za płatności − wysyłka − obsługa zwrotów − koszt reklamy.
   Marża % = marża / (przychód netto − zwroty netto).
   ROAS = przychód netto / koszt reklamy (przed zwrotami, tak jak w panelu reklamowym).
4. Oznacz kampanie:
   „rekord przychodu, słaba marża” — ROAS powyżej mediany kampanii i marża % poniżej 10%;
   „na minusie” — marża ujemna;
   „do wzmocnienia” — najwyższa marża % wśród kampanii.
5. Dla oznaczonych kampanii podaj dwie największe pozycje kosztu poza kosztem towaru
   (zwroty netto też są pozycją kosztu). Jeśli zwroty przekraczają 10% przychodu,
   wskaż produkt, który wraca najczęściej, z liczbą zwrotów i zwróconą wartością.
6. Przygotuj rekomendację: co wzmocnić, co ograniczyć, co sprawdzić. Każdą propozycję
   uzasadnij liczbami z tabeli i wskaż, kto decyduje: marketing albo zarząd.

Zasady:
- Licz kodem na plikach, nie z pamięci. Przy każdej sumie podaj, ilu wierszy dotyczy.
- Zwrot przypisuj do kampanii przez numer zamówienia; data zwrotu może wypaść w następnym miesiącu.
- Niczego nie wyłączasz i nie zmieniasz budżetów. Proponujesz.
- Nie dopisuj kampanii ani zamówień, których nie ma w plikach. Brak danych nazwij wprost.
- Wynik: tabela kampanii z wszystkimi pozycjami kosztu, oznaczenia, rekomendacja
  i plik XLSX z tabelą do pobrania.

Progi w punkcie 4 są jawne, żeby marketing mógł je zmienić, zamiast spierać się z „wyczuciem modelu”. Dziesięć procent to wartość ćwiczeniowa, nie zalecenie.

Krok 4. Dodaj plan kampanii do wiedzy

W panelu wiedzy po prawej kliknij „+” i dodaj kampanie.xlsx. Limit to 30 MB na plik.

Zamówień i zwrotów nie dodawaj do wiedzy. Plan kampanii obowiązuje w każdej rozmowie, a eksport miesiąca jest sprawą jednego rozliczenia. Jest też powód praktyczny: na planach płatnych, gdy wiedza projektu zbliża się do limitu kontekstu, Claude przełącza się na wyszukiwanie fragmentów zamiast czytania całości. Do sum potrzebny jest cały plik, więc duże eksporty lepiej wgrywać do rozmowy.

Krok 5. Uruchom rozliczenie

W projekcie rozpocznij nową rozmowę, załącz zamowienia.xlsx i zwroty.xlsx i napisz:

Rozlicz kampanie z kwietnia 2026 według instrukcji projektu. Licz kodem na załączonych plikach.

Powinieneś zobaczyć, że Claude uruchamia kod, czyta trzy arkusze i odpowiada w kolejności z instrukcji: tabela, oznaczenia, rekomendacja, na końcu plik XLSX.

Sprawdź wynik na danych kontrolnych

Liczby policzyliśmy niezależnie z tych samych plików. Kwoty w złotych.

Kampania	Zamówienia	Zwroty	Przychód netto	Marża po wszystkim	Marża %	ROAS
KMP-01 wyszukiwarka	140	4	23 639,34	5 095,46	22,2%	3,48
KMP-02 strefa promocji marketplace	310	50	79 133,66	827,93	1,3%	22,61
KMP-03 media społecznościowe	60	4	9 718,78	−275,68	−3,0%	1,87
KMP-04 porównywarka	95	5	30 741,50	4 504,65	15,4%	7,50
KMP-05 newsletter	70	3	8 197,98	3 274,39	41,9%	13,66
bez kampanii	340	22	72 941,94	21 729,16	31,8%	—

Kampania	Zwroty netto	Koszt towaru po zwrotach	Prowizje	Płatności	Wysyłka	Obsługa zwrotów	Reklama
KMP-01	686,19	9 955,00	0,00	349,19	681,50	72,00	6 800,00
KMP-02	15 999,42	43 170,00	10 706,31	0,00	4 030,00	900,00	3 500,00
KMP-03	389,43	3 827,00	0,00	143,53	362,50	72,00	5 200,00
KMP-04	1 543,92	19 150,00	0,00	453,93	899,00	90,00	4 100,00
KMP-05	384,14	3 547,00	0,00	120,95	217,50	54,00	600,00
bez kampanii	4 604,10	37 370,00	5 032,28	527,90	3 282,50	396,00	0,00

Prawidłowe oznaczenia: KMP-02 „rekord przychodu, słaba marża” (największy przychód i ROAS, a z 79 tysięcy przychodu zostaje 827,93 zł), KMP-03 „na minusie”, KMP-05 „do wzmocnienia”. Przy KMP-02 agent powinien wskazać zwroty (15 999,42 zł) i prowizje (10 706,31 zł) oraz kosiarkę elektryczną 40 cm: 25 z 50 zwrotów tej kampanii i 11 212,50 zł zwróconej wartości.

Jeśli KMP-02 wychodzi z marżą kilku tysięcy złotych, agent prawdopodobnie pominął część zwrotów z maja albo nie połączył ich po numerze zamówienia.

Krok z rzeczywistością

Pod koniec maja przychodzą jeszcze dwie kosiarki z kampanii marketplace, obie uszkodzone w transporcie i niezdatne do ponownej sprzedaży. Dopisz w zwroty.xlsx dwa wiersze (towar nie wraca, więc koszt towaru, który wrócił, wynosi zero):

Z-00150 | 2026-05-22 | marketplace | OGR-KOS-40 | 448.50 | 0 | 18 | uszkodzenie w transporcie
Z-00155 | 2026-05-23 | marketplace | OGR-KOS-40 | 448.50 | 0 | 18 | uszkodzenie w transporcie

Załącz poprawiony plik w nowej rozmowie i zadaj to samo pytanie. Dla KMP-02 powinieneś zobaczyć 52 zwroty, zwroty netto 16 896,42 zł, obsługę zwrotów 936,00 zł, niezmieniony koszt towaru po zwrotach 43 170,00 zł i marżę −105,07 zł (−0,2%). ROAS zostaje 22,61, bo panel reklamowy zwrotów nie widzi. Kampania powinna dostać oba oznaczenia: „rekord przychodu, słaba marża” i „na minusie”. Pozostałe wiersze tabeli się nie zmieniają.

Dwie paczki zamieniły rekordową kampanię w stratną. Tego nie pokaże żaden wskaźnik liczony przed zamknięciem okna zwrotów.

Krok 6. Udostępnij zespołowi

Kiedy wynik zgadza się z tabelami, udostępnij projekt: na planach Team i Enterprise „Can view” dla osób z marketingu, które z agenta korzystają, „Can edit” dla osoby odpowiedzialnej za instrukcje i plan kampanii.

Jeśli rozliczenie ma powstawać co tydzień bez klikania, sprawdźcie Cowork: na planach płatnych zadania mogą działać według harmonogramu w chmurze. Sesji Cowork nie da się udostępnić innym, artefakty tak, więc wynik dla zespołu zapisujcie jako plik albo artefakt (pierwsze kroki z Cowork).

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
Marża KMP-02 wychodzi kilka razy za wysoka	zwroty nie zostały połączone z zamówieniami albo agent odciął je datą	przypomnij regułę: zwrot przypisujesz przez numer zamówienia, bez względu na datę
Sumy różnią się przy dużym eksporcie	eksport leży w wiedzy projektu i Claude czyta fragmenty	wgraj eksport do rozmowy, nie do wiedzy
W tabeli pojawia się kampania, której nie ma w planie	model dopowiada zamiast liczyć	poproś o liczbę wierszy przy każdej sumie i ponowne policzenie kodem
U kolegi agent zachowuje się inaczej	kolega rozmawia poza projektem	pracujcie tylko w rozmowach wewnątrz projektu

Jeszcze jedno ostrzeżenie Anthropic dotyczy plików z zewnątrz: ukryte instrukcje w cudzym pliku mogą skłonić model do uruchomienia niezaufanego kodu. Eksporty z marketplace i od integratora traktujcie jak każdy plik od obcej firmy i patrzcie, co agent robi.

Co dalej

Na własnych danych potrzebujecie trzech eksportów. Z platformy sklepowej, marketplace albo integratora: numer zamówienia, data, kanał, oznaczenie kampanii, indeks, wartość netto, prowizja kanału, opłata za płatność, koszt wysyłki. Z ERP: koszt towaru na zamówieniu. Z obsługi zwrotów: numer zamówienia, wartość zwrotu, czy towar wrócił do sprzedaży, koszt obsługi. Plan kampanii z kosztem reklamy zwykle prowadzi marketing w arkuszu. Nazwy kolumn mogą być Wasze, wtedy poprawcie je w instrukcji.

Mierzcie wynik, nie aktywność agenta: ile dni po końcu miesiąca marketing zna marżę kampanii, ile budżetu poszło na kampanie z marżą ujemną i jak zmienia się marża kampanii po zwrotach z miesiąca na miesiąc. Pamiętajcie, że na ten wynik pracują też cena, produkt i rynek, nie tylko lepszy rachunek.

Ten sam agent w innych narzędziach:

• Agent kampanii w Microsoft 365 Copilot
• Agent kampanii w ChatGPT
• Agent kampanii w Gemini

Pełną kartę agenta kampanii — co czyta, co może sam, co zatwierdza człowiek i czym go mierzyć — znajdziecie we wpisie o kampanii liczonej po marży.