Pydantic AI 예제

Pydantic AI 예제 (Pydantic AI examples)

Pydantic AI를 어떻게 쓰는지, 그리고 무엇을 할 수 있는지 보여주는 예제들을 소개해요. 이 페이지에서는 예제를 직접 설치하고 실행하는 방법을 하나씩 짚어 드릴게요.

출처: 문서

이 예제들은 pydantic-ai 패키지에 함께 포함되어 있어요. 그래서 pydantic-ai 저장소를 클론하거나, PyPI에서 pip 또는 uv로 pydantic-ai를 설치하기만 하면 바로 실행할 수 있습니다.

어느 방법을 쓰든 일부 예제를 실행하려면 추가 의존성이 필요해요. examples 선택적 의존성 그룹만 설치하면 된답니다.

pip/uv로 pydantic-ai를 이미 설치했다면, 추가 의존성은 이렇게 설치할 수 있어요:

pip install "pydantic-ai[examples]"

uv add "pydantic-ai[examples]"

저장소를 클론했다면 대신 uv sync --extra examples를 써서 추가 의존성을 설치하세요.

이 예제들은 하나 이상의 LLM에 대한 인증을 설정해야 동작해요. 자세한 방법은 모델 설정 문서를 참고하세요.

간단히 요약하면, 대부분의 경우 다음 환경 변수 중 하나를 설정하면 됩니다:

export OPENAI_API_KEY=your-api-key

export GEMINI_API_KEY=your-api-key

예제를 실행하려면(pydantic_ai를 설치했든 저장소를 클론했든 동일하게 동작해요) 다음처럼 실행합니다:

python -m pydantic_ai_examples.<example_module_name>

uv run -m pydantic_ai_examples.<example_module_name>

예를 들어 아주 간단한 pydantic_model 예제를 실행하려면:

python -m pydantic_ai_examples.pydantic_model

uv run -m pydantic_ai_examples.pydantic_model

한 줄로 끝내는 걸 좋아하고 uv를 쓴다면, 설정 없이도 pydantic-ai 예제를 바로 실행할 수 있어요:

OPENAI_API_KEY='your-api-key' \
  uv run --with "pydantic-ai[examples]" \
  -m pydantic_ai_examples.pydantic_model

실행만 하는 대신 예제를 직접 수정하고 싶을 수도 있겠죠. 예제를 새 디렉터리로 복사하려면 이렇게 합니다:

python -m pydantic_ai_examples --copy-to examples/

uv run -m pydantic_ai_examples --copy-to examples/