部署範例標籤工具

文章
10/16/2024

此內容適用於： v2.1。

提示

如需增強體驗和進階模型品質，請嘗試文件智慧服務 v3.0 工作室。
v3.0 工作室支援使用 v2.1 標記資料定型的任何模型。
如需從 v2.1 移轉到 v3.0 的詳細資訊，您可以參閱 API 移轉指南。
請參閱我們的 REST API 或是 C#、Java、JavaScript 或 Python SDK 快速入門，以開始使用 v3.0 版本。

注意

此雲端託管的標籤工具可在 https://fott-2-1.azurewebsites.net/ 取得。只有在您想要為自己部署範例標籤工具時，才應該遵循本文件中的步驟。

文件智慧範例標籤工具是一項提供簡單使用者介面 (UI) 的應用程式，可用來手動為表單 (文件) 加上標籤以進行監督式學習。在本文中，我們將提供連結和指示，以教導您如何：

在本機執行範例標籤工具
將範例標籤工具部署到 Azure 容器執行個體 (ACI)
使用並參與開放原始碼表單標籤工具

在本機執行範例標籤工具

開始為資料加上標籤的最快速方式是在本機執行範例標籤工具。下列快速入門使用文件智慧 REST API 和範例標籤工具，以手動加上標籤的資料定型自訂模型。

開始使用 Azure AI 文件智慧服務。

使用 Azure 容器執行個體 (ACI) 進行部署

開始之前，請務必注意，有兩種方式可將範例標籤工具部署到 Azure 容器執行個體 (ACI)。下列兩個選項都可用來搭配 ACI 執行範例標籤工具：

使用 Azure 入口網站
使用 Azure CLI

Azure 入口網站

請遵循下列步驟，以使用 Azure 入口網站來建立新的資源：

登入 Azure 入口網站。
選取 [建立資源]。
接下來，選取 [Web 應用程式]。
首先，請確定已選取 [基本] 索引標籤。現在，您必須提供一些資訊：
- 訂閱 - 選取現有的 Azure 訂閱
- 資源群組 - 您可以使用現有的資源群組，或為此專案建立新的資源群組。建議您建立新的資源群組。
- 名稱 - 命名您的 Web 應用程式。
- 發佈 - 選取 [Docker 容器]
- 作業系統 - 選取 [Linux]
- 區域 - 選擇適合您的區域。
- Linux 方案 - 為您的應用程式服務選取定價層/方案。
接下來，選取 [Docker] 索引標籤。
現在讓我們設定您的 Docker 容器。除非另有說明，否則所有欄位均為必填：

選項 - 選取 [單一容器]
映像來源 - 選取 [私人登錄]
伺服器 URL - 設定為 https://mcr.microsoft.com
使用者名稱 (選擇性) - 建立使用者名稱。
密碼 (選擇性) - 建立您記得住的安全密碼。
映像及標籤 - 設定為 mcr.microsoft.com/azure-cognitive-services/custom-form/labeltool:latest-2.1
持續部署 - 如果您想要在開發小組變更範例標籤工具時收到自動更新，請設定為 [開啟]。
啟動命令 - 設定為 ./run.sh eula=accept

設定 Docker

接下來，選取 [檢閱 + 建立]，然後選取 [建立] 以部署您的 Web 應用程式。完成時，您可以在資源 [概觀] 中提供的 URL 存取 Web 應用程式。

持續部署

建立 Web 應用程式之後，您可以啟用持續部署選項：

從左窗格，選擇 [容器設定]。
在主視窗中，瀏覽至 [持續部署]，然後在 [開啟] 與 [關閉] 按鈕之間切換以設定您的喜好設定：

注意

當您建立 Web 應用程式時，也可以設定授權/驗證。但不需要這麼做就能開始使用。

重要

您可能需要為 Web 應用程式啟用 TLS，才能在其 https 位址進行檢視。請遵循啟用 TLS 端點中的指示來設定側車容器，然後為您的 Web 應用程式啟用 TLS/SSL。

Azure CLI

除了使用 Azure 入口網站，您也可以使用 Azure CLI 來建立資源。繼續之前，您必須安裝 Azure CLI。如果您已在使用 Azure CLI，則可以略過此步驟。

此命令有幾點須知：

DNS_NAME_LABEL=aci-demo-$RANDOM 會產生隨機功能變數名稱系統 (DNS) 身分識別。
此範例假設您有可用來建立資源的資源群組。請以與您訂閱相關聯的有效資源群組取代 <resource_group_name>。
您必須指定要建立資源的位置。請以您想要的 Web 應用程式區域取代 <region name>。
此命令會自動接受終端使用者授權合約 (EULA)。

從 Azure CLI 執行此命令，為範例標籤工具建立 Web 應用程式資源：

DNS_NAME_LABEL=aci-demo-$RANDOM

az container create \
  --resource-group <resource_group_name> \
  --name <name> \
  --image mcr.microsoft.com/azure-cognitive-services/custom-form/labeltool:latest-2.1 \
  --ports 3000 \
  --dns-name-label $DNS_NAME_LABEL \
  --location <region name> \
  --cpu 2 \
  --memory 8 \
  --command-line "./run.sh eula=accept"

連線至 Microsoft Entra ID 以進行授權

建議您將 Web 應用程式連線至 Microsoft Entra ID。此連線可確保只有具備有效認證的使用者，可以登入並使用您的 Web 應用程式。請依照設定 App Service 應用程式中的指示連線至 Microsoft Entra ID。

GitHub 上的開放原始碼

表單標籤工具也會做為 GitHub 上的開放原始碼專案提供。此工具是使用 React + Redux 建置的 Web 應用程式，並以 TypeScript 撰寫。若要深入瞭解或參與，請參閱表單標籤工具。

下一步

請參閱使用標籤進行定型快速入門，以了解如何使用此工具來手動為定型資料加上標籤並執行監督式學習。

分享方式：