Zuva DocAI

Zuva DocAI を使用して、契約 AI を製品ワークフローに埋め込みます。 ゼロから AI を開発する必要はありません。DocAI API を活用して、契約から情報を抽出します。

このコネクタは、次の製品および地域で利用可能です:

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 政府の地域
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate プレミアム 以下を除くすべての Power Automate 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   国防総省 (DoD)
Power Apps プレミアム 以下を除くすべての Power Apps 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
お問い合わせ先
件名 Zuva サポート
[URL] https://zuva.ai/support/
メール support@zuva.ai
Connector Metadata
発行者 Zuva Inc.
Web サイト https://zuva.ai/
プライバシー ポリシー https://zuva.ai/privacy/
カテゴリー AI

このコネクタを使用すると、ユーザーは Zuva のクラス最高の契約 AI を活用して、契約書 (および関連ドキュメント) からエンティティ、文、段落を検索して抽出できます。 このコネクタは、複数の業界とユース ケースにわたって法的条項を特定するように設計およびトレーニングされており、Contracts 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 を入力として受け取ります。

また Do until ブロック内に 10 秒の Delay ブロックを追加して、ファイルの処理に十分な時間を確保する必要があります。

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 サービスを使用して、予期したテキストが返されることを確認できます。

よくあるご質問

Zuva DocAI の追加情報はどこで入手できますか?

https://zuva.ai/docai/

Zuva DocAI の追加ドキュメントはどこで入手できますか?

https://zuva.ai/documentation/

接続を作成する

このコネクタは、次の認証タイプをサポートしています:

既定 接続を作成するためのパラメーター。 すべての地域 共有不可

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

件名 タイプ 説明設定 Required
Token securestring 自分の DocAI トークン True
ベース URL string 例: https://us.app.zuva.ai/api/v2 True

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

MLC 要求ステータスを取得する

既存の MLC 要求のステータスと利用可能な結果を取得します。

OCR 要求を作成する

指定されたファイルに適用される OCR の新しい要求を作成します。

OCR 要求ステータスを取得する

既存の OCR 要求を確認します。

OCR 要求テキストを取得する

完了した OCR 要求からテキストを取得します。

OCR 要求画像を取得する

完了した OCR 要求から画像を取得します。

ドキュメント分類要求を作成する

指定されたドキュメントの分類要求を作成します。

ドキュメント分類要求ステータスを取得する

既存のドキュメント分類要求のステータスと利用可能な結果を取得します。

ファイルの削除

Zuva から既存のファイルを削除します。

ファイルを送信する

Zuva DocAI にファイルを送信します。

フィールド リストを取得する

使用可能なすべてのフィールドの一覧を取得します。

フィールド抽出要求のステータスを取得する

既存のフィールド抽出要求のステータスを確認します。

フィールド抽出要求の作成

指定されたファイルから抽出するための新しい要求を作成します。

フィールド抽出要求の結果を取得する

完了したフィールド抽出要求からテキスト結果を取得します。

日付を正規化する

1 つ以上の日付を含む文字列を正規化します。 見つかった日付ごとに、エンドポイントは年、月、日を表す一連の整数を返します。

複数レベルの分類要求を作成する

指定されたファイルの複数レベルの分類要求を作成します。

言語分類要求を作成する

指定されたファイルの言語の要求を作成します。

言語分類要求ステータスを取得する

既存のドキュメント分類要求のステータスと利用可能な結果を取得します。

MLC 要求ステータスを取得する

既存の MLC 要求のステータスと利用可能な結果を取得します。

パラメーター

名前 キー 必須 説明
要求 ID
request_id True string

CreateMlcRequest によって返される MLC 要求の要求 ID。

戻り値

名前 パス 説明
MLC 要求ステータス
status string

リクエストのステータス (「queued」、「processing」、「complete」、または 「failed」 のいずれか)。

終了しましたか?
is_finished boolean

要求がターミナル状態 (完了または失敗) に達したかどうかを示すブール値。

分類
classifications array of string

ドキュメントの階層分類。

OCR 要求を作成する

指定されたファイルに適用される OCR の新しい要求を作成します。

パラメーター

名前 キー 必須 説明
ファイル ID
file_id string

SubmitFile 操作によって返される、ファイルの一意識別子。

戻り値

名前 パス 説明
OCR 要求 ID
request_id string

OCR 要求のステータスと結果を取得するために使用される ID。

OCR 要求ステータスを取得する

既存の OCR 要求を確認します。

パラメーター

名前 キー 必須 説明
OCR 要求 ID
request_id True string

CreateOcrRequest によって返される、既存の OCR 要求の一意の識別子。

戻り値

名前 パス 説明
OCR 要求ステータス
status string

リクエストのステータス (「queued」、「processing」、「complete」、または 「failed」 のいずれか)。

終了しましたか?
is_finished boolean

要求がターミナル状態 (完了または失敗) に達したかどうかを示すブール値。

OCR 要求テキストを取得する

完了した OCR 要求からテキストを取得します。

パラメーター

名前 キー 必須 説明
OCR 要求 ID
request_id True string

CreateOcrRequest によって返される、既存の OCR 要求の一意の識別子。

戻り値

名前 パス 説明
Text
text string

ドキュメントの OCR テキスト。

OCR 要求画像を取得する

完了した OCR 要求から画像を取得します。

パラメーター

名前 キー 必須 説明
OCR 要求 ID
request_id True string

CreateOcrRequest によって返される、既存の OCR 要求の一意の識別子。

戻り値

ドキュメントの各ページを画像として含む zip ファイル。

Images
binary

ドキュメント分類要求を作成する

指定されたドキュメントの分類要求を作成します。

パラメーター

名前 キー 必須 説明
ファイル ID
file_id string

SubmitFile 操作によって返される、ファイルの一意識別子。

戻り値

名前 パス 説明
分類要求 ID
request_id string

この要求のステータスと結果を取得するために使用する ID。

ドキュメント分類要求ステータスを取得する

既存のドキュメント分類要求のステータスと利用可能な結果を取得します。

パラメーター

名前 キー 必須 説明
要求 ID
request_id True string

CreateDocumentClasssificationRequest によって返されるドキュメント分類要求の要求 ID。

戻り値

名前 パス 説明
分類要求ステータス
status string

リクエストのステータス (「queued」、「processing」、「complete」、または 「failed」 のいずれか)。

終了しましたか?
is_finished boolean

要求がターミナル状態 (完了または失敗) に達したかどうかを示すブール値。

Classification
classification string

検出されたドキュメントの種類。

契約ですか?
is_contract boolean

ドキュメントが契約として認識されたかどうか。

ファイルの削除

Zuva から既存のファイルを削除します。

パラメーター

名前 キー 必須 説明
ファイル ID
file_id True string

削除するファイルの ID。

戻り値

返答
string

ファイルを送信する

Zuva DocAI にファイルを送信します。

パラメーター

名前 キー 必須 説明
File
File binary

アップロードするバイナリ ファイル コンテンツまたはプレーン テキスト文字列。 バイナリ コンテンツは Base64 でエンコードされるべきではありません。

戻り値

名前 パス 説明
ファイル ID
file_id string

Zuva が割り当てたファイルの一意識別子。

Content type
attributes.content-type string

検出されたファイルの MIME コンテンツ タイプ

Expiration
expiration string

ファイルが DocAI から削除される予定の時刻。

フィールド リストを取得する

使用可能なすべてのフィールドの一覧を取得します。

戻り値

名前 パス 説明
array of object
Field ID
field_id string

フィールドの一意識別子。

件名
name string

フィールドの名前

説明設定
description string

フィールドの説明。

Bias
bias double

基盤となる ML モデルによって使用されるバイアス。

F スコア
f_score double

フィールドの F スコア、その精度の統計測度。

精度
precision double

フィールドの精度。

取り消し
recall double

フィールドのリコール。

ドキュメント数
document_count integer

フィールドがトレーニングされたドキュメントの数。

カスタムかどうか?
is_custom boolean

フィールドがカスタムかどうかを示すブール値。

トレーニングされているか?
is_trained boolean

カスタム フィールドがトレーニング済みかどうかを示すブール値。

フィールド抽出要求のステータスを取得する

既存のフィールド抽出要求のステータスを確認します。

パラメーター

名前 キー 必須 説明
抽出要求 ID
request_id True string

CreateExtractionRequest によって返される、既存の抽出要求の一意の識別子。

戻り値

名前 パス 説明
フィールド抽出要求のステータス
status string

リクエストのステータス (「queued」、「processing」、「complete」、または 「failed」 のいずれか)。

終了しましたか?
is_finished boolean

要求がターミナル状態 (完了または失敗) に達したかどうかを示すブール値。

フィールド抽出要求の作成

指定されたファイルから抽出するための新しい要求を作成します。

パラメーター

名前 キー 必須 説明
ファイル ID
file_id string

テキストを抽出するファイル。

フィールド ID
field_ids array of string

フィールドの抽出する ID。

戻り値

名前 パス 説明
抽出要求 ID
request_id string

この要求のステータスと結果を取得するために使用する ID。

フィールド抽出要求の結果を取得する

完了したフィールド抽出要求からテキスト結果を取得します。

パラメーター

名前 キー 必須 説明
抽出要求 ID
request_id True string

CreateExtractionRequest によって返される、既存の抽出要求の一意の識別子。

戻り値

名前 パス 説明
Results
results array of object

フィールド抽出結果の配列。

Field ID
results.field_id string

抽出フィールドを表す一意の識別子。

抽出
results.extractions array of object

この特定のフィールドに対して抽出された結果の配列。

Text
results.extractions.text string

フィールド用に抽出されたテキスト。

スパン
results.extractions.spans array of object

ドキュメント内のテキストの場所に関する情報。

先頭
results.extractions.spans.start integer

ドキュメント テキスト内の抽出された先頭文字のインデックス。

末尾
results.extractions.spans.end integer

ドキュメント テキスト内の抽出された末尾文字のインデックス。

先頭
results.extractions.spans.pages.start integer

抽出を開始するページ番号。

末尾
results.extractions.spans.pages.end integer

抽出を終了するページ番号。

日付を正規化する

1 つ以上の日付を含む文字列を正規化します。 見つかった日付ごとに、エンドポイントは年、月、日を表す一連の整数を返します。

パラメーター

名前 キー 必須 説明
Text
text string

正規化するテキスト文字列。

戻り値

名前 パス 説明
要求 ID
request_id string

要求の ID

text
text string

提供された元のテキスト。

sha-256
sha-256 string

元のテキストの SHA-256 ハッシュ。

日にち
date array of object

日にち

date.day integer

整数としてのその月の日付。

Month
date.month integer

1 から 12 までの整数で表される月。

年式
date.year integer

整数として表される年。

複数レベルの分類要求を作成する

指定されたファイルの複数レベルの分類要求を作成します。

パラメーター

名前 キー 必須 説明
ファイル ID
file_id string

SubmitFile 操作によって返される、ファイルの一意識別子。

戻り値

名前 パス 説明
MLC 要求 ID
request_id string

この要求のステータスと結果を取得するために使用する ID。

言語分類要求を作成する

指定されたファイルの言語の要求を作成します。

パラメーター

名前 キー 必須 説明
ファイル ID
file_id string

SubmitFile 操作によって返される、ファイルの一意識別子。

戻り値

名前 パス 説明
言語要求 ID
request_id string

この要求のステータスと結果を取得するために使用する ID。

言語分類要求ステータスを取得する

既存のドキュメント分類要求のステータスと利用可能な結果を取得します。

パラメーター

名前 キー 必須 説明
要求 ID
request_id True string

CreateLanguageRequest によって返される言語分類要求の要求 ID。

戻り値

名前 パス 説明
言語要求ステータス
status string

リクエストのステータス (「queued」、「processing」、「complete」、または 「failed」 のいずれか)。

終了しましたか?
is_finished boolean

要求がターミナル状態 (完了または失敗) に達したかどうかを示すブール値。

Language
language string

主に検出されたドキュメントの言語。

定義

string

これは基本的なデータ型 '文字列' です。

binary

これは基本的なデータ型 'バイナリ' です。