

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á.

# Práticas recomendadas para consultas
<a name="bestqueries"></a>

## Consultas de exemplo
<a name="example-queries"></a>

Faça o download do [documento Exemplos de Consultas](samples/Example%20Queries.zip) para ver exemplos de consultas sobre tipos de documentos comuns nos setores de hipotecas, seguros, saúde e impostos.

## Práticas recomendadas gerais para consultas
<a name="generalbestqueries"></a>

## Extraindo células de tabelas
<a name="w2aac33c11b9"></a>

Crie uma consulta que contenha palavras do cabeçalho da linha e do cabeçalho da coluna.

Exemplos, para a imagem abaixo

Consulta 1: Em que data foi administrada a 2ª dose?

Resposta 2/8 1:/2021

Pergunta 2: Quem é o fabricante da 1ª dose?

Resposta 2: Pfizer

![Exemplo de cartão de registro de vacinação mostrando detalhes pessoais como nome, data de nascimento, número de identificação e entradas para várias doses de vacina com nome do produto, data e iniciais do profissional de saúde.](https://docs.aws.amazon.com/pt_br/textract/latest/dg/images/best-practice-cells.png)


## Extraindo tabelas usando consultas
<a name="w2aac33c11c11"></a>

A extração de tabelas inteiras ou de linhas ou colunas inteiras de informações usando consultas não é suportada.

## Respostas longas
<a name="w2aac33c11c13"></a>

Respostas longas aumentam a latência da resposta e podem levar a tempos limite. Tente fazer perguntas que respondam com menos de 100 palavras.

## Passando apenas dicas
<a name="w2aac33c11c15"></a>

Passar apenas o nome da chave como pergunta funcionará ao tentar extrair pares de valores-chave padrão de um formulário. Recomendamos formular perguntas completas para todos os outros casos de uso de extração.

Exemplos, para a imagem abaixo

Consulta 1: Nome do mutuário.

Resposta 1: Carlos Salazar

Consulta 2: Número do Seguro Social.

Resposta 2:999-99-9999

![Campo do formulário para detalhes do mutuário, incluindo nome, número do seguro social, estado civil e endereço.](https://docs.aws.amazon.com/pt_br/textract/latest/dg/images/best-practice-hints.png)


## Formulação geral das perguntas
<a name="w2aac33c11c17"></a>

Sempre que possível, use palavras do documento para criar a consulta.
+ Embora o Queries tente fazer a correspondência de acrônimo/sinônimo para alguns termos comuns do setor (SSN versus ID fiscal versus número de previdência social), usar a linguagem diretamente do documento geralmente melhorará os resultados.
+ Exemplo: se o documento disser “progresso do trabalho”, tente evitar chamá-lo usando outras variações, como “progresso do projeto”, “progresso do programa” ou “status do trabalho”

Em geral, faça uma pergunta em linguagem natural que comece com “O que é/Onde está/Quem é..”. A exceção a essa regra é quando se tenta extrair pares de valores-chave padrão. Nesse caso, você pode passar o nome da chave como uma consulta.

Evite perguntas mal formuladas ou gramaticalmente incorretas, pois elas podem resultar em respostas inesperadas. 
+ Exemplo de consulta mal formada: Quando?
+ Exemplo de consulta bem formulada: Quando foi administrada a primeira dose da vacina?

Seja o mais específico possível. Estes são alguns exemplos.
+ Quando o documento contém várias seções (por exemplo, “Mutuário” e “Co-Borrower”) e ambas as seções têm um campo chamado SSN, pergunte: “O que é o SSN para o mutuário?” e “Para que serve o SSN Co-Borrower?”
+ Quando o documento tiver vários campos relacionados à data, seja específico no idioma da consulta e pergunte “qual é a data em que o documento foi assinado? ou “qual é a data de nascimento do pedido”. Evite fazer perguntas ambíguas como “Qual é a data? ”

Se você conhece o layout do documento de antemão, dar dicas de localização melhora a precisão dos resultados. Por exemplo, “Qual é a data na parte superior?” ou pergunte “Qual é a data à esquerda?” , “Qual é a data na parte inferior?

## Configurando páginas para consultas
<a name="querypages"></a>

Ao trabalhar com consultas para documentos de várias páginas, você pode usar o `Page` parâmetro para especificar em quais páginas procurar a resposta da consulta. O que se segue é uma lista das melhores práticas para configurar Páginas
+ Se uma página não for especificada, ela será definida como `["1"]` padrão.
+ Os seguintes caracteres são permitidos na string do parâmetro:`0 1 2 3 4 5 6 7 8 9 - *`. Nenhum espaço em branco é permitido.
+ Ao usar \* para indicar todas as páginas, ele deve ser o único elemento na lista.
+ Você pode usar intervalos de página, como`[“1-3”, “1-1”, “4-*”]`. Onde `*` indica a última página do documento.
+ As páginas especificadas devem ser maiores que 0 e menores ou iguais ao número de páginas no documento.