As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Extraia informações de texto usando o reconhecimento de entidade nomeada
Para extrair informações de texto não estruturado e classificá-las em categorias predefinidas, use uma tarefa de rotulagem de reconhecimento de entidade (NER) chamada Amazon SageMaker Ground Truth. Tradicionalmente, a NER envolve examinar dados de texto para localizar frases substantivas, chamadas *entidades nomeadas* e categorizar cada uma com um rótulo, como "pessoa", "organização" ou "marca". Você pode ampliar essa tarefa para rotular longos períodos de texto e categorizar essas sequências com rótulos predefinidos especificados. Você pode criar um trabalho de rotulagem de reconhecimento de entidade nomeada usando a seção Ground Truth do console Amazon SageMaker AI ou a [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html)operação.
Quando encarregados de um trabalho de rotulagem de reconhecimento de entidade nomeada, os operadores aplicam seus rótulos a palavras ou frases específicas dentro de um bloco de texto maior. Eles escolhem um rótulo e o aplicam usando o cursor para realçar a parte do texto à qual o rótulo se aplica. A ferramenta de reconhecimento de entidades nomeadas Ground Truth é compatível com anotações sobrepostas, seleção de rótulos no contexto e seleção de vários rótulos para um único destaque. Além disso, os operadores podem usar seus teclados para selecionar rótulos rapidamente.
**Importante**
Se você criar manualmente um arquivo de manifesto de entrada, use `"source"` para identificar o texto que você deseja rotular. Para obter mais informações, consulte [Dados de entrada](sms-data-input.md).
## Criar um trabalho de rotulagem de reconhecimento de entidade nomeada (console)
Você pode seguir as instruções [Criar um trabalho de rotulagem (console)](sms-create-labeling-job-console.md) para aprender como criar um trabalho de rotulagem de reconhecimento de entidade nomeada no console de SageMaker IA. Na Etapa 10, escolha **Texto** no menu suspenso **Categoria da tarefa** e selecione **Reconhecimento de entidades nomeadas** como o tipo de tarefa.
O Ground Truth fornece uma interface de usuário do operador que se parece com a seguinte para tarefas de rotulagem: Ao criar o trabalho de rotulagem com o console, você especifica instruções para ajudar os operadores a concluírem o trabalho e os rótulos que eles podem escolher.
## Criar um trabalho de rotulagem de reconhecimento de entidade nomeada (API)
Para criar um trabalho de rotulagem de reconhecimento de entidade nomeada, usando a operação de SageMaker API`CreateLabelingJob`. Essa API define essa operação para todos AWS SDKs. Para ver uma lista de idiomas específicos com SDKs suporte para essa operação, **consulte a seção Consulte também** do. [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html)
Siga as instruções em [Criar um trabalho de rotulagem (API)](sms-create-labeling-job-api.md) e faça o seguinte enquanto você configura a solicitação:
+ As funções do Lambda de pré-anotação para esse tipo de tarefa terminam com `PRE-NamedEntityRecognition`. Para encontrar a pré-anotação Lambda ARN para sua região, consulte. [PreHumanTaskLambdaArn](https://docs.aws.amazon.com/sagemaker/latest/dg/API_HumanTaskConfig.html#SageMaker-Type-HumanTaskConfig-PreHumanTaskLambdaArn)
+ As funções do Lambda de consolidação de anotações para esse tipo de tarefa terminam com `ACS-NamedEntityRecognition`. Para encontrar o ARN Lambda de consolidação de anotações para sua região, consulte. [AnnotationConsolidationLambdaArn](https://docs.aws.amazon.com/sagemaker/latest/dg/API_AnnotationConsolidationConfig.html#SageMaker-Type-AnnotationConsolidationConfig-AnnotationConsolidationLambdaArn)
+ Você deve fornecer o seguinte ARN para `[HumanTaskUiArn](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UiConfig.html#sagemaker-Type-UiConfig-HumanTaskUiArn)`:
```
arn:aws:sagemaker:{{aws-region}}:394669845002:human-task-ui/NamedEntityRecognition
```
`{{aws-region}}`Substitua pelo Região da AWS que você usa para criar o trabalho de etiquetagem. Por exemplo, use `us-west-1` se você criar um trabalho de rotulagem no Oeste dos EUA (Norte da Califórnia).
+ Forneça instruções ao operador no arquivo de configuração da categoria de rótulo usando o parâmetro `instructions`. Você pode usar uma string ou linguagem de marcação HTML em `shortInstruction` e campos `fullInstruction`. Consulte mais detalhes em [Forneça instruções de trabalho em um Arquivo de configuração de categoria de rótulo](#worker-instructions-ner).
```
"instructions": {"shortInstruction":"Add header
Add Instructions
", "fullInstruction":"Add additional instructions.
"}
```
Veja a seguir um exemplo de uma [solicitação do SDK Python (Boto3) da AWS](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html#SageMaker.Client.create_labeling_job) para criar um trabalho de rotulagem de dados automatizada na região Leste dos EUA (Norte da Virgínia). Todos os parâmetros em vermelho devem ser substituídos por suas especificações e recursos.
```
response = client.create_labeling_job(
LabelingJobName={{'example-ner-labeling-job'}},
LabelAttributeName={{'label'}},
InputConfig={
'DataSource': {
'S3DataSource': {
'ManifestS3Uri': {{'s3://bucket/path/manifest-with-input-data.json'}}
}
},
'DataAttributes': {
'ContentClassifiers': [
{{'FreeOfPersonallyIdentifiableInformation'|'FreeOfAdultContent'}},
]
}
},
OutputConfig={
'S3OutputPath': {{'s3://bucket/path/file-to-store-output-data'}},
'KmsKeyId': {{'string'}}
},
RoleArn={{'arn:aws:iam::*:role/*'}},
LabelCategoryConfigS3Uri={{'s3://bucket/path/label-categories.json'}},
StoppingConditions={
'MaxHumanLabeledObjectCount': {{123}},
'MaxPercentageOfInputDatasetLabeled': {{123}}
},
HumanTaskConfig={
'WorkteamArn': {{'arn:aws:sagemaker:region:*:workteam/private-crowd/*'}},
'UiConfig': {
'HumanTaskUiArn': 'arn:aws:sagemaker:{{us-east-1}}:394669845002:human-task-ui/NamedEntityRecognition'
},
'PreHumanTaskLambdaArn': 'arn:aws:lambda:{{us-east-1:432418664414}}:function:PRE-NamedEntityRecognition',
'TaskKeywords': [
{{'Named entity Recognition'}},
],
'TaskTitle': {{'Named entity Recognition task'}},
'TaskDescription': {{'Apply the labels provided to specific words or phrases within the larger text block.'}},
'NumberOfHumanWorkersPerDataObject': {{1}},
'TaskTimeLimitInSeconds': {{28800}},
'TaskAvailabilityLifetimeInSeconds': {{864000}},
'MaxConcurrentTaskCount': {{1000}},
'AnnotationConsolidationConfig': {
'AnnotationConsolidationLambdaArn': 'arn:aws:lambda:{{us-east-1:432418664414}}:function:ACS-NamedEntityRecognition'
},
Tags=[
{
'Key': {{'string'}},
'Value': {{'string'
}} },
]
)
```
### Forneça instruções de trabalho em um Arquivo de configuração de categoria de rótulo
Você deve fornecer instruções ao operador no arquivo de configuração da categoria de rótulo em que você identifica com o parâmetro `LabelCategoryConfigS3Uri` no `CreateLabelingJob`. Você pode usar essas instruções para fornecer detalhes sobre a tarefa que você deseja que os operadores executem e ajudá-los a usar a ferramenta com eficiência.
Você fornece instruções curtas e longas usando `shortInstruction` e `fullInstruction` no parâmetro `instructions`, respectivamente. Para saber mais sobre esses tipos de instrução, consulte [Criar páginas de instrução](sms-creating-instruction-pages.md).
Veja a seguir um exemplo de um arquivo de configuração de categoria de rótulo com instruções que podem ser usadas para uma tarefa de rotulagem de reconhecimento de entidade nomeada.
```
{
"document-version": "2018-11-28",
"labels": [
{
"label": "label1",
"shortDisplayName": "L1"
},
{
"label": "label2",
"shortDisplayName": "L2"
},
{
"label": "label3",
"shortDisplayName": "L3"
},
{
"label": "label4",
"shortDisplayName": "L4"
},
{
"label": "label5",
"shortDisplayName": "L5"
}
],
"instructions": {
"shortInstruction": "Enter description of the labels that workers have
to choose from
Add examples to help workers understand the label
",
"fullInstruction": "
- Read the text carefully.
- Highlight words, phrases, or sections of the text.
- Choose the label that best matches what you have highlighted.
- To change a label, choose highlighted text and select a new label.
- To remove a label from highlighted text, choose the X next to the
abbreviated label name on the highlighted text.
- You can select all of a previously highlighted text, but not a portion of it.
"
}
}
```
## Dados de saída de reconhecimento de entidades nomeadas
Depois de criar um trabalho de rotulagem de reconhecimento de entidade nomeada, seus dados de saída serão localizados no bucket do Amazon S3 especificado no parâmetro `S3OutputPath` ao usar a API ou no campo **Localização do conjunto de dados** de saída da seção **Visão geral do trabalho** do console.
Para saber mais sobre o arquivo manifesto de saída gerado pelo Ground Truth, e sobre a estrutura do arquivo que o Ground Truth usa para armazenar os dados de saída, consulte [Rotulando dados de saída do trabalho](sms-data-output.md).