文件智慧自訂範本模型

發行項
05/30/2024

重要

Document Intelligence 公開預覽版本提供早期存取作用中開發的功能。
根據使用者意見反應，功能、方法和流程在正式發行 (GA) 前可能有所變更。
Document Intelligence 用戶端連結庫的公開預覽版本預設為 REST API 版本 2024-02-29-preview。
公開預覽版本 2024-02-29-preview 目前僅適用於下列 Azure 區域：
美國東部
美國西部 2
西歐

此內容適用於：v4.0 （預覽） | 舊版：v3.1 （GA）v3.0 （GA）v2.1 （GA）

此內容適用於：v3.1 （GA） | 最新版本：v4.0 （預覽） | 舊版：v3.0v2.1

此內容適用於：v3.0 （GA） | 最新版本：v4.0 （預覽）v3.1 | 舊版：v2.1

此內容適用於：v2.1 | 最新版本：v4.0（預覽）

自訂範本 (先前的自訂表單) 是易於定型的文件模型，可正確地從文件中擷取有標籤的索引鍵/值組、選取記號、表格、區域和簽章。範本模型會使用版面配置提示從文件中擷取值，並適合從具有已定義視覺化範本的高度結構化文件中擷取欄位。

自訂範本模型與自訂神經網路共用相同的標籤格式和策略，並支援更多欄位類型和語言。

模型功能

自訂範本模型支援索引鍵/值組、選取標記、資料表、簽章欄位和選取的區域。

表單欄位	選取標記	表格式欄位 (資料表)	簽章	選取的區域
支援	支援	支援	支援	支援

表格式欄位

隨著 API 版本 2022-06-30-preview 和更新版本發行，自訂範本模型將新增跨頁表格式欄位 (資料表) 的支援：

若要將跨越多個頁面的資料表加上標籤，請在單一資料表中跨不同頁面來標記資料表的每個資料列。
最佳做法是確保資料集包含預期變化的幾個樣本。例如，如果您預期在文件中看到這些變化，請包含整個資料表在單一頁面上的範例，以及資料表橫跨越兩個以上頁面的範例。

在文件內擷取無法辨識為資料表的重複資訊時，表格式欄位也很有用。例如，在履歷表中，一段重複的工作經驗可以標示並擷取為表格式欄位。

處理變化

範本模型依賴定義的視覺範本，對範本進行變更會導致正確性降低。在這些實例中，請分割您的訓練資料集，每個範本包含至少五個樣本，並針對每個變化訓練模型。然後，您可以將模型結合到單一端點。對於處理數位 PDF 文件和影像等等的細微變化，在相同訓練資料集中，每個類型最好包含至少五個範例。

輸入需求

若要得到最佳結果，請為每個文件提供一張清晰的照片或高畫質的掃描檔案。

支援的檔案格式：

模型	PDF	圖片： JPEG/JPG、PNG、BMP、TIFF、HEIF	Microsoft Office： Word（DOCX）、Excel（XLSX）、PowerPoint（PPTX）和 HTML
參閱	✔	✔	✔
版面配置	✔	✔	✔ （2024-02-29-preview， 2023-10-31-preview 或更新版本）
一般文件	✔	✔
預建	✔	✔
自訂	✔	✔

✱ Microsoft Office 檔案目前不支援其他模型或版本。

若使用 PDF 和 TIFF，最多可處理 2000 頁 (若使用免費層訂閱，則只會處理前兩頁)。
用於分析文件的檔案大小是付費（S0）層的 500 MB，免費 #F0 層為 4 MB。
影像維度必須介於 50 x 50 像素和 10,000 x 10,000 像素之間。
如果您的 PDF 有密碼鎖定，則必須先移除鎖定才能提交。
針對 1024 x 768 像素影像的擷取文字高度下限為 12 像素。此尺寸在 150 點/英吋 (DPI) 時大約相當於 8 點文字。
針對自訂模型定型，自訂範本模型的定型資料頁數上限為 500，而自訂神經網路模型的上限則為 50,000。
針對自訂擷取模型定型，範本模型的定型資料大小總計為 50 MB，而神經模型的大小總計則為 1G-MB。
針對自訂分類模型定型，定型資料的大小總計為 1GB (上限為 10,000 頁)。

Training a model

自定義範本模型已正式推出 v4.0 API。如果您是以新的專案開始，或具備現有的已標記資料集，請使用 3.1 版或 3.0 版 API 搭配文件智慧，來定型自訂範本模型。

模型	REST API	SDK	標記和測試模型
自訂範本	v3.1 API	文件智慧 SDK	Document Intelligence Studio

在 3.0 版或更新版本的 API 上，用於定型模型的組建作業支援新的 buildMode 屬性；若要定型自訂範本模型，請將 buildMode 設定為 template。

https://{endpoint}/documentintelligence/documentModels:build?api-version=2024-02-29-preview

{
  "modelId": "string",
  "description": "string",
  "buildMode": "template",
  "azureBlobSource":
  {
    "containerUrl": "string",
    "prefix": "string"
  }
}

自定義範本模型已透過 v3.1 API 正式推出。如果您是以新的專案開始，或具備現有的已標記資料集，請使用 3.1 版或 3.0 版 API 搭配文件智慧，來定型自訂範本模型。

模型	REST API	SDK	標記和測試模型
自訂範本	v3.1 API	文件智慧 SDK	Document Intelligence Studio

在 3.0 版或更新版本的 API 上，用於定型模型的組建作業支援新的 buildMode 屬性；若要定型自訂範本模型，請將 buildMode 設定為 template。

https://{endpoint}/formrecognizer/documentModels:build?api-version=2023-07-31

{
  "modelId": "string",
  "description": "string",
  "buildMode": "template",
  "azureBlobSource":
  {
    "containerUrl": "string",
    "prefix": "string"
  }
}

支援的語言和地區設定

如需支援語言的完整清單，請參閱 我們的語言支援 - 自定義模型頁面。

一般可透過 2.1 版 API 取得自訂 (範本) 模型。

模型	REST API	SDK	標記和測試模型
自訂模型 (範本)	文件智慧 2.1	文件智慧 SDK	文件智慧範例標記工具

下一步

了解如何建立和撰寫自訂模型：

建置自訂模型撰寫自訂模型

共用方式為