Doc AI - オペレーション タスク

Doc AI - オペレーション タスクを使用すると、Document AI プロセッサでの長時間実行オペレーション(LRO)のステータスを確認できます。Document AI プロセッサは、バッチ処理リクエストを送信するたびに LRO を作成します。

Cloud Document AI は、自然言語、コンピュータ ビジョン、翻訳、AutoML などの最先端の Google AI を使用して、非構造化ドキュメントまたは半構造化ドキュメントから構造化された情報を解析できる Google Cloud サービスです。

始める前に

Doc AI - オペレーションタスクを構成する前に、Google Cloud プロジェクトで次のタスクを行う必要があります。

  1. Doc AI - オペレーション タスクを構成する前に、Google Cloud プロジェクトで Cloud Document AI API(documentai.googleapis.com)を有効にします。

    Cloud Document AI API を有効にする

  2. 認証プロファイルを作成します。Apigee Integration は、認証プロファイルを使用して、Doc AI - オペレーション タスクの認証エンドポイントに接続します。

    サービス アカウントへの追加のロールや権限の付与については、アクセス権の付与、変更、取り消しをご覧ください。

Doc AI - オペレーション タスクを構成する

  1. Apigee UI で、Apigee 組織を選択します。
  2. [Develop] > [Integrations] の順にクリックします。
  3. 既存のインテグレーションを選択するか、[Create Integration] をクリックして新しいインテグレーションを作成します。

    新しいインテグレーションを作成する場合:

    1. [Create Integration] ダイアログで名前と説明を入力します。
    2. サポートされているリージョンのリストから、インテグレーションのリージョンを選択します。
    3. [Create] をクリックします。

    インテグレーション デザイナーでインテグレーションが開きます。

  4. 統合デザイナーのナビゲーション バーで、[+ Add a task/trigger] > [Tasks] の順にクリックして、使用可能なタスクのリストを表示します。
  5. 統合デザイナーで [Doc AI - Operation] 要素をクリックして配置します。
  6. デザイナーで [Doc AI - Operation] 要素をクリックして、[Doc AI - Operation] タスク構成ペインを表示します。
  7. [Authentication] に移動し、使用する既存の認証プロファイルを選択します。

    省略可。タスクを構成する前に認証プロファイルを作成していない場合は、[+ New authentication profile] をクリックし、新しい認証プロファイルを作成するに記載されている手順に沿って操作します。

  8. [Task Input] に移動し、次の「タスクの入力パラメータ」の表を使用して表示される入力フィールドを構成します。

    入力フィールドの変更は自動的に保存されます。

タスクの入力パラメータ

次の表に、Doc AI - オペレーション タスクの入力パラメータを示します。

プロパティデータ型説明
Region 文字列プロセッサの Cloud Document AI ロケーション。例: us - 米国。
ProjectsId文字列Google Cloud プロジェクト ID。
OperationId文字列オペレーションの ID。この ID は、オペレーションの名前の最後の要素です。

タスク出力

Doc AI - オペレーション タスクは、次のサンプル出力のような長時間実行オペレーション(LRO)の詳細を返します。

{
    "name": "projects/[PROJECT_ID]/locations/[LOCATION]/operations/[OPERATION_ID]",
    "metadata": {
        "@type": "type.googleapis.com/google.cloud.documentai.v1.BatchProcessMetadata",
        "state": "SUCCEEDED",
        "stateMessage": "Processed 1 document(s) successfully",
        "createTime": "TIMESTAMP",
        "updateTime": "TIMESTAMP",
        "individualProcessStatuses": [
        {
            "inputGcsSource": "[INPUT_BUCKET_FOLDER]/DOCUMENT1.ext",
            "status": {},
            "outputGcsDestination": "OUTPUT_BUCKET_FOLDER/[OPERATION_ID]/0",
            "humanReviewStatus": {
            "state": "ERROR",
            "stateMessage": "Sharded document files are not supported for human review."
            }
        }
        ]
    },
    "done": true,
    "response": {
        "@type": "type.googleapis.com/google.cloud.documentai.v1.BatchProcessResponse"
    }
}
    

エラー処理方式

タスクのエラー処理方法では、一時的なエラーによってタスクが失敗した場合のアクションを指定します。エラー処理方式の使用方法と、さまざまな種類のエラー処理方式の詳細については、エラー処理の方式をご覧ください。

次のステップ

  1. エッジとエッジの条件を追加する。
  2. インテグレーションをテストして公開する。
  3. トリガーを構成する。
  4. データ マッピング タスクを追加する。
  5. Google Cloud サービス向けのすべてのタスクを確認する。