핵심 요약

문서의 날짜와 금액을 항목별로 원문 위치와 함께 저장하려면 Anthropic Claude API에서 인용 포함 응답을 먼저 받은 후, 원문과 대조 작업을 수행해야 한다. 인용 기능과 JSON 스키마를 API 요청에서 동시에 활성화하면 오류가 발생하므로 두 단계로 나누어 처리한다.

단계 주요 내용
1단계 citations.enabled=true 옵션으로 인용이 포함된 응답을 받음. 한 필드당 한 줄씩 날짜 및 금액을 추출. 다수 문서시 인용은 전체 문서에서 동일 설정 적용. output_config.format은 지정하지 않음.
2단계 응답의 인용 블록에서 원문 내 위치(텍스트는 문자 인덱스, PDF는 페이지 범위)를 확인하고 요청한 항목과 대조. 이미지 내 데이터는 별도 확인 필요. 이후 별도 코드로 필드명, 값, 위치 정보를 묶어 JSON 생성 및 누락 항목 구분 저장.

인용과 엄격한 JSON 구조 출력은 같은 요청에서 함께 지정할 수 없으며, API가 400 오류를 반환한다. 따라서 먼저 인용이 포함된 텍스트 응답을 받아 원문 위치 확인 후 별도로 JSON 스키마를 적용해야 한다. 실제 적용 시 모델 인용 지원 여부, API 요청 형식 및 비용에 대해 공식 문서를 반드시 확인해야 한다.

실무 유의점

  • 인용 기능은 텍스트 내 인용 블록 삽입 방식이므로 JSON 구조화 출력과는 호환되지 않는다.
  • 다수 문서 처리 시 인용 설정은 일괄 적용해야 하며 혼용 불가하다.
  • 인용 위치는 텍스트일 경우 0부터 시작하는 문자 인덱스로, PDF 문서는 1부터 시작하는 페이지 범위로 제공된다.
  • 누락 처리 여부는 요청 시 명확히 지시하며 응답에서 정확한 확인이 필요하다.
  • 이미지에 포함된 날짜·금액 정보는 API 인용 기능으로 추출 불가능하므로 별도 절차가 요구된다.
  • API 요청 시 인용 지원과 출력 형식 조합에 따른 오류 가능성을 대비하여 단계별 분리 작업이 중요하다.

1차 출처