用于自定义实体识别的实时分析 (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。

运行实时自定义实体检测

为自定义实体识别器模型创建端点后，您可以使用该端点运行 DetectEntitiesAPI 操作。您可以使用 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 检测图像文件中的实体

此示例说明如何使用 fileb 选项对图像字节进行 base64 编码，从而传入图像文件。有关更多信息，请参阅《AWS Command Line Interface 用户指南》中的二进制大型对象。

此示例还传入名为 config.json 的 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中的。