生成式活动 - 良好实践

本页提供了借助“生成式预定义”项目使用“ 提取文档数据” 和“分类文档” 活动，以及分别在“数据提取” 和“生成式分类器”活动中使用“数据提取 作用域”和“对文档作用域进行分类”活动的良好实践。

超时

强烈建议将超时的默认值保留为 1 小时。如果您想更改此时间，我们建议不要将其减少到 10 分钟以下。

备注：

如果设置了较低的超时值，则可能会遇到错误。例如：

• [...] A task was canceled [...]适用于“使用 生成式提取程序 提取数据作用域” 或“使用生成式分类器 对 文档作用域进行分类”活动。
• [...] The processing took too long and the timeout value configured on the activity has been reached [...]表示“提取文档数据” 、 “分类文档”活动。

速率限制处理

您可能会遇到以下错误：

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

可能的原因

Document Understanding 生成式服务目前在您所在区域处于高负载状态。请稍后重试您的请求。

可能的解决方案

推荐的方法是对此类错误实施重试机制，从而允许工作流在短暂延迟（我们建议至少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)

以下工作流演示了如何有效地处理此场景。

工作流：使用提取文档数据

本节显示使用“提取文档数据”活动的示例工作流。

工作流：使用“分类文档”

本节显示使用“分类文档”活动的示例工作流。

工作流：将数据提取作用域与生成式提取程序一起使用

本节演示将“数据提取作用域”活动与生成式提取程序一起使用的示例工作流。

工作流：将分类文档范围与生成式分类器结合使用

本节显示一个将“分类文档范围”活动与生成式分类器结合使用的示例工作流。