Share via


문서 인텔리전스 쿼리 필드 추출

**문서 인텔리전스는 이제 쿼리 필드를 지원합니다. 이를 통해 미리 빌드된 모델의 스키마를 확장하여 필요한 특정 필드를 추출할 수 있습니다. 쿼리 필드를 레이아웃에 추가하여 양식이나 문서의 구조 외에 필드를 추출할 수도 있습니다.

참고 항목

문서 인텔리전스 스튜디오 쿼리 필드 추출은 현재 UX.Tax 미리 빌드된 모델을 제외하고 레이아웃 및 미리 빌드된 모델에서 사용할 수 있습니다.

쿼리 필드 또는 키-값 쌍

쿼리 필드와 키-값 쌍은 수행하는 기능이 비슷합니다. 어떤 기능을 선택할지 결정할 때 알아야 할 몇 가지 차이점이 있습니다.

  • 키-값 쌍은 레이아웃 및 청구서 모델에서만 사용할 수 있습니다. 미리 빌드된 모델의 스키마를 확장하려는 경우 쿼리 필드를 사용하세요.

  • 추출할 특정 필드를 모르거나 필드 수가 큰 경우(20보다 큼) 키-값 쌍이 더 나은 솔루션일 수 있습니다.

  • 키-값 쌍은 양식이나 문서에 있는 키와 값을 추출하므로 키 변형에 대비해야 합니다. 예: 키 First Name 또는 Given Name. 쿼리 필드의 경우 사용자는 키를 정의하고, 모델은 해당 값만 추출합니다.

  • 필요한 값을 문서에서 키-값 쌍으로 설명할 수 없는 경우 쿼리 필드를 사용하세요. 계약의 계약 날짜를 예로 들 수 있습니다.

쿼리 필드 추출을 위해 추출하려는 필드를 지정하면 문서 인텔리전스가 그에 따라 문서를 분석합니다. 예를 들면 다음과 같습니다.

  • 문서 인텔리전스 스튜디오에서 계약을 처리하는 경우 2024-02-29-preview, 2023-10-31-preview 이상의 API 버전을 사용하세요.

    문서 인텔리전스 Studio의 쿼리 필드 버튼 스크린샷.

  • AnalyzeDocument 요청의 일부로 Party1, Party2, TermsOfUse, PaymentTerms, PaymentDateTermEndDate"와 같은 필드 레이블 목록을 전달할 수 있습니다.

    문서 인텔리전스 Studio의 쿼리 필드 선택 창 스크린샷.

  • 응답에는 쿼리 필드 외에도 모델 출력이 포함됩니다. 각 모델이 추출한 기능 또는 스키마 목록은 모델 분석 기능을 참조하세요.

쿼리 필드 REST API 요청**

일반 문서 모델과 쿼리 필드 기능을 사용하고 사용자 지정 모델을 학습시킬 필요 없이 추출 프로세스에 필드를 추가합니다.

POST https://{endpoint}/documentintelligence/documentModels/prebuilt-layout:analyze?api-version=2024-02-29-preview&features=queryFields&queryFields=Terms,PaymentDate HTTP/1.1
Host: *.cognitiveservices.azure.com
Content-Type: application/json
Ocp-Apim-Subscription-Key:

{
  "urlSource": "https://raw.githubusercontent.com/Azure-Samples/cognitive-services-REST-api-samples/master/curl/form-recognizer/sample-layout.pdf"
}

다음 단계