Atividades generativas — Boas práticas

Esta página fornece boas práticas para usar as atividades Extract Document Data e Classify Document usando um projeto predefinido generativo, bem como as atividades Data Extraction Scope e Classify Document Scope com atividades Data Extraction e Generative Classifier, respectivamente.

Tempos limite

É altamente recomendável deixar o tempo limite com seu valor padrão de 1 hora. Se você quiser alterá-la, recomendamos não baixá-la para menos de 10 minutos.

Observação: se você definir um valor de tempo limite menor, poderá encontrar erros. Por exemplo:

• [...] A task was canceled [...] para Data Extraction Scope com atividades Generative Extractor ou Classify Document Scope com atividades Generative Classifier .
• [...] The processing took too long and the timeout value configured on the activity has been reached [...] para as atividades Extract Document Data, Classify Document .

Manuseio de limitação de taxa

Você pode encontrar um erro como:

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

Possível causa

Os serviços generativos do Document Understanding estão atualmente sob alta carga em sua região. Tente novamente sua solicitação em alguns minutos.

Possível solução

Uma abordagem recomendada é implementar um mecanismo de nova tentativa para esses erros, permitindo que o fluxo de trabalho tente automaticamente a operação novamente após um pequeno atraso (recomendamos pelo menos 1 minuto) em vez de falhar imediatamente.

Em um nível alto, os fluxos de trabalho seguem a lógica de nova tentativa descrita no seguinte bloco 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)

Os fluxos de trabalho a seguir demonstram como lidar com esse cenário de forma eficaz.

Fluxo de trabalho: usando Extract Document Data

Esta seção mostra um exemplo de fluxo de trabalho para usar a atividade Extract Document Data .

Fluxo de trabalho: usando Classificar documento

Esta seção mostra um exemplo de fluxo de trabalho para usar a atividade Classify Document .

Fluxo de trabalho: usando o Data Extraction Scope com o Extrator generativo

Esta seção mostra um fluxo de trabalho de exemplo para usar a atividade Data Extraction Scope com o Extrator Generativo.

Fluxo de trabalho: usando Classify Document Scope com o Classificador generativo

Esta seção mostra um exemplo de fluxo de trabalho para usar a atividade Classify Document Scope com o Classificador generativo.