모델(Model) 설정하기
모델(Model) 설정하기
Pydantic AI는 모델을 백엔드에서 분리해 두어서, 같은 에이전트 코드로 여러 LLM 공급자를 번갈아 쓸 수 있어요. 모델 선택은 에이전트를 만들 때 문자열 식별자로 지정하거나, 실행 시점에 넘길 수 있어요.
모델 식별자는 공급자:모델명 형태예요. 예를 들어 오픈AI 모델은 openai:gpt-5.2처럼 쓰고, 다른 공급자도 비슷한 규칙으로 지정해요. 에이전트에 기본 모델을 정해두면 특별히 지정하지 않아도 그 모델로 실행되고, 매 실행마다 다른 모델을 골라 쓰고 싶다면 Agent 실행 시점에 모델을 교체할 수 있어요.
from pydantic_ai import Agent
# 에이전트에 기본 모델을 지정
agent = Agent('openai:gpt-5.2')
# 실행 시점에 다른 모델을 넘겨 쓰기
result = agent.run('안녕하세요', model='openai:gpt-4.1-mini')
모델마다 지원하는 기능이 조금씩 달라요. 예를 들어 구조화 출력이나 도구 호출을 완벽히 지원하는 모델이 있고, 그렇지 않은 모델도 있어요. 그래서 Pydantic AI는 모델별로 특화된 Model 클래스를 제공하고, 공통 인터페이스로 추상화해 두죠.
생태계에 맞춰 모델을 바꿔 끼울 수 있는 게 핵심 강점이에요. 특정 벤더에 묶이지 않고 요구사항에 맞는 모델을 코드 변경 없이 갈아 끼울 수 있죠.