Ograniczenia, wartości domyślne i wyliczenia
Ogranicz wartości i bezpiecznie udostępniaj stały zestaw możliwości.
Ograniczenia, wartości domyślne i wyliczenia to bezpłatna lekcja MCP Academy na CoddyKit. To lekcja 3 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej MCP Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs MCP Academy zawiera 4 lekcji w sumie.
Nie tylko typy
Typy określają, jaki rodzaj wartości jest dozwolony, ale często potrzebujesz dokładniejszych reguł: limit musi być dodatni, a nazwa nie może być pusta. Właśnie do tego służą ograniczenia.
Poznaj Field
Field w Pydantic pozwala przypisać reguły do pola, na przykład minimalne i maksymalne wartości, bezpośrednio w definicji modelu.
from pydantic import BaseModel, Field
class Page(BaseModel):
size: int = Field(ge=1, le=100)Granice wartości liczbowych
Użyj ge i le dla wartości większych lub równych oraz mniejszych lub równych, albo gt i lt dla ścisłych granic, aby utrzymać liczby w bezpiecznym zakresie.
Ograniczenia długości tekstu
W przypadku tekstu min_length i max_length blokują puste ciągi oraz zbyt długie dane, zanim dotrą one do logiki programu.
name: str = Field(min_length=1, max_length=50)Dopasowywanie wzorca
Dodaj pattern, aby wymagać zgodności tekstu z wyrażeniem regularnym — to idealne rozwiązanie dla kodów, slugów lub prostych identyfikatorów.
Proste wartości domyślne
Przypisz polu wartość, a stanie się ono opcjonalne dzięki wartości domyślnej. Model może je pominąć, a narzędzie użyje wartości zastępczej.
limit: int = 10Wartości domyślne wewnątrz Field
Możesz połączyć wartość domyślną z ograniczeniami, przekazując ją do Field. Reguła i wartość zastępcza będą wtedy w jednym miejscu.
limit: int = Field(default=10, ge=1, le=100)Stałe opcje za pomocą Enum
Gdy sens ma tylko kilka wartości, Enum ogranicza pole do dokładnie tego zbioru, więc model nie może wymyślać dodatkowych opcji.
from enum import Enum
class Sort(str, Enum):
asc = "asc"
desc = "desc"Użyj Enum jako typu
Zadeklaruj pole z typem enum, a Pydantic zaakceptuje tylko jego elementy i automatycznie odrzuci każdą inną wartość.
order: Sort = Sort.ascLiteral dla małych zbiorów
W przypadku niewielkiego stałego zbioru możesz również użyć Literal, który wymienia dozwolone wartości bezpośrednio, bez osobnej klasy Enum.
from typing import Literal
unit: Literal["c", "f"] = "c"Ograniczenia docierają do modelu
Te reguły stają się częścią schematu JSON, więc model widzi dozwolone zakresy i opcje oraz częściej ich przestrzega.
Szybkie sprawdzenie
Chcesz, aby pole przyjmowało wyłącznie asc albo desc. Co będzie najlepszym rozwiązaniem?
Podsumowanie
Używaj Field do określania granic i długości, zwykłych wartości domyślnych dla wartości opcjonalnych oraz Enum lub Literal dla stałych opcji, których model musi przestrzegać. ✅
Często zadawane pytania
Czy lekcja „Ograniczenia, wartości domyślne i wyliczenia” jest bezpłatna?
Tak — pełny tekst „Ograniczenia, wartości domyślne i wyliczenia” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu MCP Academy, przejdź na CoddyKit PRO. Kurs MCP Academy zawiera 4 lekcji w sumie.
Co nauczysz się w „Ograniczenia, wartości domyślne i wyliczenia”?
Ogranicz wartości i bezpiecznie udostępniaj stały zestaw możliwości. Ćwiczysz MCP Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć MCP Academy?
Nie wymagamy żadnego doświadczenia. MCP Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 3 z 4.
Ile czasu zajmuje lekcja „Ograniczenia, wartości domyślne i wyliczenia”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji MCP Academy?
Tak. Każda lekcja MCP Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- Dlaczego schematy są lepsze od luźnych argumentów
- Dane wejściowe modelu z Pydantic
- Ograniczenia, wartości domyślne i wyliczenia
- Opisy pól pomagające modelowi