Activités génératives - Bonnes pratiques

Cette page fournit de bonnes pratiques pour utiliser les activités Extraire les données du document et Classer un document à l’aide d’un projet prédéfini génératif, ainsi que les activités Étendue de l’extraction de données et Classer l’étendue du document avec les activités Extraction de données et Classifieur génératif respectivement.

Délais d'attente

Il est fortement recommandé de laisser le délai d'expiration à sa valeur par défaut de 1 heure. Si vous souhaitez le modifier, nous vous recommandons de ne pas le réduire au-dessous de 10 minutes.

Remarque : si vous définissez une valeur de délai d'expiration inférieure, vous pouvez rencontrer des erreurs. Par exemple :

• [...] A task was canceled [...] pour les activités Étendue de l'extraction de données avec Extracteur génératif ou Classer l'étendue du document avec Classifieur génératif .
• [...] The processing took too long and the timeout value configured on the activity has been reached [...] pour les activités Extraire les données du document, Classer un document .

Gestion des limitations de débit

Vous pouvez rencontrer une erreur telle que :

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

Cause possible

Les services génératifs de Document Understanding sont actuellement sous charge élevée dans votre région. Veuillez réessayer votre demande ultérieurement.

Solution possible

Une approche recommandée consiste à mettre en œuvre un mécanisme de nouvelle tentative pour de telles erreurs, permettant au workflow de relancer automatiquement l'opération après un court délai au lieu d'échouer immédiatement.

À un haut niveau, les workflows suivent la logique de nouvelle tentative décrite dans le bloc de code suivant :

+--------------------------------------------------+
| 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)

Les workflows suivants illustrent comment gérer efficacement ce scénario.

Workflow : utilisation de l’extraction des données de document

Cette section montre un exemple de workflow pour l’utilisation de l’activité Extraire les données du document .

Workflow : utilisation de la fonction Classer le document

Cette section montre un exemple de workflow pour l’utilisation de l’activité Classer un document .

Workflow : utilisation de l'étendue d'extraction de données avec l'extracteur génératif

Cette section affiche un exemple de workflow pour utiliser l'activité Étendue de l'extraction de données avec l' Extracteur génératif.

Workflow : utilisation de la fonction Classer l'étendue du document avec le Classifieur génératif

Cette section affiche un exemple de workflow pour utiliser l'activité Classer l'étendue du document avec le Classifieur génératif.