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 トークンを作成する必要があります。
- zuva.ai でアカウントを作成およびサインインします。
- DocAI コンソールに移動します
- 使用する地域を選択します。
- 地域のベース URL を接続にコピーします。
- トークンを作成し、それをコピーして接続で使用します。
Zuva アカウントとトークンの詳細については、DocAI クイックスタート ガイドを参照してください。
コネクタの使用を開始する
Zuva DocAI コネクタを使用するには、次のようなフローを設定する必要があります:
ステップ 1: ファイルを取得する
テスト目的で、Power Automate に「インスタント クラウド フロー」を作成できます。 「手動でフローをトリガーする」を選択して、フローを作成します。 入力を追加し、「ファイル」タイプを選択します。
ステップ 2: ファイルを送信する
Submit a file アクションを追加し、前のステップの「ファイル コンテンツ」を入力として選択します。
注記: ファイルはいかなる方法でも変換しないでください (例: base64 エンコーディングは不可)。 DocAI は未加工のバイナリ データのみを受け取ります。
ステップ 3: ファイルの処理を開始する
次のいずれかのアクションを追加して、使用するサービスを選択します:
Create Language Classification RequestCreate Document Classification RequestCreate Multi-Level Classification RequestCreate Field Extraction RequestCreate OCR Request
それぞれ、ファイル ID (Submit a file アクションから返される) を入力として受け取ります。
フィールド抽出には、さらにフィールド ID が入力として必要です。 フィールド ID はフィールド ライブラリ (サインインが必要) で、カスタムフィールドをトレーニングした場合は AI トレーナーから、またはプログラムで Get Field List アクションを使って検索することが可能です。
ステップ 4: 要求の完了をポーリングする
Do Until ブロック (「コントロール」セクションにあります) を使用し、ブロックの内部に正しいステータス チェック アクションを追加します:
Get Field Extraction Request StatusGet Language Classification Request StatusGet Document Classification Request StatusGet MLC request StatusGet OCR Request Status
Get ____ status アクションは、対応する Create ____ Request アクションからの要求 ID を入力として受け取ります。
また Do until ブロック内に 10 秒の Delay ブロックを追加して、ファイルの処理に十分な時間を確保する必要があります。
Do Until ブロックの条件を、Is Finished? が true に等しくなるように設定します。
ステップ 4: 結果を取得する
最後に、元の作成操作の要求 ID を入力として使用して、要求に対応した結果を取得するアクションのいずれかを使用します:
Get Field Extraction Request Text ResultsGet Language Classification Request StatusGet Document Classification Request StatusGet MLC request StatusGet OCR Results TextGet OCR Results Images
言語、ドキュメントの分類、および MLC の場合、結果は応答状態に含まれることに注意してください。
フィールド抽出結果の構造の詳細については、DocAI ドキュメントを確認してください。
既知の問題と制限事項
要求ごとのフィールド
単一の Create Field Extraction Request アクションに最大 100 フィールドを含めることができます。
カスタム フィールド
コネクタは、カスタム フィールドのトレーニングや個々のフィールドのメタデータの取得に関連する DocAI のエンドポイントをサポートしていません。
基盤となる API との違い
また、コネクタ機能は、基盤となる API のドキュメントと一対一で対応していないことに注意してください。 具体的には、コネクタは以下を実行します:
- 追加の
is_finishedブール値を公開します。これを使用して、要求が完了したか失敗したかを判断できます - すべての要求は、複数ファイルのバッチではなく、単一ファイルに対して実行されます。
一般的なエラーと解決策
base64 でエンコードされた文字列ではなく、未加工のバイナリをアップロードしてください。 OCR サービスを使用して、予期したテキストが返されることを確認できます。
よくあるご質問
Zuva 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 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
これは基本的なデータ型 'バイナリ' です。