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

W sześciu krokach zbudujecie w Claude agenta, który czyta zapytanie ofertowe, znajduje podobne zamknięte projekty z ich prawdziwą marżą i sprawdza, czy zakład ma wolne moce w terminie klienta. Agent kładzie handlowcowi na biurku rekomendację „wyceniać, wyceniać pod warunkami albo nie wyceniać” — ale nie podaje ceny i nie decyduje za nikogo. Stan funkcji sprawdzony 15.10.2026 w dokumentacji projektów Claude.

To przepis do karty agenta zapytań z serii o firmie produkcyjno-usługowej jako jednym systemie. Pracujemy na danych ćwiczeniowych: zapytanie, dwadzieścia cztery zamknięte projekty i obciążenie gniazd. Wszystko jest fikcyjne, łącznie z mleczarnią, która chce wiatę.

Gotowy skill. Procedurę agenta zapytań ofertowych z tego przepisu znajdziecie jako gotowy skill w otwartym repozytorium moja-firma-produkcja-uslugowa 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 dwoma plikami wiedzy. Do nowej rozmowy w projekcie wrzucasz PDF z zapytaniem i po kilkudziesięciu sekundach dostajesz trzy rzeczy, które dziś kosztują handlowca pół dnia telefonów.

Wejście	Co robi agent	Wynik
Zapytanie ofertowe w PDF	wypisuje wymagania i braki	lista wymagań i pytań do klienta
Zamknięte projekty	wybiera podobne według jawnej reguły, liczy marże	tabela podobnych projektów z marżą ofertową i powykonawczą
Obciążenie gniazd	liczy normy roboczogodzin i wolne moce	tabela „potrzeba kontra wolne moce” w tygodniach klienta
Wszystko razem	proponuje ocenę z uzasadnieniem	„wyceniać pod warunkami” i lista warunków

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: zapytanie.pdf, projekty-zamkniete.xlsx, obciazenie.xlsx. Ten sam komplet w CSV i w jednym archiwum: agent-pu-dane-cwiczeniowe.zip.

Czego ten agent nie zrobi

Nie poda ceny i nie zaproponuje marży dla nowego tematu. To decyzja handlowca, a przy dużej wartości — zarządu. Agent pokazuje, ile podobne tematy kosztowały naprawdę i czy zakład je udźwignie, żeby ta decyzja zapadła na danych, a nie na optymistycznej pamięci.

Nie zastąpi też porządku w danych. Jeśli koszt rzeczywisty zamkniętych projektów nie jest nigdzie zapisany, agent nie ma na czym liczyć — 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 powykonawczym projektów z ostatniego roku. 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 zapytań”. 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 zapytań w firmie produkcyjno-usługowej (konstrukcje stalowe na zamówienie).
Pracujesz na plikach z wiedzy projektu:
- projekty-zamkniete.xlsx: zamknięte projekty z kosztem planowanym i rzeczywistym, roboczogodzinami i uwagami,
- obciazenie.xlsx: dostępne i zajęte roboczogodziny (rbh) gniazd w kolejnych tygodniach.

Gdy dostaniesz zapytanie ofertowe (PDF w rozmowie), zrób kolejno:
1. Wypisz wymagania: obiekt, materiał, masa, zabezpieczenie, normy, zakres, termin, płatność, kary.
   Osobno wypisz, czego w zapytaniu brakuje albo co zależy od innych wykonawców.
2. Znajdź podobne zamknięte projekty. Warunki: ten sam rodzaj konstrukcji (pierwsze słowo typu),
   ten sam gatunek stali, to samo zabezpieczenie, montaż u klienta jak w zapytaniu,
   masa od 60% do 140% masy z zapytania. Pokaż wszystkie spełniające warunki,
   posortowane według różnicy masy. Dla każdego: nr projektu, masa, marża ofertowa
   = (wartość oferty − koszt planowany) / wartość oferty, marża powykonawcza
   = (wartość oferty − koszt rzeczywisty) / wartość oferty, dni zwłoki płatności,
   liczba zmian zakresu, uwagi.
3. Policz normy: rbh spawania i rbh montażu na tonę jako sumę rbh podobnych projektów
   podzieloną przez sumę ich masy. Pomnóż przez masę z zapytania.
4. Sprawdź moce. Wolne rbh = dostepne_rbh − zajete_rbh; nie korzystaj z kolumny wolne_rbh.
   Zamień daty montażu z zapytania na tygodnie ISO. Zsumuj wolne rbh montażu w tych tygodniach
   i wolne rbh spawania we wszystkich tygodniach z pliku przed pierwszym tygodniem montażu.
   Porównaj z potrzebą z punktu 3.
5. Zaproponuj ocenę: „wyceniać”, „wyceniać pod warunkami” albo „nie wyceniać”.
   Uzasadnij w trzech zdaniach i wypisz warunki do rozmowy z klientem.
   „Nie wyceniać” tylko wtedy, gdy żaden warunek nie usuwa przeszkody, np. temat jest poza
   technologią zakładu. Brak mocy w terminie klienta i ryzyka z podobnych projektów, które
   da się objąć warunkami (inny termin, kooperacja, aneks na zmiany, zaliczka), oznaczają
   „wyceniać pod warunkami”.

Zasady:
- Licz kodem na plikach, nie z pamięci. Przy każdej liczbie podaj, z których wierszy pochodzi.
- Nie dopisuj projektów ani tygodni, których nie ma w plikach. Brak danych nazwij wprost.
- Nie podawaj ceny ani marży dla nowego tematu. To decyzja handlowca i zarządu.
- Wynik: tabela podobnych projektów, tabela mocy, ocena z warunkami.
  Na końcu przygotuj plik XLSX z tymi tabelami do pobrania.

Dwie rzeczy w tej instrukcji są celowe. Reguła podobieństwa jest jawna, więc handlowiec może się z nią kłócić, zamiast ufać „intuicji modelu”. A zakaz korzystania z kolumny wolne_rbh sprawdzi się w kroku z rzeczywistością.

Krok 4. Dodaj wiedzę projektu

W panelu wiedzy po prawej stronie kliknij „+” i dodaj projekty-zamkniete.xlsx oraz obciazenie.xlsx. Limit to 30 MB na plik; nasze pliki ważą kilka kilobajtów.

Zapytania nie dodawaj do wiedzy. Wiedza projektu to Wasza historia i Wasze moce — rzeczy, które obowiązują w każdej rozmowie. Zapytanie jest sprawą na dziś i trafia do pojedynczej rozmowy.

Krok 5. Uruchom agenta na zapytaniu

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

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

Powinieneś zobaczyć, że Claude uruchamia kod, czyta oba arkusze i odpowiada w kolejności z instrukcji: wymagania i braki, tabela podobnych projektów, normy, moce, ocena. 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.

Projekt	Masa	Marża ofertowa	Marża powykonawcza	Zwłoka płatności	Zmiany zakresu
P-2025-001	34,0 t	15,0%	6,7%	12 dni	2
P-2024-004	41,0 t	15,0%	6,5%	35 dni	3
P-2025-009	29,5 t	15,1%	12,8%	0 dni	0

Gniazdo	Norma	Potrzeba na 36 t	Wolne moce	Okno
Spawanie	22,6 rbh/t	813 rbh	222 rbh	tygodnie 18–27, przed montażem
Montaż	15,2 rbh/t	548 rbh	262 rbh	tygodnie 28–31, termin klienta

Prawidłowa ocena to „wyceniać pod warunkami”: dwa z trzech podobnych tematów straciły ponad połowę marży na zmianach zakresu i opóźnieniach, a w terminie klienta zakładowi brakuje mocy zarówno na spawalni, jak i na montażu. Warunki do rozmowy: późniejszy termin montażu albo kooperacja, aneks wyceniający zmiany po zamrożeniu listy materiałowej, zaliczka zamiast płatności 60 dni po odbiorze przy karze 0,5% za dzień zwłoki. W brakach agent powinien wskazać rysunki wykonawcze (tylko koncepcja) i nieznany termin gotowości fundamentów.

Jeśli w tabeli podobnych projektów pojawi się hala albo wiata bez montażu, agent nie trzymał się reguły. Jeśli liczby mocy się nie zgadzają, sprawdź, czy rzeczywiście liczył kodem.

Krok z rzeczywistością

Dane w firmie się zmieniają, a agent musi to zauważyć bez zmiany instrukcji. Otwórz projekty-zamkniete.xlsx, dopisz na końcu jeden wiersz i podmień plik w wiedzy projektu:

P-2026-025 | 2026 | Ferma Kurzanka sp. z o.o. | wiata magazynowa | S355 | 40 | ocynk ogniowy | tak | 700000 | 595000 | 690000 | 160 | 1000 | 680 | 60 | 0 | 1 | Niedoszacowane spawanie słupów.

Zadaj w nowej rozmowie to samo pytanie. Agent powinien teraz pokazać cztery podobne projekty, z nowym na drugim miejscu (różnica masy 4 t). Norma spawania wzrośnie do 23,3 rbh/t, czyli 837 rbh na 36 t; norma montażu do 15,7 rbh/t, czyli 566 rbh. Nowy projekt ma marżę ofertową 15,0% i powykonawczą 1,4%.

Jeden zły projekt przesunął normę i obraz marży. Właśnie dlatego koszt zamkniętego zlecenia ma wracać do wiedzy agenta, a nie do szuflady.

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 handlowców, którzy z agenta korzystają, „Can edit” dla osoby, która odpowiada za instrukcje i wiedzę.

Zapytania przychodzą mailem, 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 z zapytaniem 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 projekt, którego nie ma w pliku	model dopowiada zamiast liczyć	w rozmowie poproś o numery wierszy i ponowne policzenie kodem
Wolne moce się nie zgadzają	agent wziął kolumnę wolne_rbh	przypomnij regułę z instrukcji: dostępne minus zajęte
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 dwóch eksportów. Z ERP albo z arkusza kierowników projektów: numer projektu, typ konstrukcji, gatunek stali, masa, zabezpieczenie, montaż, wartość oferty, koszt planowany i rzeczywisty, roboczogodziny według gniazd, termin i zwłoka płatności, zmiany zakresu. Z planowania: dostępne i zajęte roboczogodziny gniazd na tydzień. Nazwy kolumn mogą być Wasze — wtedy poprawcie je w instrukcji.

Ten sam agent w innych narzędziach:

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

Pełną kartę agenta zapytań — co czyta, co może sam, co zatwierdza człowiek i czym go mierzyć — znajdziecie we wpisie o wycenie na kosztach rzeczywistych.