MCP Academy · 강의

제약 조건, 기본값과 열거형

값의 범위를 제한하고 고정된 선택지를 안전하게 제공합니다.

레슨 3/413개 단계

제약 조건, 기본값과 열거형은(는) CoddyKit의 무료 MCP Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 MCP Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. MCP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

형식만으로는 부족합니다

형식은 어떤 종류의 값이 허용되는지만 말해 주지만, 더 엄격한 규칙이 필요한 경우가 많습니다. 예를 들어 제한값은 양수여야 하고 이름은 비어 있으면 안 됩니다. 이때 제약 조건을 사용합니다.

Field 알아보기

Pydantic의 Field를 사용하면 모델 정의 안에서 바로 필드에 최솟값과 최댓값 같은 규칙을 지정할 수 있습니다.

from pydantic import BaseModel, Field

class Page(BaseModel):
    size: int = Field(ge=1, le=100)

숫자 범위

안전한 범위의 숫자를 유지하려면 크거나 같은 값과 작거나 같은 값에는 ge와 le를 사용하고, 엄격한 범위에는 gt와 lt를 사용하세요.

문자열 길이 제한

텍스트에는 min_length와 max_length를 사용하여 빈 문자열이나 지나치게 긴 입력이 로직에 도달하기 전에 차단하세요.

name: str = Field(min_length=1, max_length=50)

패턴 일치

패턴을 추가하면 문자열이 정규 표현식과 일치하도록 요구할 수 있습니다. 코드, 슬러그 또는 간단한 식별자에 적합합니다.

간단한 기본값

필드에 값을 지정하면 기본값이 있는 선택 필드가 됩니다. 모델이 해당 값을 생략하면 도구가 대체값을 사용합니다.

limit: int = 10

Field 안에서 기본값 지정하기

기본값을 Field에 전달하여 제약 조건과 함께 사용할 수 있습니다. 그러면 규칙과 대체값을 한곳에서 관리할 수 있습니다.

limit: int = Field(default=10, ge=1, le=100)

열거형으로 고정된 선택지 사용하기

가능한 값이 몇 개뿐이라면 열거형으로 필드를 정확한 값의 집합으로 제한할 수 있으므로 모델이 임의의 선택지를 만들어 낼 수 없습니다.

from enum import Enum

class Sort(str, Enum):
    asc = "asc"
    desc = "desc"

열거형을 형식으로 사용하기

열거형 형식으로 필드를 선언하면 Pydantic이 해당 열거형의 구성원만 허용하고 다른 값은 자동으로 거부합니다.

order: Sort = Sort.asc

작은 집합에는 리터럴 사용하기

간단한 고정 집합에는 리터럴을 사용할 수도 있습니다. 별도의 열거형 클래스 없이 허용되는 값을 바로 나열할 수 있습니다.

from typing import Literal
unit: Literal["c", "f"] = "c"

제약 조건은 모델에도 전달됩니다

이러한 규칙은 JSON 스키마의 일부가 되므로 모델이 허용되는 범위와 선택지를 보고 이를 따르는 경향이 생깁니다.

빠른 확인

필드가 asc 또는 desc만 허용하도록 하려면 무엇이 가장 적합할까요?

복습

범위와 길이에는 Field를, 선택적 값에는 일반 기본값을, 모델이 따라야 하는 고정 선택지에는 열거형이나 리터럴을 사용하세요. ✅

무료로 시작

AI 튜터와 함께 Python을(를) 배우세요 — 무료

브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.

코스
30
레슨
120

자주 묻는 질문

“제약 조건, 기본값과 열거형” 강의는 무료인가요?

네 — “제약 조건, 기본값과 열거형” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 MCP Academy 강의 전체를 잠금 해제할 수 있습니다. MCP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“제약 조건, 기본값과 열거형”에서 뭘 배우나요?

값의 범위를 제한하고 고정된 선택지를 안전하게 제공합니다. 브라우저에서 직접 실행하는 실습 코드로 MCP Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

MCP Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 MCP Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.

“제약 조건, 기본값과 열거형” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 MCP Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 MCP Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. 느슨한 인수보다 스키마가 나은 이유
  2. Pydantic으로 모델 입력 정의하기
  3. 제약 조건, 기본값과 열거형
  4. 모델을 안내하는 필드 설명
← MCP Academy(으)로 돌아가기