출력 파싱 실패 (OUTPUT_PARSING_FAILURE)

모델의 출력을 출력 파서(output parser)가 기대한 대로 처리하지 못했을 때 발생하는 오류예요. 이름 그대로 "출력 파싱 실패"죠. 출력 파서는 모델이 내놓은 자유로운 텍스트를 특정 형식(예: JSON, Pydantic 모델)으로 바꿔 주는 역할을 하는데, 형식에 맞지 않는 출력이 들어오면 이 오류를 던져요.

출처: 공식문서

참고

레거시 LangChain 에이전트나 체인 같은 사전 구성된 컴포넌트는 내부적으로 출력 파서를 사용하기도 해요. 그래서 겉으로 보기에 출력 파서를 직접 만들거나 쓰지 않는데도 이 오류를 만날 수 있어요.

문제 해결 (Troubleshooting)

가능하면 출력 파서 없이 **툴 호출(tool calling)**이나 다른 구조화 출력(structured output) 기법을 써서, 파싱 가능한 값을 안정적으로 얻어 보세요.
프롬프트에 출력 형식에 대한 더 명확한 지침을 추가해 보세요.
작거나 덜 강력한 모델을 쓰고 있다면 더 강력한 모델로 바꿔 보세요.