Actividades generativas: buenas prácticas

Esta página proporciona buenas prácticas para utilizar las actividades Extraer datos de documento y Clasificar documento utilizando un proyecto generativo predefinido, así como las actividades Ámbito de extracción de datos y Clasificar ámbito de documento con actividades de extracción de datos y Clasificador generativo , respectivamente.

Tiempos de espera

Se recomienda encarecidamente dejar el tiempo de espera en su valor predeterminado de 1 hora. Si quieres cambiarlo, te recomendamos que no lo reduzcas a menos de 10 minutos.

Nota: Si estableces un valor de tiempo de espera más bajo, puedes encontrar errores. Por ejemplo:

• [...] A task was canceled [...] para las actividades Ámbito de extracción de datos con extractor generativo o Clasificar ámbito de documento con clasificador generativo .
• [...] The processing took too long and the timeout value configured on the activity has been reached [...] para las actividades Extraer datos del documento y Clasificar documento .

Gestión de limitación de tasa

Puedes encontrar un error como:

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

Posible causa

Los servicios generativos de Document Understanding están actualmente bajo una alta carga en su región. Vuelva a intentar su solicitud después de un tiempo.

Posible solución

Un enfoque recomendado es implementar un mecanismo de reintento para tales errores, permitiendo que el flujo de trabajo intente automáticamente la operación de nuevo después de un breve retraso (recomendamos al menos 1 minuto) en lugar de fallar inmediatamente.

En general, los flujos de trabajo siguen la lógica de reintento descrita en el siguiente bloque de código:

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

Los siguientes flujos de trabajo demuestran cómo manejar este escenario de forma efectiva.

Flujo de trabajo: utilizar Extraer datos del documento

Esta sección muestra un flujo de trabajo de ejemplo para utilizar la actividad Extraer datos del documento .

Flujo de trabajo: utilizar Clasificar documento

Esta sección muestra un flujo de trabajo de ejemplo para utilizar la actividad Clasificar documento .

Flujo de trabajo: utilizar el ámbito de extracción de datos con el extractor generativo

Esta sección muestra un flujo de trabajo de ejemplo para utilizar la actividad Ámbito de extracción de datos con el Extractor generativo.

Flujo de trabajo: utilizar Clasificar ámbito de documento con clasificador generativo

Esta sección muestra un flujo de trabajo de ejemplo para utilizar la actividad Clasificar ámbito de documento con Clasificador generativo.