Document Understanding アクティビティ

最終更新日時 2026年2月17日

生成 AI アクティビティ - 効果的な実践

このページでは、Generative Predefined プロジェクトで [ドキュメントデータを抽出] アクティビティと [ドキュメントを分類] アクティビティを使用する方法、および [データ抽出スコープ] アクティビティと [ドキュメント分類スコープ] をそれぞれ [データ抽出] アクティビティと [生成 AI 分類器] アクティビティとともに使用するための効果的な実践について説明します。

タイムアウト

タイムアウトは既定値の 1 時間のままにすることを強くお勧めします。変更する場合は、10 分未満にしないことをお勧めします。

注: タイムアウト値を小さく設定すると、エラーが発生する可能性があります。以下に例を示します。

[...] A task was canceled [...] ([...] タスクがキャンセルされました [...]): [データ抽出スコープ] を [生成 AI 抽出器] とともに使用する場合、または [ドキュメント分類スコープ] を [生成 AI 分類器] とともに使用する場合に発生します。
[...] 処理に時間がかかりすぎたため、アクティビティに設定されたタイムアウト値に達しました。 [...]: [ドキュメントデータを抽出] アクティビティ、[ドキュメントを分類] アクティビティで発生します。

レートの制限の処理

次のようなエラーが発生する場合があります。

[...] Rate limit exceeded. Please try again later. Error code: [GptRateLimitError] [...] です。

考えられる原因

現在、ご使用のリージョンで Document Understanding の生成 AI サービスに高い負荷がかかっています。しばらく待ってから要求をリトライしてください。

考えられる解決策

推奨されるアプローチは、このようなエラーに対するリトライメカニズムを実装することです。これにより、ワークフローは直ちに失敗するのではなく、短い待機時間 (少なくとも 1 分を推奨) の後に操作を自動的にもう一度試行できます。

おおまかに言うと、ワークフローは、次のコードブロックに示すリトライロジックに従います。

+--------------------------------------------------+
| Initialize retry parameters                      |
|                                                  |
| numberOfAttempts = 3                             |
| delayBetweenRetriesInSeconds = 60                |
+--------------------------------------------------+
                    |
                    v
+--------------------------------------------------+
| Do While (success == false)                      |
+--------------------------------------------------+
                    |
                    v
        +-----------------------------+
        | Try                         |
        |-----------------------------|
        | Run Generative              |
        | Classify / Extract Activity |
        |                             |
        | success = true              |
        +-----------------------------+
                    |
        +-----------------------------+
        | Catch Exception             |
        |-----------------------------|
        | If exception contains       |
        | "[GptRateLimitError]"       |
        |                             |
        |   If attempt < max retries  |
        |      Delay                  |
        |   Else                      |
        |      Rethrow exception      |
        |                             |
        | Else                        |
        |   Rethrow exception         |
        +-----------------------------+
                    |
                    v
            (Exit Do While)+--------------------------------------------------+
| Initialize retry parameters                      |
|                                                  |
| numberOfAttempts = 3                             |
| delayBetweenRetriesInSeconds = 60                |
+--------------------------------------------------+
                    |
                    v
+--------------------------------------------------+
| Do While (success == false)                      |
+--------------------------------------------------+
                    |
                    v
        +-----------------------------+
        | Try                         |
        |-----------------------------|
        | Run Generative              |
        | Classify / Extract Activity |
        |                             |
        | success = true              |
        +-----------------------------+
                    |
        +-----------------------------+
        | Catch Exception             |
        |-----------------------------|
        | If exception contains       |
        | "[GptRateLimitError]"       |
        |                             |
        |   If attempt < max retries  |
        |      Delay                  |
        |   Else                      |
        |      Rethrow exception      |
        |                             |
        | Else                        |
        |   Rethrow exception         |
        +-----------------------------+
                    |
                    v
            (Exit Do While)