共用方式為

文件智慧服務的工作室體驗

  • 發行項

此內容適用於：勾選記號 v4.0 (預覽版) | 舊版：blue-checkmark v3.1 (GA) blue-checkmark v3.0 (GA)

該工作室是線上工具，可讓您以視覺化的方式探索、瞭解、定型文件智慧服務中的特徵，並將其整合至您的應用程式。 工作室提供的平台可讓您實驗不同的文件智慧服務模型，並以互動方式取樣傳回的資料，而無需撰寫程式碼。 您可以使用 Studio 體驗來：

  • 深入了解文件智慧服務中的不同功能。
  • 使用您的文件智慧服務資源來測試範例文件上的模型，或上傳您自己的文件。
  • 實驗不同的附加元件和預覽功能，調整輸出以符合您的需求。
  • 定型自訂分類模型以分類文件。
  • 定型自訂擷取模型以從文件擷取欄位。
  • 取得語言特定 SDKs 的範例程式碼，以整合至您的應用程式。

目前，我們正經歷將功能從 Document Intelligence Studio 移轉至新的 AI Studio。 這兩個工作室的供應專案有一些差異，可決定使用案例的正確工作室。

選擇正確的 Studio 體驗

目前有兩個工作室：Azure AI Studio 和 Document Intelligence Studio 建立和驗證 Document Intelligence 模型。 隨著體驗移轉至新的 AI Studio，這兩個 Studio 中都有一些體驗可供使用，而其他體驗/ 模型則只能在其中一個工作室中使用。 若要遵循下列指導方針，可針對您的需求選擇 Studio 體驗。 預先建立的模型和一般擷取模型都可在兩個工作室上使用。

何時使用文件智慧服務工作室

Document Intelligence Studio 是舊版體驗，其中包含 2024 年 7 月之前發行的全部功能。 針對任何 v2.1、v3.0、v3.1 功能，繼續使用 Document Intelligence Studio。 Studio 提供標籤、定型和驗證自訂模型的視覺體驗。 針對自訂文件欄位擷取模型，請使用 Document Intelligence Studio 進行範本和類神經模型。 自訂分類模型只能在 Document Intelligence Studio 上定型和使用。 如果您想要從 2.1 版、v3.0 版和 v3.1 試用 GA 版本的模型，請使用 Document Intelligence Studio。

何時使用 AI Studio

從新的 Azure AI Studio 開始，並從 2024-02-29-preview 版本嘗試任何預先建立的文件模型，包括讀取或版面配置等一般擷取模型。 如果您想要建立和測試新的文件欄位擷取模型，請嘗試我們的產生 AI 模型，僅適用於新的 AI Studio。

深入瞭解文件智慧服務工作室

從下列索引標籤中選取Studio 體驗，以深入瞭解每個工作室，以及如何開始使用。

重要

工作室支援文件智慧服務 v3.0 和更新的 API 版本，以進行模型分析和自訂模型定型。 支援先前定型的 v2.1 模型 (具有標籤的資料)，但不支援 v2.1 模型定型。 如需從 v2.1 移轉至 v3.0 的詳細資訊，請參閱 REST API 移轉指南。

使用文件智慧服務工作室快速入門，開始使用文件分析或預建模型來分析文件。 建置自訂模型，並使用其中一個語言特定 SDKs，以在您的應用程式中參考這些模型。 若要使用 Document Intelligence Studio，您需要從 Azure 入口網站取得下列資產：

  • Azure 訂用帳戶 - 建立免費訂用帳戶。

  • Azure AI 服務或文件智慧服務資源。 擁有 Azure 訂用帳戶之後，在 Azure 入口網站中建立單一服務或多重服務資源，以取得您的金鑰和端點。 使用免費定價層 (F0) 來試用該服務，之後可升級至付費層以用於生產環境。

在命名空間層級設定的授權原則

您的組織可以選擇停用本機驗證，並針對 Azure AI 文件智慧服務資源和 Azure Blob 儲存體強制執行 Microsoft Entra (舊稱為 Azure Active Directory) 驗證。

重要

  • 請確定您在設定 Entra 驗證時具有「認知服務使用者角色」，而不是認知服務參與者角色。
  • 在 Azure 內容中，參與者角色只能執行動作來控制和管理資源本身，包括列出存取金鑰。
  • 具有參與者的使用者帳戶只能透過使用存取金鑰進行呼叫來存取 Document Intelligence 服務。 不過，使用 Entra ID 設定存取時，將會停用金鑰存取，而且帳戶將需要「認知服務使用者」角色才能使用資源。

文件智慧服務模型支援

使用說明精靈、標籤介面、訓練步驟和互動式視覺效果來瞭解每個功能的運作方式。

  • 閱讀：嘗試使用範例文件或您自己的文件來試用 Document Intelligence 的 Studio 讀取功能，並在偵測到文字行、字組、偵測到語言和手寫樣式時予以擷取。 若要深入了解，「請參閱」讀取概觀。

  • 版面配置：使用範例文件或您自己的文件來試用 Document Intelligence 的 Studio 版面配置功能，並擷取文字、資料表、選取標記和結構資訊。 若要深入了解，「請參閱」版面配置概觀。

  • 預建模型：文件智慧服務的預建模型可讓您將智慧型文件處理新增至應用程式和流程中，而不需要定型及建置您自己的模型。 例如，從工作室發票功能開始。 若要深入了解，「請參閱」模型概觀。

  • 自訂擷取模型：Document Intelligence 的 Studio 自訂模型功能可讓您從使用您資料進行訓練並專為表單和文件量身打造的模型來擷取欄位和值。 若要從多個表單類型擷取資料，請建立獨立自訂模型，或結合兩個或多個自訂模型，並建立組成的模型。 使用樣本文件測試自訂模型，並逐一查看以改善模型。 若要深入了解，「請參閱」自訂模型概觀。

  • 自訂分類模型：文件分類是由文件智慧服務支援的新案例。 文件分類器 API 支援分類和分割案例。 定型分類模型，以識別應用程式支援的不同文件類型。 分類模型的輸入檔案可以包含多個文件，並將每個文件分類在相關聯的頁面範圍內。 若要深入了解，請參閱自訂分類模型。

  • 附加元件功能：Document Intelligence 支援更複雜的分析功能。 您可以使用每個模型頁面中的 Analyze Options 按鈕，在文件智慧服務工作室中啟用和停用這些選擇性功能。 有四個附加元件功能可供使用：highResolution、formula、font 和 barcode extraction 功能。 若要深入了解，請參閱附加元件功能。

試用文件智慧服務模型

  • 一旦設定了資源，您就可以試用文件智慧服務工作室所提供的不同模型。 從首頁中，選取任何文件智慧服務模型，嘗試與無程式碼方法搭配使用。

  • 若要測試任何文件分析或預建模型，請選取模型並使用其中一個範例文件，或上傳您自己的文件來分析。 分析結果會顯示在 content-result-code 視窗中的右邊。

  • 自訂模型必須根據您的文件進行定型。 如需自訂模型的概觀，請參閱自訂模型概觀。

  • 在驗證文件智慧服務工作室中的案例之後，請使用 C#、Java、JavaScript 或 Python 用戶端程式庫或 REST API，以開始將文件智慧服務模型納入您自己的應用程式中。

若要深入了解每個模型，請參閱我們的概念頁面。

檢視資源詳細資料

若要檢視名稱與定價層等資源詳細資料，請選取文件智慧服務器工作室首頁右上角的 [設定] 圖示，然後選取 [資源] 索引標籤。如果您有其他資源的存取權，也可以切換資源。

工作室設定頁面資源索引標籤的螢幕擷取畫面。

透過文件智慧服務，您可以在應用程式和工作流程中快速自動處理資料、輕鬆增強資料驅動策略，以及有技巧地擴充文件搜尋功能。

分析選項

  • 文件智慧服務支援複雜的分析功能。 工作室允許一個進入點 ([分析選項] 按鈕)，以輕鬆設定附加元件功能。

  • 根據文件擷取案例，設定分析範圍、文件頁面範圍、選擇性偵測和進階偵測功能。

    [分析選項] 對話視窗的螢幕擷取畫面。

    注意

    字型擷取未在 Document Intelligence Studio 中視覺化。 不過，您可以檢查 JSON 輸出的樣式區段，以取得字型偵測結果。

使用預先建置的模型或您自己的一個模型來自動標記文件

  • 在自訂擷取模型標記頁面中，您現在可以使用其中一個文件智慧服務預建模型或您定型的模型來自動標記文件。

    顯示工作室中自動標記作業的動態螢幕擷取畫面。

  • 對於某些文件，在執行自動標記之後可能會有重複的標籤。 請務必修改標籤，以便之後在標籤頁面中沒有重複的標籤。

    顯示進行自動標記之後出現重複標籤警告的螢幕擷取畫面。

自動標記表格

  • 您現在可以在自訂擷取模型標籤頁面中自動標記文件中的資料表，而不需要手動標記資料表。

    顯示工作室中自動標記資料表作業的動態螢幕擷取畫面。

將測試檔案直接新增至您的訓練資料集

  • 一旦您定型了自訂擷取模型，如有必要，請將測試文件上傳至定型資料集，以使用測試頁面來改善您的模型品質。

  • 如果某些標籤傳回較低的信賴度分數，則請務必正確標記您的內容。 如果未正確標記，請將它們新增至定型資料集並重新標記，以改善模型品質。

    顯示如何將測試檔案上傳至定型資料集的動態螢幕擷取畫面。

在自訂專案中利用文件清單選項和篩選

  • 使用自訂擷取模型標記頁面，透過利用搜尋、篩選和依功能排序來輕鬆瀏覽定型文件。

  • 利用格線檢視來預覽文件，或使用清單檢視更輕鬆地捲動瀏覽文件。

    文件清單檢視選項和篩選的螢幕擷取畫面。

專案共用

輕鬆共用自訂擷取專案。 如需詳細資訊，請參閱以自訂模型共用專案 (部分機器翻譯)。

疑難排解

狀況 原因 解決方案
開啟自訂專案時，您會收到錯誤訊息
Form Recognizer Not Found。		 您繫結至自訂專案的 Document Intelligence 資源已遭刪除，或已移至另一個資源群組。 有兩種方式可以解決此問題：
• 在相同訂用帳戶和資源群組下，使用相同的名稱重新建立 Document Intelligence 資源。
• 使用已移轉的 Document Intelligence 資源重新建立自訂專案，並指定相同的儲存體帳戶。
使用預先建置的應用程式或開啟自訂專案時，您會收到錯誤訊息
PermissionDenied。		 分析預先建置的模型或開啟自訂專案時主體無法存取 API/作業。 您的 Document Intelligence 資源可能已停用本機 (金鑰型) 驗證，沒有足夠的權限可存取資源。 請參考 Azure 角色指派來設定您的存取角色。
開啟自訂專案時，您會收到錯誤訊息
AuthorizationPermissionMismatch。		 要求未獲授權，無法使用指定的權限來執行作業。 您的儲存體帳戶可能已停用本機 (金鑰型) 驗證，而且您未獲授與可存取 Blob 資料的權限。 請參考 Azure 角色指派來設定您的存取角色。
您無法登入 Document Intelligence Studio，並收到錯誤訊息
InteractionRequiredAuthError:login_required:AADSTS50058:A silent sign-request was sent but no user is signed in		 您的瀏覽器可能會封鎖第三方 Cookie，因此您無法成功登入。 若要解決，請參閱管理瀏覽器的第三方設定。
管理 Studio 存取的第三方設定

Edge：

  • 移至 Microsoft Edge 的 [設定]
  • 搜尋「第三方」
  • 移至 [管理及刪除 Cookie 和網站資料]
  • 關閉 [封鎖第三方 Cookie] 的設定

Chrome：

  • 移至 Chrome 的 [設定]
  • 搜尋「第三方」
  • 在 [預設行為] 下方，選取 [允許第三方 Cookie]

FireFox：

  • 移至 Firefox 的 [設定]
  • 搜尋 「Cookie」
  • 在 [加強型追蹤保護] 底下，選取 [管理例外網站]
  • 為您的環境新增 https://documentintelligence.ai.azure.com 或文件智慧服務工作室 URL 作為例外網站

Safari：

  • 選擇 [Safari]>[喜好設定]
  • 選取 [隱私權]
  • 取消選取 [封鎖所有 Cookie]