JsonOutputParser란

문자열 형태의 출력을 구조화된 JSON 객체로 변환하는 도구이다.
주로 LLM의 출력을 파싱하거나, 비구조화된 데이터를
정형화된 JSON 형식으로 변환할 때 사용된다.

기본 구조

필수문법

임포트 구문

• 이 세가지 임포트는 반드시 필요하다
• Field는 필드의 제약조건과 설명을 정의하는 데 사용된다

Pydantic 모델 정의

• BaseModel을 상속받은 클래스를 정의한다.
• 각 필드는 타입 힌트를 명시해야한다.
• Field() 데코레이터로 필드 속성 정의

Parser 인스턴스 생성

• pydantic_object 파라미터는 필수
• 정의한 Pydantic 모델을 전달해야 한다

프롬프트 템플릿 구성

• format_instructions 플레이스 홀더 필수
• 파서의 지시사항이 주입될 위치 지정

파서 지시사항 주입

• get_format_instructions() 메서드 호출 필수
• 파서의 지시사항을 프롬프트에 주입

체인 실행

• invoke() 메서드로 체인 실행
• 입력값은 딕셔너리 형태로 전달

타입 힌트

타입힌트란 변수나 함수의 데이터 타입을 명시적으로 표시하는 방법이다.

일반적인 타입 힌트 종류

다양한 출력 구조 정의

기본 구조

선택적 필드 포함

중첩 구조

검증 규칙 포함

계산된 필드

복합 구조

날짜 / 시간 필드

리스트 필드