自訂實體辨識 (API) 的即時分析 - Amazon Comprehend
建立 端點執行實體偵測

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

自訂實體辨識 (API) 的即時分析

您可以使用 Amazon Comprehend API 搭配自訂模型執行即時分析。首先，您要建立端點來執行即時分析。建立端點之後，您會執行即時分析。

如需有關佈建端點輸送量和相關成本的資訊，請參閱 使用 Amazon Comprehend 端點。

建立用於自訂實體偵測的端點

如需與端點相關聯的成本資訊，請參閱 使用 Amazon Comprehend 端點。

使用 建立端點 AWS CLI

若要使用 建立端點 AWS CLI，請使用 create-endpoint命令：

$ aws comprehend create-endpoint \
> --desired-inference-units number of inference units \
> --endpoint-name endpoint name \
> --model-arn arn:aws:comprehend:region:account-id:model/example \
> --tags Key=Key,Value=Value

如果您的命令成功，Amazon Comprehend 會以端點 ARN 回應：

{
   "EndpointArn": "Arn"
}

如需此命令、其參數引數及其輸出的詳細資訊，請參閱 AWS CLI 命令參考create-endpoint中的 。

執行即時自訂實體偵測

為自訂實體識別器模型建立端點後，您可以使用端點來執行 DetectEntities API 操作。您可以使用 text或 bytes 參數提供文字輸入。使用 bytes 參數輸入其他輸入類型。

對於映像檔案和 PDF 檔案，您可以使用 DocumentReaderConfig 參數來覆寫預設的文字擷取動作。如需詳細資訊，請參閱 設定文字擷取選項。

使用 偵測文字中的實體 AWS CLI

若要偵測文字中的自訂實體，請使用 text 參數中的輸入文字執行 detect-entities命令。

範例 ：使用 CLI 偵測輸入文字中的實體
$ aws comprehend detect-entities \
> --endpoint-arn arn \
> --language-code en \
> --text  "Andy Jassy is the CEO of Amazon."

如果您的命令成功，Amazon Comprehend 會回應分析。對於 Amazon Comprehend 偵測到的每個實體，它提供實體類型、文字、位置和可信度分數。

使用 偵測半結構化文件中的實體 AWS CLI

若要偵測 PDF、Word 或映像檔中的自訂實體，請在 bytes 參數中使用輸入檔案執行 detect-entities命令。

範例 ：使用 CLI 偵測映像檔案中的實體

此範例說明如何使用 base64 編碼影像位元組fileb的選項，在影像檔案中傳遞 。如需詳細資訊，請參閱 AWS Command Line Interface 《 使用者指南》中的二進位大型物件。

此範例也會傳入名為 的 JSON 檔案，config.json以設定文字擷取選項。

$ aws comprehend detect-entities \
> --endpoint-arn arn \
> --language-code en \
> --bytes fileb://image1.jpg   \
> --document-reader-config file://config.json

config.json 檔案包含下列內容。


 {
    "DocumentReadMode": "FORCE_DOCUMENT_READ_ACTION",
    "DocumentReadAction": "TEXTRACT_DETECT_DOCUMENT_TEXT"    
 }

如需命令語法的詳細資訊，請參閱《Amazon Comprehend API 參考》中的 DetectEntities。