다음을 통해 공유

Zuva DocAI

Zuva DocAI를 사용하여 제품 워크플로에 계약 AI를 포함합니다. 처음부터 AI를 개발할 필요가 없으므로 DocAI API를 활용하여 계약에서 정보를 추출합니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps Premium 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 Zuva 지원
URL https://zuva.ai/support/
전자 메일 support@zuva.ai
커넥터 메타데이터
게시자 Zuva Inc.
웹 사이트 https://zuva.ai/
개인 정보 보호 정책 https://zuva.ai/privacy/
카테고리 AI

이 커넥터를 사용하면 Zuva의 동급 최고의 계약 AI를 활용하여 계약(및 관련 문서)에서 엔터티, 문장 및 단락을 찾아 추출할 수 있습니다. 여러 산업 및 사용 사례에서 법적 조항을 정확히 파악하기 위해 설계되고 학습된 이 커넥터는 워크플로에 계약 AI를 포함할 수 있는 모듈의 플러그 앤 플레이 제품군을 제공합니다. 이 커넥터는 문서 분류 및 정규화 기능뿐만 아니라 문서를 읽는 OCR과 함께 제공됩니다.

필수 조건

Zuva 계정 및 DocAI 토큰이 필요합니다. 무료 계정에 등록하여 시작합니다.

자격 증명을 가져오는 방법

Zuva DocAI에는 여러 지역 서버가 있습니다. 사용하려는 특정 지역에 대한 API 토큰을 만들어야 합니다.

  1. zuva.ai 계정을 만들고/또는 로그인합니다.
  2. DocAI 콘솔로 이동
  3. 사용하려는 지역을 선택합니다.
  4. 지역의 기본 URL을 연결에 복사합니다.
  5. 토큰을 만들고 연결에 사용할 토큰을 복사합니다.

Zuva 계정 및 토큰에 대한 자세한 내용은 DocAI 빠른 시작 가이드 를 참조하세요.

커넥터 시작

Zuva DocAI 커넥터를 사용하려면 다음과 유사한 흐름을 설정해야 합니다.

1단계: 파일 가져오기

테스트를 위해 Power Automate에서 "인스턴트 클라우드 흐름"을 만들 수 있습니다. "수동으로 흐름 트리거"를 선택하고 흐름을 만듭니다. 입력을 추가하고 "파일" 형식을 선택합니다.

2단계: 파일 제출

Submit a file 작업을 추가하고 이전 단계의 "파일 콘텐츠"를 입력으로 선택합니다.

참고: 파일은 어떤 방식으로도 변환해서는 안 됩니다(즉, base64 인코딩 없음). DocAI는 원시 이진 데이터만 허용합니다.

3단계: 파일 처리 시작

다음 작업 중 하나를 추가하여 사용할 서비스를 선택합니다.

  • Create Language Classification Request
  • Create Document Classification Request
  • Create Multi-Level Classification Request
  • Create Field Extraction Request
  • Create OCR Request

이러한 각 항목은 작업에서 반환된 파일 ID를 Submit a file 입력으로 허용합니다.

필드 추출에는 필드 ID가 입력으로 추가로 필요합니다. 필드 ID는 사용자 지정 필드를 학습한 경우 또는 프로그래밍 방식으로 작업을 사용하여 AI 트레이너의 Get Field List(로그인 필요)에서 찾을 수 있습니다.

4단계: 요청 완료를 위한 폴링

Do Until 블록("제어" 섹션에 있음)을 사용하고 블록 내부에 올바른 상태 확인 작업을 추가합니다.

  • Get Field Extraction Request Status
  • Get Language Classification Request Status
  • Get Document Classification Request Status
  • Get MLC request Status
  • Get OCR Request Status

작업은 Get ____ status 해당 Create ____ Request 작업에서 요청 ID를 입력으로 사용합니다.

또한 파일이 처리할 충분한 시간을 갖도록 블록 내에 Delay 10초 Do until 블록을 추가해야 합니다.

블록의 조건을 Do Until 같음으로 Is Finished?true설정합니다.

4단계: 결과 가져오기

마지막으로 원래 만들기 작업의 요청 ID를 입력으로 사용하여 요청에 해당하는 결과 가져오기 작업 중 하나를 사용합니다.

  • Get Field Extraction Request Text Results
  • Get Language Classification Request Status
  • Get Document Classification Request Status
  • Get MLC request Status
  • Get OCR Results Text
  • Get OCR Results Images

언어, 문서 분류 및 MLC의 경우 결과는 상태 응답에 포함됩니다.

필드 추출 결과의 구조에 대한 자세한 내용은 DocAI 설명서를 확인할 수 있습니다.

알려진 문제 및 제한 사항

요청당 필드

단일 Create Field Extraction Request 작업에는 최대 100개 필드가 포함될 수 있습니다.

사용자 지정 필드

커넥터는 사용자 지정 필드 학습 또는 개별 필드의 메타데이터 가져오기와 관련된 DocAI의 엔드포인트를 지원하지 않습니다.

기본 API와의 차이점

또한 커넥터 기능은 기본 API에 대한 설명서와 일대일로 일치하지 않습니다. 특히 커넥터는 다음과 같습니다.

  1. 요청이 완료되었거나 실패했는지 여부를 알리는 데 사용할 수 있는 추가 is_finished 부울을 노출합니다.
  2. 모든 요청은 여러 파일의 일괄 처리가 아닌 단일 파일에서 작동합니다.

일반적인 오류 및 해결

base64로 인코딩된 문자열이 아닌 원시 이진 파일을 업로드해야 합니다. OCR 서비스를 사용하고 예상 텍스트를 반환하는지 확인할 수 있습니다.

자주 묻는 질문(FAQ)

Zuva DocAI에 대한 추가 정보는 어디에서 찾을 수 있나요?

https://zuva.ai/docai/

Zuva DocAI에 대한 추가 설명서는 어디에서 찾을 수 있나요?

https://zuva.ai/documentation/

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.
기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 Description 필수
토큰 시큐어스트링 (보안 문자열) DocAI 토큰 진실
기본 URL 문자열 예: https://us.app.zuva.ai/api/v2 진실

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

MLC 요청 상태 가져오기

기존 MLC 요청에 대한 상태 및 사용 가능한 결과를 가져옵니다.
OCR 요청 만들기

지정된 파일에 적용할 OCR에 대한 새 요청을 만듭니다.
OCR 요청 상태 가져오기

기존 OCR 요청의 상태를 확인합니다.
OCR 요청 이미지 가져오기

완료된 OCR 요청에서 이미지를 가져옵니다.
OCR 요청 텍스트 가져오기

완료된 OCR 요청에서 텍스트를 가져옵니다.
날짜 정규화

하나 이상의 날짜가 포함된 문자열을 정규화합니다. 찾은 각 날짜에 대해 엔드포인트는 연도, 월 및 일을 나타내는 정수 집합을 반환합니다.
다중 수준 분류 요청 만들기

지정된 파일의 다중 수준 분류에 대한 요청을 만듭니다.
문서 분류 요청 만들기

지정된 문서의 분류 요청을 만듭니다.
문서 분류 요청 상태 가져오기

기존 문서 분류 요청에 대한 상태 및 사용 가능한 결과를 가져옵니다.
언어 분류 요청 만들기

지정된 파일의 언어에 대한 요청을 만듭니다.
언어 분류 요청 상태 가져오기

기존 문서 분류 요청에 대한 상태 및 사용 가능한 결과를 가져옵니다.
파일 삭제

Zuva에서 기존 파일을 삭제합니다.
파일 제출

Zuva DocAI에 파일을 제출합니다.
필드 목록 가져오기

사용 가능한 모든 필드 목록을 가져옵니다.
필드 추출 요청 결과 가져오기

완료된 필드 추출 요청에서 텍스트 결과를 가져옵니다.
필드 추출 요청 만들기

지정된 파일에서 추출에 대한 새 요청을 만듭니다.
필드 추출 요청 상태 가져오기

기존 필드 추출 요청의 상태를 확인합니다.

MLC 요청 상태 가져오기

작업 ID:
GetMlcRequestStatus

기존 MLC 요청에 대한 상태 및 사용 가능한 결과를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
요청 ID
 request_id True string

CreateMlcRequest에서 반환한 MLC 요청의 요청 ID입니다.

반환

Name 경로 형식 Description
MLC 요청 상태
 status string

요청의 상태('queued', 'processing', 'complete' 또는 'failed' 중 하나).
완료했나요?
 is_finished boolean

요청이 터미널 상태에 도달했는지 여부를 나타내는 부울입니다(완료 또는 실패).
Classifications
 classifications array of string

문서의 계층 분류입니다.

OCR 요청 만들기

작업 ID:
CreateOcrRequest

지정된 파일에 적용할 OCR에 대한 새 요청을 만듭니다.

매개 변수

Name 키 필수 형식 Description
파일 ID
 file_id string

SubmitFile 작업에서 반환한 파일의 고유 식별자입니다.

반환

Name 경로 형식 Description
OCR 요청 ID
 request_id string

OCR 요청의 상태 및 결과를 가져오는 데 사용되는 ID입니다.

OCR 요청 상태 가져오기

작업 ID:
GetOcrRequestStatus

기존 OCR 요청의 상태를 확인합니다.

매개 변수

Name 키 필수 형식 Description
OCR 요청 ID
 request_id True string

CreateOcrRequest에서 반환한 기존 OCR 요청의 고유 identifer입니다.

반환

Name 경로 형식 Description
OCR 요청 상태
 status string

요청의 상태('queued', 'processing', 'complete' 또는 'failed' 중 하나).
완료했나요?
 is_finished boolean

요청이 터미널 상태에 도달했는지 여부를 나타내는 부울입니다(완료 또는 실패).

OCR 요청 이미지 가져오기

작업 ID:
GetOcrRequestImages

완료된 OCR 요청에서 이미지를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
OCR 요청 ID
 request_id True string

CreateOcrRequest에서 반환한 기존 OCR 요청의 고유 identifer입니다.

반환

문서의 각 페이지를 이미지로 포함하는 zip 파일입니다.

이미지
binary

OCR 요청 텍스트 가져오기

작업 ID:
GetOcrRequestText

완료된 OCR 요청에서 텍스트를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
OCR 요청 ID
 request_id True string

CreateOcrRequest에서 반환한 기존 OCR 요청의 고유 identifer입니다.

반환

Name 경로 형식 Description
문자 메시지
 text string

문서의 OCR 텍스트입니다.

날짜 정규화

작업 ID:
NormalizeDates

하나 이상의 날짜가 포함된 문자열을 정규화합니다. 찾은 각 날짜에 대해 엔드포인트는 연도, 월 및 일을 나타내는 정수 집합을 반환합니다.

매개 변수

Name 키 필수 형식 Description
문자 메시지
 text string

정규화할 텍스트 문자열입니다.

반환

Name 경로 형식 Description
요청 ID
 request_id string

요청의 ID
문자 메시지
 text string

제공된 원본 텍스트입니다.
sha-256
 sha-256 string

원본 텍스트의 SHA-256 해시입니다.
date
 date array of object

date
Day
 date.day integer

정수인 월의 날짜입니다.
Month
 date.month integer

1에서 12 사이의 정수로 표시되는 월입니다.
연도
 date.year integer

정수로 표시된 연도입니다.

다중 수준 분류 요청 만들기

작업 ID:
CreateMlcRequest

지정된 파일의 다중 수준 분류에 대한 요청을 만듭니다.

매개 변수

Name 키 필수 형식 Description
파일 ID
 file_id string

SubmitFile 작업에서 반환한 파일의 고유 식별자입니다.

반환

Name 경로 형식 Description
MLC 요청 ID
 request_id string

이 요청의 상태 및 결과를 가져오는 데 사용할 ID입니다.

문서 분류 요청 만들기

작업 ID:
CreateDocumentClassificationRequest

지정된 문서의 분류 요청을 만듭니다.

매개 변수

Name 키 필수 형식 Description
파일 ID
 file_id string

SubmitFile 작업에서 반환한 파일의 고유 식별자입니다.

반환

Name 경로 형식 Description
분류 요청 ID
 request_id string

이 요청의 상태 및 결과를 가져오는 데 사용할 ID입니다.

문서 분류 요청 상태 가져오기

작업 ID:
GetDocumentClassificationRequestStatus

기존 문서 분류 요청에 대한 상태 및 사용 가능한 결과를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
요청 ID
 request_id True string

CreateDocumentClasssificationRequest에서 반환한 문서 분류 요청의 요청 ID입니다.

반환

Name 경로 형식 Description
분류 요청 상태
 status string

요청의 상태('queued', 'processing', 'complete' 또는 'failed' 중 하나).
완료했나요?
 is_finished boolean

요청이 터미널 상태에 도달했는지 여부를 나타내는 부울입니다(완료 또는 실패).
Classification
 classification string

검색된 문서의 형식입니다.
계약인가요?
 is_contract boolean

문서가 계약으로 인식되었는지 여부입니다.

언어 분류 요청 만들기

작업 ID:
CreateLanguageClassificationRequest

지정된 파일의 언어에 대한 요청을 만듭니다.

매개 변수

Name 키 필수 형식 Description
파일 ID
 file_id string

SubmitFile 작업에서 반환한 파일의 고유 식별자입니다.

반환

Name 경로 형식 Description
언어 요청 ID
 request_id string

이 요청의 상태 및 결과를 가져오는 데 사용할 ID입니다.

언어 분류 요청 상태 가져오기

작업 ID:
GetLanguageClassificationRequestStatus

기존 문서 분류 요청에 대한 상태 및 사용 가능한 결과를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
요청 ID
 request_id True string

CreateLanguageRequest에서 반환한 언어 분류 요청의 요청 ID입니다.

반환

Name 경로 형식 Description
언어 요청 상태
 status string

요청의 상태('queued', 'processing', 'complete' 또는 'failed' 중 하나).
완료했나요?
 is_finished boolean

요청이 터미널 상태에 도달했는지 여부를 나타내는 부울입니다(완료 또는 실패).
Language
 language string

문서의 검색된 기본 언어입니다.

파일 삭제

작업 ID:
DeleteFile

Zuva에서 기존 파일을 삭제합니다.

매개 변수

Name 키 필수 형식 Description
파일 ID
 file_id True string

삭제할 파일의 ID입니다.

반환

response
string

파일 제출

작업 ID:
SubmitFile

Zuva DocAI에 파일을 제출합니다.

매개 변수

Name 키 필수 형식 Description
File
 File binary

업로드할 이진 파일 콘텐츠 또는 일반 텍스트 문자열입니다. 이진 콘텐츠는 Base64로 인코딩해서는 안 됩니다.

반환

Name 경로 형식 Description
파일 ID
 file_id string

파일에 대한 Zuva 할당 고유 식별자입니다.
콘텐츠 형식
 attributes.content-type string

파일의 MIME 콘텐츠 형식이 검색됨
Expiration
 expiration string

파일이 DocAI에서 삭제되도록 예약된 시간입니다.

필드 목록 가져오기

작업 ID:
GetFieldList

사용 가능한 모든 필드 목록을 가져옵니다.

반환

Name 경로 형식 Description
array of object
필드 ID
 field_id string

필드의 고유 식별자입니다.
이름
 name string

필드의 이름입니다.
Description
 description string

필드에 대한 설명입니다.
바이어스
 bias double

기본 ML 모델에서 사용하는 바이어스입니다.
F 점수
 f_score double

필드의 F 점수로, 정확도에 대한 통계 측정값입니다.
정밀성
 precision double

필드의 전체 자릿수입니다.
리콜
 recall double

필드의 회수입니다.
문서 수
 document_count integer

필드가 학습된 문서 수입니다.
사용자 지정인가요?
 is_custom boolean

필드가 사용자 지정인지 여부를 나타내는 부울입니다.
학습되었나요?
 is_trained boolean

사용자 지정 필드가 학습되었는지 여부를 나타내는 부울입니다.

필드 추출 요청 결과 가져오기

작업 ID:
GetFieldExtractionRequestResults

완료된 필드 추출 요청에서 텍스트 결과를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
추출 요청 ID
 request_id True string

CreateExtractionRequest에서 반환한 기존 추출 요청의 고유 identifer입니다.

반환

Name 경로 형식 Description
Results
 results array of object

필드 추출 결과의 배열입니다.
필드 ID
 results.field_id string

추출된 필드의 고유 식별자입니다.
추출
 results.extractions array of object

이 특정 필드에 대해 추출된 결과 배열입니다.
문자 메시지
 results.extractions.text string

필드에 대해 추출된 텍스트입니다.
범위
 results.extractions.spans array of object

문서 내의 텍스트 위치에 대한 정보입니다.
Start
 results.extractions.spans.start integer

문서 텍스트 내에서 추출의 첫 번째 문자의 인덱스입니다.
끝
 results.extractions.spans.end integer

문서 텍스트 내에서 추출의 마지막 문자 인덱스입니다.
Start
 results.extractions.spans.pages.start integer

추출이 시작되는 페이지 번호입니다.
끝
 results.extractions.spans.pages.end integer

추출이 종료되는 페이지 번호입니다.

필드 추출 요청 만들기

작업 ID:
CreateFieldExtractionRequest

지정된 파일에서 추출에 대한 새 요청을 만듭니다.

매개 변수

Name 키 필수 형식 Description
파일 ID
 file_id string

텍스트를 추출할 파일입니다.
필드 ID
 field_ids array of string

추출할 필드의 ID입니다.

반환

Name 경로 형식 Description
추출 요청 ID
 request_id string

이 요청의 상태 및 결과를 가져오는 데 사용할 ID입니다.

필드 추출 요청 상태 가져오기

작업 ID:
GetFieldExtractionRequestStatus

기존 필드 추출 요청의 상태를 확인합니다.

매개 변수

Name 키 필수 형식 Description
추출 요청 ID
 request_id True string

CreateExtractionRequest에서 반환한 기존 추출 요청의 고유 identifer입니다.

반환

Name 경로 형식 Description
필드 추출 요청 상태
 status string

요청의 상태('queued', 'processing', 'complete' 또는 'failed' 중 하나).
완료했나요?
 is_finished boolean

요청이 터미널 상태에 도달했는지 여부를 나타내는 부울입니다(완료 또는 실패).

정의

문자열

기본 데이터 형식 'string'입니다.

이진법

기본 데이터 형식 'binary'입니다.