Łańcuch promptów: kroki jeden po drugim
Po tej lekcji wiesz, jak zbudować łańcuch wywołań modelu i jak bramka w kodzie pilnuje, żeby kolejny krok dostał poprawne dane.
W jednej minucie
Łańcuch promptów to ciąg kroków, w którym każde wywołanie modelu przetwarza wynik poprzedniego1.
Łańcuch zamienia opóźnienie na większą dokładność, bo każde wywołanie jest łatwiejsze1. Między krokami możesz dodać bramkę, która sprawdza wynik.
Zacznij od jednego wywołania. Często wystarcza jego optymalizacja1.
Czym jest łańcuch
Łańcuch to kilka wywołań modelu jedno po drugim.
Każde wywołanie dostaje wynik poprzedniego1. Ten kształt pasuje do zadań, które da się czysto rozbić na stałe podzadania1.
- Krok 1tekst marketingowy
- Bramkasprawdzenie w kodzie
- Krok 2tłumaczenie
Przykład z artykułu Anthropic: generujesz tekst marketingowy, a potem tłumaczysz go na inny język1.
Łańcuch czy jedno wywołanie
Łańcuch ma swoją cenę, więc nie zawsze się opłaca.
| Opcja | Kiedy | Cena |
|---|---|---|
| Jedno wywołanie | Zadanie jest proste. Często wystarcza zoptymalizowane wywołanie z retrieval i przykładami1 | niższa |
| Łańcuch | Zadanie da się czysto rozbić na stałe podzadania, a ważniejsza jest dokładność niż czas11 | wyższa |
Kolumna „Cena” to nasza ocena, oparta na źródłach z tej lekcji.
Systemy agentowe często płacą za lepszy wynik kosztem i opóźnieniem1, więc zaczynaj od najprostszego rozwiązania1.
Bramka: sprawdzenie między krokami
Bramka to sprawdzenie w kodzie między dwoma krokami łańcucha.
Bramka to programowe sprawdzenie wyniku pośredniego, które pilnuje, czy proces nadal idzie we właściwą stronę1.
- Wybierz krok pośredni, którego wynik łatwo sprawdzić kodem.
- Ustal kryterium, np. długość, format albo wymagane pola.
- Sprawdź wynik w kodzie, zanim przekażesz go dalej1.
- Zdecyduj z góry, co robi łańcuch przy niepowodzeniu: ponawia krok czy się zatrzymuje.
Kryteria bramki zapisz w kodzie, a nie w kolejnym prompcie. Wtedy sprawdzenie jest powtarzalne i nic nie kosztuje.
Łańcuch w kodzie
Łańcuch to zwykłe wywołania API jedno po drugim, a bramka to zwykły kod. Podświetlone linie to bramka.
import anthropic
client = anthropic.Anthropic()
def ask(prompt):
response = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": prompt}],
)
# wybieraj bloki po typie, nie po pozycji
return "".join(b.text for b in response.content if b.type == "text")
def run_chain(product):
# krok 1: tekst marketingowy
copy = ask(f"Napisz krótki tekst marketingowy o: {product}")
# bramka: sprawdzenie w kodzie, zanim ruszy krok 2
if not copy or len(copy) > 600:
raise ValueError("Bramka: tekst pusty albo za długi")
# krok 2: wynik kroku 1 jest wejściem kroku 2
return ask(f"Przetłumacz na angielski:\n{copy}")Wynik kroku 1 trafia do kroku 2 tylko wtedy, gdy przejdzie bramkę.
Częste błędy
Łańcuch zawodzi najczęściej z czterech powodów.
| Błąd | Skutek | Co zrobić |
|---|---|---|
| Łańcuch tam, gdzie wystarczy jedno wywołanie | Dłuższy czas i większy koszt, choć często wystarcza jedno wywołanie1 | Najpierw sprawdź pojedyncze wywołanie |
| Brak bramki między krokami | Nikt nie sprawdza, czy proces jest na dobrej drodze1 | Dodaj sprawdzenie w kodzie |
| Kroki, których nie da się ustalić z góry | Łańcuch pasuje do stałych podzadań1 | Rozważ orkiestratora albo agenta |
| Złożoność bez pomiaru | Nie wiesz, czy łańcuch poprawia wyniki1 | Mierz wynik i iteruj |
Kolumna „Co zrobić” to nasza rada, nie cytat ze źródeł.
Anthropic radzi zacząć od bezpośrednich wywołań API, bo wiele wzorców mieści się w kilku linijkach kodu1.
Pytania sprawdzające
Czym jest łańcuch promptów?
Ciągiem wywołań modelu, w którym każde przetwarza wynik poprzedniego. Kroki są ustalone z góry w kodzie.
Do czego służy bramka?
To sprawdzenie w kodzie między krokami. Pilnuje, czy proces nadal idzie we właściwą stronę, zanim wynik trafi do następnego kroku.
Kiedy lepiej zostać przy jednym wywołaniu niż budować łańcuch?
Gdy zadanie jest proste. Często wystarcza zoptymalizowane pojedyncze wywołanie, a łańcuch zwiększa czas i koszt.
Bramka odrzuca tekst, który jest za długi. Czy do tego potrzebujesz kolejnego wywołania modelu?
Zwykle nie. Bramka może być zwykłym kodem, np. if sprawdzającym długość.
Podsumowanie
- Łańcuch to ciąg wywołań, w którym każde przetwarza wynik poprzedniego.
- Łańcuch zamienia czas na dokładność, bo każde wywołanie jest łatwiejsze.
- Bramka sprawdza wynik pośredni w kodzie, zanim ruszy następny krok.
- Często wystarcza jedno dobrze zoptymalizowane wywołanie.
- Łańcuch pasuje do zadań, które da się czysto rozbić na stałe podzadania.
Źródła
- Building effective agents — Anthropic Engineeringopublikowano 2024-12-19 · sprawdzone 2026-11-02