本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
自訂查詢教學課程
本教學課程說明如何建立、訓練、評估、使用和管理轉接器。
使用轉接器，您可以提高 Amazon Textract API 操作的準確性，自訂模型的行為以符合您自己的需求和使用案例。使用此教學課程建立轉接器之後，您可以在使用 AnalyzeDocument API 操作分析自己的文件時使用它，也可以重新訓練轉接器以供日後改進。
於本教學課程中，您會了解：
使用 建立轉接器 AWS 管理主控台。
建立資料集以訓練轉接器。
註釋您的訓練資料。
在訓練資料集上訓練轉接器。
檢閱轉接器的效能。
重新訓練轉接器。
使用轉接器進行文件分析。
刪除您的轉接器。
先決條件
開始之前，建議您先閱讀 建立轉接器。
您還必須設定 AWS 您的帳戶，並安裝和設定 AWS 開發套件。如需 SDK 設定說明，請參閱 步驟 2：設定 AWS CLI 和 AWS SDKs。
建立轉接器
您必須先建立一個轉接器，才能訓練或使用轉接器。若要建立轉接器：
登入 AWS 管理主控台 並開啟 Amazon Textract 主控台
。 -
在左側窗格中，選擇自訂查詢。隨即顯示 Amazon Textract 自訂查詢登陸頁面。
-
自訂查詢登陸頁面會顯示所有轉接器的清單，還有一個按鈕可建立轉接器。選擇建立轉接器以建立轉接器。每個 AWS 帳戶每月可以執行的成功訓練數量有限。如需限制的詳細資訊在 Amazon Textract 中設定配額，請參閱 。
-
在下列頁面上，輸入轉接器名稱，選擇是否要自動更新您的轉接器，並選擇性地新增標籤。然後，選取建立轉接器。當您選擇「自動更新」時，Amazon Textract 會在更新預先訓練的查詢功能時自動更新轉接器。
建立轉接器後，您將能夠查看該轉接器的詳細資訊，包括轉接器名稱和轉接器 ID。這些詳細資訊的存在會驗證轉接器是否已成功建立。
您現在可以建立用於訓練和測試轉接器的資料集。
建立資料集
在此步驟中，您會透過從本機電腦或從 Amazon S3 儲存貯體上傳映像來建立訓練資料集和測試資料集。如需資料集的詳細資訊，請參閱 偵測文字 準備訓練和測試資料集
從本機電腦上傳映像時，您一次最多可以上傳 30 張映像。如果您有大量影像要上傳，請考慮從 Amazon S3 儲存貯體匯入影像來建立資料集。
-
若要開始建立資料集，請從轉接器清單中選擇轉接器，然後選擇建立資料集。
-
在資料集組態區段中，選擇手動分割或自動分割。透過手動分割，您可以將個別映像指定為訓練和測試資料集的一部分。如果您選擇 Autosplit，它會在您上傳所有映像時自動定義您的訓練和測試集。對於第一次訓練轉接器的人員，建議使用手動分割。現在，選擇 Autosplit。
-
在訓練資料集詳細資訊區段中，您可以選擇從電腦上傳文件，或從 S3 儲存貯體匯入文件。如果您選擇從 Amazon S3 儲存貯體匯入文件，請提供包含訓練映像檔的儲存貯體和資料夾的路徑。如果您直接從電腦上傳文件，請注意，您一次只能上傳 30 個文件。基於本教學的目的，請選擇從您的電腦上傳文件。
-
在測試資料集詳細資訊區段中，您可以選擇從電腦上傳文件，或從 S3 儲存貯體匯入文件。基於本教學的目的，請選擇從您的電腦上傳文件。
-
選擇建立資料集。
-
建立資料集後，系統會將您導向資料集詳細資訊頁面。資料集詳細資訊頁面會顯示整個資料集中所有文件的清單，以及已指派文件的資料集 （訓練或測試） 部分。在指派給資料欄的資料集下檢視此項目。您也可以檢視下列項目：
-
文件名稱
-
文件狀態
-
文件中的頁面數
-
文件類型
-
文件大小
-
如果文件是訓練集或測試集的一部分
-
-
選取將文件新增至資料集，並將至少五個文件新增至您的訓練和測試資料集。如果您先前已選取 Autosplit，您可以一次新增所有文件。
-
如果您想要將更多文件新增至資料集，請使用新增文件功能表來執行此操作。
在開始訓練轉接器之前，您需要使用查詢註釋訓練文件。這是建立資訊清單檔案的「annotations-ref」項目的必要項目。將所有文件新增至訓練或測試集後，您就可以開始註釋程序。
註釋和驗證
在此步驟中，您將查詢和標籤指派給您上傳到訓練和測試資料集的每個文件。您可以使用 AWS 管理主控台 註釋工具將查詢連結至文件頁面上的相關答案。
若要將查詢和答案指派給您的文件：
-
從轉接器登陸頁面選取建立查詢。
-
在文字方塊中輸入查詢來新增查詢。
-
若要新增更多查詢，請選擇新增新查詢。查詢可以有「原始文字」回應或「二進位 - 是/否」回應。若要使用二進位回應建立查詢，請使用進階設定。
-
建立查詢之後，您必須將標籤指派給文件。若要設定文件的標籤，請選取自動標記或手動標記。建議您在第一次訓練轉接器時自動標記。選取自動標記選項，然後選擇開始自動標記。
-
自動標記程序需要一些時間才能完成。完成後，您會收到「自動標記現在已完成」的通知。標籤程序完成後，您必須驗證標籤的準確性。在詳細資訊頁面的轉接器詳細資訊面板中選取驗證文件，然後從資料集頁面選擇開始檢閱。
-
在註釋工具中，您可以選取個別文件，並檢視這些文件中的個別頁面。在「檢閱回應」區段下，選取指派給文件頁面的查詢。如果查詢的答案不正確，您可以按一下查詢的編輯按鈕來編輯回應。
對於有是/否答案的查詢，請選取是、否或空白。然後，選擇套用。
編輯指派給查詢之標籤的 OCR 時，請選擇提供的回應，然後在部分文件映像周圍繪製週框方塊。若要這樣做，請使用註釋工具底部的工具列上的「B」快速鍵或週框方塊工具。然後，選擇套用。
如果查詢應該有多個回應元素 （答案），您可以新增其他回應。若要這樣做，請選取查詢，然後選擇新增回應。然後，系統會提示您在具有答案的文件區域上繪製週框方塊。確認週框方塊的標籤正確。
若要新增文件頁面的新查詢，請選擇新增查詢。如果您新增查詢，則必須指定要新增的查詢，然後為查詢標籤繪製週框方塊。
完成後，請選擇提交，然後選擇下一個文件和下一組查詢和回應。重複此步驟，直到您檢閱所有查詢和回應為止。
在您檢閱和評估所有查詢和回應之後，請選取提交並關閉。
培訓
將所有文件新增至訓練集或測試集並檢閱查詢產生的回應後，您就可以訓練轉接器。
若要訓練轉接器：
-
首先，按一下資料集管理頁面上的訓練轉接器。
-
啟動訓練程序時，您可以指定 Amazon S3 儲存貯體，其中包含轉接器訓練任務的輸出。如果您指定的 Amazon S3 儲存貯體位置尚不存在，則會為您建立儲存貯體路徑。您也可以將標籤新增至轉接器以進行追蹤，並自訂加密設定。自訂轉接器訓練以符合您的需求，然後選擇訓練轉接器。
-
在下一頁中，選擇訓練轉接器以確認您想要開始訓練程序。這將建立您的第一個版本的轉接器。
訓練程序開始後，您可以在轉接器登陸頁面上監控訓練程序狀態。
當訓練程序完成時，您會收到通知。然後，您可以透過檢查指標來評估轉接器的效能。
評估轉接器效能
若要評估模型效能，請使用左側導覽窗格選取要評估的轉接器版本。
透過檢查轉接器的指標，您可以判斷轉接器如何對資料集中的文件和您定義的查詢執行。您可以在訓練資料的不同元素中看到轉接器的 F1 分數、精確度和召回：查詢、文件和頁面。若要切換這些元素的效能，請選擇指標顯示窗格下方的不同標籤。
您也可以隨時切換切換切換到基準指標切換來檢視基準指標。
轉接器版本效能的摘要也包含有關如何改善轉接器效能的一些秘訣。您可以隨時檢閱這些秘訣，以改善轉接器。如需如何管理和改善轉接器的詳細資訊，請參閱 評估和改善轉接器。
若要示範轉接器並查看其在文件上的效能：
-
選擇嘗試轉接器。
-
在嘗試轉接器頁面上，您可以選擇使用轉接器分析的文件。選取選擇文件按鈕，然後瀏覽至裝置上的文件位置。或者，將文件拖放到上傳文件窗格中。
上傳文件後，試用轉接器頁面會更新以顯示轉接器分析的結果，包括查詢、查詢答案和可信度等級。如果您對轉接器的效能感到滿意，則可以在呼叫 AnalyzeDocument 或 StartDocumentAnalysis 時使用轉接器進行推論。否則，您可以透過使用其他文件重新訓練轉接器來改善轉接器的效能。
改善轉接器
若要改善轉接器的效能：
-
在轉接器詳細資訊頁面上選擇修改資料集。
-
在資料集概觀頁面上，選取新增文件。若要重新訓練轉接器，請新增至少五個文件至訓練資料集。
系統會通知您文件已新增至資料集。選取開始檢閱以檢閱自動標記程序的結果。
檢閱查詢和回應。在您檢閱並核准新增文件的所有註釋之後，請選擇提交並關閉。
在資料集管理頁面上，選擇訓練轉接器，開始針對訓練資料集中的所有資料訓練轉接器，包括新的訓練文件。
您執行的每個訓練任務都會建立新的轉接器版本。請記下新轉接器版本的名稱，以確保您正在評估適當轉接器版本的效能。
Inference
建立轉接器後，您會收到自訂轉接器的 ID。您可以將此 ID 提供給 AnalyzeDocument 操作以進行同步文件分析，或提供 StartDocumentAnalysis 操作以進行非同步分析。
提供轉接器 ID 會自動將轉接器整合到分析程序中，並使用它來增強文件的預測。如此一來，您就可以利用 AnalyzeDocument 的功能，同時自訂它以滿足您的需求。
如需如何使用轉接器和 AnalyzeDocument API 操作執行推論的範例，請參閱 使用 Amazon Textract 分析文件文字。
當多個轉接器必須套用至相同文件中的不同頁面時，您可以指定一或多個轉接器及其個別轉接器版本 （做為 API 請求的一部分）。您可以使用頁面參數來指定要套用轉接器的頁面。
注意下列事項：
這類似於查詢的 Page 參數的運作方式。注意下列事項：
-
如果未指定頁面，則
["1"]預設為 。 -
下列字元在參數字串中有效：
1 2 3 4 5 6 7 8 9 - *。空白空格無效。 -
使用 * 表示所有頁面時，它必須是清單中的唯一元素。
-
Page參數不會在轉接器之間重疊。一個頁面只能套用一個轉接器。
轉接器管理
下列步驟會反覆重複 （在初始訓練轉接器之後）：
在 Amazon Textract 主控台的轉接器詳細資訊頁面上，選擇修改資料集。
選取新增文件。
將至少另外五個文件新增至訓練資料集，以重新訓練轉接器。
系統會通知您文件已新增至資料集。選取開始檢閱以檢閱自動標記程序的結果。
檢閱查詢和回應。在您檢閱並核准新文件的所有註釋之後，請選取訓練轉接器。
等待轉接器完成新的一輪訓練，然後檢查新轉接器版本的效能指標。
將模型訓練至目標效能等級後，您可以使用轉接器在應用程式中進行推論。
請務必刪除不再需要的轉接器版本。若要刪除轉接器：
前往轉接器登陸頁面，選取轉接器，然後選擇刪除。
在文字方塊中輸入刪除，然後選擇刪除。
