Aviso de fim do suporte: em 15 de setembro de 2025, o suporte para o Amazon Lex V1 AWS será interrompido. Após 15 de setembro de 2025, você não poderá mais acessar o console do Amazon Lex V1 nem os respectivos recursos. Se você estiver usando o Amazon Lex V2, consulte o [guia do Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html) em vez disso.
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á.
# Intenções integradas e tipos de slot
Para facilitar a criação dos bots, o Amazon Lex permite que você use as intenções integradas e os tipos de slot padrão.
**Topics**
+ [Intenções integradas](howitworks-builtins-intents.md)
+ [Tipos de slot integrados](howitworks-builtins-slots.md)
# Intenções integradas
Para ações comuns, você pode usar a biblioteca de intenções integradas padrão. Para criar uma intenção de uma intenção integrada, escolha uma intenção no console e forneça um novo nome. A nova intenção tem a configuração de intenção básica, como a amostra de declarações.
Na implementação atual, você não pode:
+ Adicionar ou remover amostra de declarações da intenção básica
+ Configurar slots para intenções integradas
**Para adicionar uma intenção integrada a um bot**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon Lex em [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).
1. Escolha o bot ao qual adicionar a intenção integrada.
1. No painel de navegação, escolha o sinal de adição (\$1) ao lado de **Intenções**.
1. Em **Adicionar intenção**, escolha **Pesquisar intenções existentes**.
1. Na caixa **Intenções de pesquisa**, insira o nome da intenção integrada a ser adicionada ao seu bot.
1. Em **Copiar intenção integrada**, dê um nome à intenção e escolha **Adicionar**.
1. Configure a intenção conforme necessário para o seu bot.
**Topics**
+ [AMAZON.CancelIntent](built-in-intent-cancel.md)
+ [AMAZON.FallbackIntent](built-in-intent-fallback.md)
+ [AMAZON.HelpIntent](built-in-intent-help.md)
+ [AMAZON.KendraSearchIntent](built-in-intent-kendra-search.md)
+ [AMAZON.PauseIntent](built-in-intent-pause.md)
+ [AMAZON.RepeatIntent](built-in-intent-repeat.md)
+ [AMAZON.ResumeIntent](built-in-intent-resume.md)
+ [AMAZON.StartOverIntent](built-in-intent-start-over.md)
+ [AMAZON.StopIntent](built-in-intent-stop.md)
**nota**
Para a localidade em inglês (EUA) (en-US), o Amazon Lex oferece suporte a intenções integradas padrão da Alexa. Para obter uma lista de intenções integradas, consulte [Intenções integradas padrão](https://developer.amazon.com/docs/custom-skills/standard-built-in-intents.html) no *Alexa Skills Kit*.
O Amazon Lex não oferece suporte às seguintes intenções:
`AMAZON.YesIntent`
`AMAZON.NoIntent`
As intenções na [Biblioteca de intenções integradas](https://developer.amazon.com/docs/custom-skills/built-in-intent-library.html) do *Alexa Skills Kit*
# AMAZON.CancelIntent
Responde a palavras e frases que indicam que o usuário deseja cancelar a interação atual. Seu aplicativo pode usar essa intenção para remover valores do tipo de slot e outros atributos antes de encerrar a interação com o usuário.
Declarações comuns:
+ cancelar
+ não se preocupe
+ esqueça
# AMAZON.FallbackIntent
Quando a entrada de um usuário em uma intenção não é o que um bot espera, você pode configurar o Amazon Lex para invocar uma *intenção de fallback*. Por exemplo, se a entrada do usuário "Eu gostaria de pedir doce" não corresponder a uma intenção em seu bot `OrderFlowers`, o Amazon Lex invocará a intenção de fallback para lidar com a resposta.
Inclua uma intenção de fallback adicionando o tipo de intenção `AMAZON.FallbackIntent` integrada ao bot. Você pode especificar a intenção usando a operação [PutBot](API_PutBot.md) ou escolhendo a intenção na lista de intenções integradas no console.
A invocação de uma intenção de fallback usa duas etapas. Na primeira etapa, a intenção de fallback é correspondida com base na entrada do usuário. Quando a intenção de fallback é correspondida, a maneira como o bot se comporta depende do número de novas tentativas configuradas para um prompt. Por exemplo, se o número máximo de tentativas para determinar uma intenção for 2, o bot retornará o prompt de esclarecimento do bot duas vezes antes de invocar a intenção de fallback.
O Amazon Lex corresponde à intenção de fallback nestas situações:
+ A entrada do usuário para uma intenção não corresponde à entrada esperada pelo bot
+ A entrada de áudio é ruído ou a entrada de texto não é reconhecida como palavras.
+ A entrada do usuário é ambígua, e o Amazon Lex não consegue determinar qual intenção invocar.
A intenção de fallback é invocada quando:
+ O bot não reconhece a entrada do usuário como uma intenção após o número configurado de tentativas para esclarecimento quando a conversa é iniciada.
+ Uma intenção não reconhece a entrada do usuário como um valor de slot após o número configurado de tentativas.
+ Uma intenção não reconhece a entrada do usuário como uma resposta a um prompt de confirmação após o número configurado de tentativas.
Você pode usar o seguinte com uma intenção de fallback:
+ Uma função do Lambda de atendimento
+ Uma declaração de conclusão
+ Um prompt de acompanhamento
Você não pode adicionar o seguinte a uma intenção de fallback:
+ Enunciados
+ Slots
+ Uma função do Lambda de inicialização e validação
+ Um prompt de confirmação
Se você tiver configurado uma instrução de anulação e uma intenção de fallback para um bot, o Amazon Lex usará a intenção de fallback. Se você precisar que seu bot tenha uma instrução de cancelamento, use a função de atendimento para que a intenção de fallback forneça o mesmo comportamento que uma instrução de cancelamento. Para obter mais informações, consulte o parâmetro `abortStatement` da operação [PutBot](API_PutBot.md).
## Usar prompts de esclarecimento
Se você fornecer ao bot um prompt de esclarecimento, o prompt será usado para solicitar uma intenção válida do usuário. O prompt de esclarecimento será repetido o número de vezes que você configurou. Depois disso, a intenção de fallback será invocada.
Se você não definir um prompt de esclarecimento ao criar um bot e o usuário não iniciar a conversa com uma intenção válida, o Amazon Lex chamará imediatamente sua intenção de fallback.
Quando você usa uma intenção de fallback sem um prompt de esclarecimento, o Amazon Lex não chama o fallback nestas circunstâncias:
+ Quando o usuário responde a um prompt de acompanhamento, mas não fornece uma intenção. Por exemplo, em resposta a um prompt de acompanhamento que diz "Você quer mais alguma coisa hoje?", o usuário diz "Sim". O Amazon Lex retorna uma exceção 400 Bad Request porque não tem um prompt de esclarecimento para enviar ao usuário e obter uma intenção.
+ Ao usar uma AWS Lambda função, você retorna um tipo `ElicitIntent` de diálogo. Como o Amazon Lex não tem um prompt de esclarecimento para obter uma intenção do usuário, ele retorna uma exceção 400 Bad Request.
+ Ao usar a operação `PutSession`, envie um tipo de diálogo `ElicitIntent`. Como o Amazon Lex não tem um prompt de esclarecimento para obter uma intenção do usuário, ele retorna uma exceção 400 Bad Request.
## Usar uma função do Lambda com uma intenção de fallback
Quando uma intenção de fallback é invocada, a resposta depende da configuração do parâmetro `fulfillmentActivity` para a operação [PutIntent](API_PutIntent.md). O bot realiza uma das seguintes ações:
+ Retorna as informações de intenção para o aplicativo cliente.
+ Chama a função do Lambda de atendimento. Ele chama a função com as variáveis de sessão que são definidas para a sessão.
Para obter mais informações sobre como definir a resposta quando uma intenção de fallback é invocada, consulte o parâmetro `fulfillmentActivity` da operação [PutIntent](API_PutIntent.md).
Se você usar a função do Lambda de atendimento em sua intenção de fallback, poderá usar essa função para chamar outra intenção ou executar alguma forma de comunicação com o usuário, como coletar um número de retorno de chamada ou abrir uma sessão com um representante de atendimento ao cliente.
É possível executar qualquer ação em uma função do Lambda de intenção de fallback que possa ser executada na função de cumprimento para qualquer outra intenção. Para obter mais informações sobre como criar uma função de atendimento usando AWS Lambda, consulte[Uso de funções do Lambda](using-lambda.md).
Uma intenção de fallback pode ser invocada várias vezes na mesma sessão. Por exemplo, imagine que a função do Lambda usa a ação de diálogo `ElicitIntent` para solicitar ao usuário uma intenção diferente. Se o Amazon Lex não conseguir inferir a intenção do usuário após o número configurado de tentativas, ele invocará a intenção de fallback novamente. Ele também invoca a intenção de fallback quando o usuário não responde com um valor de slot válido após o número configurado de tentativas.
É possível configurar uma função do Lambda para controlar o número de vezes que a intenção de fallback é chamada usando uma variável de sessão. Sua função do Lambda poderá executar uma ação diferente se for chamada mais vezes do que o limite definido na função do Lambda. Para mais informações sobre variáveis de sessão, consulte [Definição dos atributos da sessão](context-mgmt-session-attribs.md).
# AMAZON.HelpIntent
Responde a palavras ou frases que indicam que o usuário precisa de ajuda ao interagir com seu bot. Quando essa intenção é invocada, você pode configurar o aplicativo ou a função do Lambda para fornecer informações sobre os recursos do seu bot, fazer perguntas de acompanhamento sobre áreas de ajuda ou entregar a interação a um atendente humano.
Declarações comuns:
+ ajuda
+ ajude-me
+ você pode me ajudar
# AMAZON.KendraSearchIntent
Para pesquisar documentos indexados com o Amazon Kendra, use a intenção `AMAZON.KendraSearchIntent`. Quando o Amazon Lex não consegue determinar a próxima ação em uma conversa com o usuário, ele aciona a intenção de pesquisa.
O `AMAZON.KendraSearchIntent` está disponível somente em inglês (EUA) (en-US) e nas regiões Leste dos EUA (Norte da Virgínia), Oeste dos EUA (Oregon) e Europa (Irlanda).
O Amazon Kendra é machine-learning-based um serviço de pesquisa que indexa documentos em linguagem natural, como documentos PDF ou arquivos do Microsoft Word. Ele pode pesquisar documentos indexados e retornar os seguintes tipos de respostas a uma pergunta:
+ Uma resposta
+ Uma entrada de uma pergunta frequente que pode responder à pergunta
+ Um documento relacionado à pergunta
Para ver um exemplo de uso de `AMAZON.KendraSearchIntent`, consulte [Exemplo: criar um bot de perguntas frequentes para um índice do Amazon Kendra](faq-bot-kendra-search.md).
Se você configurar uma intenção `AMAZON.KendraSearchIntent` para o bot, o Amazon Lex chamará a intenção sempre que não conseguir determinar a declaração do usuário para um slot ou uma intenção. Por exemplo, se o bot estiver provocando uma resposta para um tipo de slot chamado "cobertura de pizza" e o usuário disser "O que é pizza?", o Amazon Lex chamará `AMAZON.KendraSearchIntent` para lidar com a pergunta. Se não houver resposta do Amazon Kendra, a conversa continuará conforme configurado no bot.
Quando `AMAZON.KendraSearchIntent` e `AMAZON.FallbackIntent` são usadas no mesmo bot, o Amazon Lex usa as intenções da seguinte forma:
1. O Amazon Lex chama `AMAZON.KendraSearchIntent`. A intenção chama a operação `Query` do Amazon Kendra.
1. Se o Amazon Kendra retornar uma resposta, o Amazon Lex exibirá o resultado para o usuário.
1. Se não houver resposta do Amazon Kendra, o Amazon Lex avisará novamente o usuário. A próxima ação depende da resposta do usuário.
+ Se a resposta do usuário contiver uma declaração reconhecida pelo Amazon Lex, como preencher um valor de slot ou confirmar uma intenção, a conversa com o usuário prosseguirá conforme configurado para o bot.
+ Se a resposta do usuário não contiver uma declaração reconhecida pelo Amazon Lex, o Amazon Lex fará outra chamada para a operação `Query`.
1. Se não houver resposta após o número configurado de novas tentativas, o Amazon Lex chamará `AMAZON.FallbackIntent` e encerrará a conversa com o usuário.
Há três maneiras de usar `AMAZON.KendraSearchIntent` para fazer uma solicitação ao Amazon Kendra:
+ Deixe que a intenção da pesquisa faça a solicitação por você. O Amazon Lex chama o Amazon Kendra com a declaração do usuário como a string de pesquisa. Ao criar a intenção, você pode definir uma string de filtro de consulta que limite o número de respostas retornadas pelo Amazon Kendra. O Amazon Lex usa o filtro na solicitação de consulta.
+ Adicione outros parâmetros de consulta à solicitação para restringir os resultados da pesquisa usando a função do Lambda do diálogo. Adicione um campo `kendraQueryFilterString` que contém parâmetros de consulta do Amazon Kendra à ação de diálogo `delegate`. Quando parâmetros de consulta são adicionados à solicitação com a função do Lambda, eles têm precedência sobre o filtro de consulta definido quando a intenção foi criada.
+ Crie uma consulta usando a função do Lambda do diálogo. É possível criar uma solicitação de consulta completa do Amazon Kendra enviada pelo Amazon Lex. Especifique a consulta no campo `kendraQueryRequestPayload` na ação de diálogo `delegate`. O campo `kendraQueryRequestPayload` tem precedência sobre o campo `kendraQueryFilterString`.
Para especificar o parâmetro `queryFilterString` ao criar um bot ou especificar o campo `kendraQueryFilterString` ao chamar a ação `delegate` em uma função do Lambda do diálogo, especifique uma string usada como filtro de atributo para a consulta do Amazon Kendra. Se a string não for um filtro de atributo válido, você receberá uma exceção `InvalidBotConfigException` em runtime. Para obter mais informações sobre filtros de atributo, consulte [Usar atributos de documento para filtrar consultas](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-filtering) no *Guia do desenvolvedor do Amazon Kendra*.
Para ter controle sobre a consulta enviada pelo Amazon Lex para o Amazon Kendra, é possível especificar uma consulta no campo `kendraQueryRequestPayload` na função do Lambda do diálogo. Se a consulta não for válida, o Amazon Lex retornará uma exceção `InvalidLambdaResponseException`. Para obter mais informações, consulte a [Operação de consulta](https://docs.aws.amazon.com/kendra/latest/dg/API_Query.html) no *Guia do desenvolvedor do Amazon Kendra*.
Para obter um exemplo de como usar a `AMAZON.KendraSearchIntent`, consulte [Exemplo: criar um bot de perguntas frequentes para um índice do Amazon Kendra](faq-bot-kendra-search.md).
## Política do IAM para pesquisa Amazon Kendra
Para usar a `AMAZON.KendraSearchIntent` intenção, você deve usar uma função que forneça políticas AWS Identity and Access Management (IAM) que permitam ao Amazon Lex assumir uma função de tempo de execução que tenha permissão para chamar a intenção do Amazon Kendra`Query`. As configurações do IAM que você usa dependem de você criar o `AMAZON.KendraSearchIntent` usando o console Amazon Lex ou usando um SDK da AWS ou o AWS Command Line Interface (AWS CLI). Quando o console é usado, é possível escolher entre adicionar permissão para chamar o Amazon Kendra para a função vinculada ao serviço do Amazon Lex ou usar uma função especificamente para chamar a operação `Query` do Amazon Kendra. Ao usar o AWS CLI ou um SDK para criar a intenção, você deve usar uma função específica para chamar a `Query` operação.
### Anexar permissões
É possível usar o console para anexar permissões para acessar a operação `Query` do Amazon Kendra à função vinculada ao serviço padrão do Amazon Lex. Quando você anexa permissões à função vinculada ao serviço, não precisa criar e gerenciar uma função de runtime especificamente para se conectar ao índice do Amazon Kendra.
O usuário, a função ou o grupo usado para acessar o console do Amazon Lex deve ter permissões para gerenciar políticas de função. Anexe a política do IAM à função de acesso do console. Quando essas permissões são concedidas, a função tem permissões para alterar a política de função vinculada ao serviço existente.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iam:AttachRolePolicy",
"iam:PutRolePolicy",
"iam:GetRolePolicy"
],
"Resource": "arn:aws:iam::*:role/aws-service-role/lex.amazonaws.com/AWSServiceRoleForLexBots"
},
{
"Effect": "Allow",
"Action": "iam:ListRoles",
"Resource": "*"
}
]
}
```
------
### Especificar uma função
Você pode usar o console AWS CLI, o ou a API para especificar uma função de tempo de execução a ser usada ao chamar a operação Amazon `Query` Kendra.
O usuário, a função ou o grupo utilizado para especificar a função de runtime deve ter a permissão `iam:PassRole`. A política a seguir define a permissão. É possível usar as chaves de contexto de condição `iam:AssociatedResourceArn` e `iam:PassedToService` para limitar ainda mais o escopo das permissões. Para obter mais informações, consulte [IAM e AWS STS Condition Context Keys](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_iam-condition-keys.html) no *Guia AWS Identity and Access Management do usuário*.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "iam:PassRole",
"Resource": "arn:aws:iam::111122223333:role/role"
}
]
}
```
------
A função de runtime que o Amazon Lex precisa usar para chamar o Amazon Kendra deve ter as permissões `kendra:Query`. Quando você usa um perfil do IAM existente para obter permissão para chamar a operação `Query` do Amazon Kendra, a função deve ter a política a seguir anexada.
É possível usar o console do IAM, a API do IAM ou a AWS CLI para criar uma política e anexá-la a uma função. Essas instruções usam a CLI da AWS para criar a função e as políticas.
**nota**
O código a seguir é formatado para Linux e MacOS. Para Windows, substitua o caractere de continuação de linha do Linux (\$1) pelo circunflexo (^).
**Como adicionar permissão de operação de consulta a uma função**
1. Crie um documento chamado **KendraQueryPolicy.json** no diretório atual, adicione a ele o código a seguir e salve-o.
1. No AWS CLI, execute o comando a seguir para criar a política do IAM para executar a operação Amazon `Query` Kendra.
```
aws iam create-policy \
--policy-name query-policy-name \
--policy-document file://KendraQueryPolicy.json
```
1. Anexe a política ao perfil do IAM utilizado para chamar a operação `Query`.
```
aws iam attach-role-policy \
--policy-arn arn:aws:iam::account-id:policy/query-policy-name
--role-name role-name
```
É possível optar por atualizar a função vinculada ao serviço do Amazon Lex ou usar uma função que você criou ao criar o `AMAZON.KendraSearchIntent` para o bot. O procedimento a seguir mostra como escolher o perfil do IAM a ser usado.
**Para especificar a função de tempo de execução da AMAZON. KendraSearchIntent**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon Lex em [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).
1. Escolha o bot ao qual você deseja adicionar a `AMAZON.KendraSearchIntent`.
1. Escolha o sinal de adição (\$1) ao lado de **Intenções**.
1. Em **Adicionar intenção**, escolha **Pesquisar intenções existentes**.
1. Em **Intenções de pesquisa**, insira **AMAZON.KendraSearchIntent** e escolha **Adicionar**.
1. Em **Copiar intenção interna**, insira um nome para a intenção, como **KendraSearchIntent**, e escolha **Adicionar**.
1. Abra a seção **Consulta do Amazon Kendra**.
1. Para **Perfil do IAM**, escolha uma das seguintes opções:
+ Para atualizar a função vinculada ao serviço do Amazon Lex para permitir que o bot consulte índices do Amazon Kendra, escolha **Adicionar permissões do Amazon Kendra**.
+ Para usar uma função que tenha permissão para chamar a operação `Query` do Amazon Kendra, escolha **Usar uma função existente**.
## Usar atributos de solicitação e sessão como filtros
Para filtrar a resposta do Amazon Kendra a itens relacionados à conversa atual, use atributos de sessão e solicitação como filtros adicionando o parâmetro `queryFilterString` ao criar o bot. Especifique um espaço reservado para o atributo ao criar a intenção e, depois, o Amazon Lex V2 substituirá um valor antes de chamar o Amazon Kendra. Para mais informações sobre atributos de solicitação, consulte [Definição de atributos de solicitação](context-mgmt-request-attribs.md). Para mais informações sobre atributos de sessão, consulte [Definição dos atributos da sessão](context-mgmt-session-attribs.md).
Veja a seguir um exemplo de parâmetro `queryFilterString` que usa uma string para filtrar a consulta do Amazon Kendra.
```
"{"equalsTo": {"key": "City", "value": {"stringValue": "Seattle"}}}"
```
Veja a seguir um exemplo de um parâmetro `queryFilterString` que usa um atributo de sessão chamado `"SourceURI"` para filtrar a consulta do Amazon Kendra.
```
"{"equalsTo": {"key": "SourceURI","value": {"stringValue": "[FileURL]"}}}"
```
Veja a seguir um exemplo de parâmetro `queryFilterString` que usa um atributo de solicitação chamado `"DepartmentName"` para filtrar a consulta do Amazon Kendra.
```
"{"equalsTo": {"key": "Department","value": {"stringValue": "((DepartmentName))"}}}"
```
Os filtros `AMAZON.KendraSearchInteng` usam o mesmo formato dos filtros de pesquisa do Amazon Kendra. Para obter mais informações, consulte [Usar atributos de documento para filtrar os resultados da pesquisa](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-filtering) no *Guia do desenvolvedor do Amazon Kendra*.
A string do filtro de consulta usada com o `AMAZON.KendraSearchIntent` deve usar letras minúsculas para a primeira letra de cada filtro. Por exemplo, veja a seguir um filtro de consulta válido para o `AMAZON.KendraSearchIntent`.
```
{
"andAllFilters": [
{
"equalsTo": {
"key": "City",
"value": {
"stringValue": "Seattle"
}
}
},
{
"equalsTo": {
"key": "State",
"value": {
"stringValue": "Washington"
}
}
}
]
}
```
## Usar a resposta da pesquisa
O Amazon Kendra retorna a resposta a uma pesquisa na instrução `conclusion` da intenção. A intenção deve ter uma instrução `conclusion`, a menos que uma função do Lambda de atendimento produza uma mensagem de conclusão.
O Amazon Kendra tem quatro tipos de respostas.
+ `x-amz-lex:kendra-search-response-question_answer-question-`: a pergunta de uma pergunta frequente correspondente à pesquisa.
+ `x-amz-lex:kendra-search-response-question_answer-answer-`: a resposta de uma pergunta frequente correspondente à pesquisa.
+ `x-amz-lex:kendra-search-response-document-`: um trecho de um documento no índice relacionado ao texto da declaração.
+ `x-amz-lex:kendra-search-response-document-link-`: o URL de um documento no índice relacionado ao texto da declaração.
+ `x-amz-lex:kendra-search-response-answer-`: um trecho de um documento no índice que responde à pergunta.
As respostas são retornadas em atributos `request`. Pode haver até cinco respostas para cada atributo, numeradas de 1 a 5. Para obter mais informações sobre respostas, consulte [Tipos de resposta](https://docs.aws.amazon.com/kendra/latest/dg/response-types.html) no *Guia do desenvolvedor do Amazon Kendra*.
A instrução `conclusion` deve ter um ou mais grupos de mensagens. Cada grupo de mensagens contém uma ou mais mensagens. Cada mensagem pode conter uma ou mais variáveis de espaço reservado que são substituídas por atributos de solicitação na resposta do Amazon Kendra. Deve haver pelo menos uma mensagem no grupo de mensagens em que todas as variáveis na mensagem são substituídas por valores de atributo de solicitação na resposta de runtime, ou deve haver uma mensagem no grupo sem variáveis de espaço reservado. Os atributos de solicitação são ativados com parênteses duplos ("((" "))"). As mensagens do grupo de mensagens a seguir correspondem a qualquer resposta do Amazon Kendra:
+ “Encontrei uma pergunta de FAQ para você: ((x-amz-lex: kendra-search-response-question \$1resposta-pergunta-1)), e a resposta é ((x-amz-lex: \$1resposta-resposta-1))” kendra-search-response-question
+ “Encontrei um trecho de um documento útil: ((x-amz-lex: kendra-search-response-document -1))”
+ “Acho que a resposta às suas perguntas é ((x-amz-lex: kendra-search-response-answer -1))”
## Usar uma função do Lambda para gerenciar a solicitação e a resposta
A intenção `AMAZON.KendraSearchIntent` pode usar o hook de código de diálogo e o hook de código de atendimento para gerenciar a solicitação ao Amazon Kendra e a resposta. Utilize a função do Lambda do hook de código de diálogo quando quiser modificar a consulta enviada ao Amazon Kendra e a função do Lambda de hook de código de atendimento quando quiser modificar a resposta.
### Criar uma consulta com o hook de código de diálogo
É possível usar o hook de código de diálogo para criar uma consulta para enviar ao Amazon Kendra. O uso do hook de código de diálogo é opcional. Se você não especificar um hook de código de diálogo, o Amazon Lex criará uma consulta a partir da declaração do usuário e usará a `queryFilterString` fornecida quando você configurou a intenção, se você a tiver fornecido.
É possível usar dois campos na resposta do hook de código de diálogo para modificar a solicitação ao Amazon Kendra:
+ `kendraQueryFilterString`: use essa string para especificar filtros de atributo para a solicitação do Amazon Kendra. É possível filtrar a consulta usando qualquer um dos campos de índice definidos no índice. Para obter a estrutura da string de filtro, consulte [Usar atributos de documento para filtrar consultas](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-filtering) no *Guia do desenvolvedor do Amazon Kendra*. Se a string de filtro especificada não for válida, você receberá uma exceção `InvalidLambdaResponseException`. A string `kendraQueryFilterString` substitui qualquer string de consulta especificada na `queryFilterString` configurada para a intenção.
+ `kendraQueryRequestPayload`: use essa string para especificar uma consulta do Amazon Kendra. Sua consulta pode usar qualquer um dos atributos do Amazon Kendra. Se você não especificar uma consulta válida, receberá uma exceção `InvalidLambdaResponseException`. Para obter mais informações, configura [Consulta](https://docs.aws.amazon.com/kendra/latest/dg/API_Query.html) no *Guia do desenvolvedor do Amazon Kendra*.
Depois de criar o filtro ou a sequência de caracteres de consulta, você envia a resposta para o Amazon Lex com o `dialogAction` campo da resposta definido como`delegate`. O Amazon Lex envia a consulta para a Amazon Kendra e, em seguida, retorna a resposta da consulta ao hook do código de atendimento.
### Usar o hook de código de atendimento para a resposta
Depois que o Amazon Lex envia uma consulta ao Amazon Kendra, a resposta da consulta é retornada para a função do Lambda de cumprimento `AMAZON.KendraSearchIntent`. O evento de entrada para o hook de código contém a resposta completa do Amazon Kendra. Os dados da consulta estão na mesma estrutura que os retornados pela operação `Query` do Amazon Kendra. Para obter mais informações, consulte [Sintaxe de resposta de consulta](https://docs.aws.amazon.com/kendra/latest/dg/API_Query.html#API_Query_ResponseSyntax) no *Guia do desenvolvedor do Amazon Kendra*.
O hook de código de atendimento é opcional. Se não houver nenhum ou se o hook de código não retornar uma mensagem na resposta, o Amazon Lex usará a instrução `conclusion` para respostas.
# Exemplo: criar um bot de perguntas frequentes para um índice do Amazon Kendra
Este exemplo cria um bot do Amazon Lex que usa um índice do Amazon Kendra para fornecer respostas às perguntas dos usuários. O bot de perguntas frequentes gerencia a caixa de diálogo para o usuário. Ele usa a intenção `AMAZON.KendraSearchIntent` para consultar o índice e apresentar a resposta ao usuário. Para criar o bot, você deve:
1. Criar um bot com o qual seus clientes vão interagir para obter respostas do bot.
1. Criar uma intenção personalizada. O bot requer pelo menos uma intenção com pelo menos uma declaração. Essa intenção permite que o bot crie, mas não seja usado de outra forma.
1. Adicionar a intenção `KendraSearchIntent` ao bot e configurá-lo para trabalhar com o índice do Amazon Kendra.
1. Testar o bot fazendo perguntas que são respondidas por documentos armazenados no índice do Amazon Kendra.
Antes de usar este exemplo, é necessário criar um índice do Amazon Kendra. Para obter mais informações, consulte [Começar a usar um bucket do S3 (console)](https://docs.aws.amazon.com/kendra/latest/dg/gs-console.html) no *Guia do desenvolvedor do Amazon Kendra*.
**Como criar um bot de perguntas frequentes**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon Lex em [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).
1. No painel de navegação, escolha **Bots**.
1. Escolha **Criar**.
1. Selecione **Custom bot (Bot personalizado)**. Configure o bot da seguinte forma:
+ **Nome do bot**: dê ao bot um nome que indique sua finalidade, como **KendraTestBot**.
+ **Voz de saída**: escolha **Nenhuma**.
+ **Tempo limite da sessão**: insira **5**.
+ **Análise de sentimento**: escolha **Não**.
+ **COPPA**: escolha **Não**.
+ **Armazenamento da declaração do usuário**: escolha **Não armazenar**.
1. Escolha **Criar**.
Para criar um bot com êxito, é necessário criar pelo menos uma intenção com pelo menos uma amostra de declaração. Essa intenção é necessária para criar o bot do Amazon Lex, mas não é usada para a resposta de perguntas frequentes. A declaração para a intenção não deve se aplicar a nenhuma das perguntas feitas pelo cliente.
**Como criar a intenção necessária**
1. Na página **Começar a usar o bot**, escolha **Criar intenção**.
1. Em **Adicionar intenção**, escolha **Criar intenção**.
1. Na caixa de diálogo **Criar intenção**, dê um nome à intenção, como **RequiredIntent**.
1. Em **Amostra de declarações**, digite uma declaração, como **Required utterance**.
1. Selecione **Salvar intenção**.
Agora, crie a intenção de pesquisar um índice do Amazon Kendra e as mensagens de resposta que devem ser retornadas.
**Para criar uma AMAZON. KendraSearchIntent mensagem de intenção e resposta**
1. No painel de navegação, escolha o sinal de adição (\$1) ao lado de **Intenções**.
1. Em **Adicionar intenção**, escolha **Pesquisar intenções existentes**.
1. Na caixa **Pesquisar intenções**, insira **AMAZON.KendraSearchIntent** e escolha-a na lista.
1. Em **Copiar intenção interna**, dê um nome à intenção, como **KendraSearchIntent**, e escolha **Adicionar**.
1. No editor de intenções, escolha **Consulta do Amazon Kendra** para abrir as opções de consulta.
1. No menu **Índice do Amazon Kendra**, escolha o índice que a intenção deve pesquisar.
1. Na seção **Resposta**, adicione as três seguintes mensagens:
```
I found a FAQ question for you: ((x-amz-lex:kendra-search-response-question_answer-question-1)) and the answer is ((x-amz-lex:kendra-search-response-question_answer-answer-1)).
I found an excerpt from a helpful document: ((x-amz-lex:kendra-search-response-document-1)).
I think the answer to your questions is ((x-amz-lex:kendra-search-response-answer-1)).
```
1. Escolha **Salvar intenção** e selecione **Criar** para criar o bot.
Por fim, use a janela de teste do console para testar as respostas do bot. Suas perguntas devem estar no domínio compatível com o índice.
**Como testar o bot de perguntas frequentes**
1. Na janela de teste do console, digite uma pergunta para o índice.
1. Verifique a resposta na seção de resposta da janela de teste.
1. Para redefinir a janela de teste para outra pergunta, escolha **Limpar histórico de conversas**.
# AMAZON.PauseIntent
Responde a palavras e frases que permitem ao usuário pausar uma interação com um bot para que ele possa retornar a ela mais tarde. Seu aplicativo ou função do Lambda precisa salvar dados de intenção em variáveis de sessão, ou você precisa usar a operação [GetSession](API_runtime_GetSession.md) para recuperar dados de intenção ao retomar a intenção atual.
Declarações comuns:
+ pausar
+ pausar esse item
# AMAZON.RepeatIntent
Responde a palavras e frases que permitem ao usuário repetir a mensagem anterior. Seu aplicativo precisa usar uma função do Lambda para salvar as informações da intenção anterior nas variáveis da sessão, ou você precisa usar a [GetSession](API_runtime_GetSession.md) operação para obter as informações da intenção anterior.
Declarações comuns:
+ repetir
+ dizer isso de novo
+ repetir isso
# AMAZON.ResumeIntent
Responde a palavras e frases que permitem ao usuário retomar uma intenção anteriormente pausada. Seu aplicativo ou função do Lambda deve gerenciar as informações necessárias para retomar a intenção anterior.
Declarações comuns:
+ retomar
+ continuar
+ prosseguir
# AMAZON.StartOverIntent
Responde a palavras e frases que permitem ao usuário parar de processar a intenção atual e recomeçar do início. Você pode usar sua função do Lambda ou a operação `PutSession` para obter novamente o valor do primeiro slot.
Declarações comuns:
+ começar de novo
+ reiniciar
+ começar novamente
# AMAZON.StopIntent
Responde a palavras e frases que indicam que o usuário deseja parar de processar a intenção atual e encerrar a interação com um bot. Seu aplicativo ou função do Lambda deve limpar todos os atributos e valores do tipo de slot existentes e, em seguida, encerrar a interação.
Declarações comuns:
+ parar
+ desligar
+ cale-se
# Tipos de slot integrados
O Amazon Lex oferece suporte a tipos de slots integrados que definem como os dados no slot são reconhecidos e tratados. É possível criar slots desses tipos em suas intenções. Isso elimina a necessidade de criar valores de enumeração para dados de slot comumente usados, como data, hora e local. Os tipos de slot integrados não têm versões.
| Tipo de slot | Descrição breve | Localidades compatíveis |
| --- | --- | --- |
| [AMAZON.Airport](built-in-slot-airport.md) | Reconhece palavras que representam um aeroporto. | Todas as localidades |
| [AMAZÔNIA. AlphaNumeric](built-in-slot-alphanumeric.md) | Reconhece palavras compostas de letras e números. | Todas as localidades, exceto coreano (ko-KR) |
| [AMAZON.City](built-in-slot-city.md) | Reconhece palavras que representam uma cidade. | Todas as localidades |
| [AMAZON.Country](built-in-slot-country.md) | Reconhece palavras que representam um país. | Todas as localidades |
| [AMAZON.DATE](built-in-slot-date.md) | Reconhece palavras que representam uma data e as converte em um formato padrão. | Todas as localidades |
| [AMAZON.DURATION](built-in-slot-duration.md) | Reconhece palavras que representam duração e as converte em um formato padrão. | Todas as localidades |
| [AMAZÔNIA. EmailAddress](built-in-slot-email.md) | Converte palavras que representam um endereço de e-mail em um endereço de e-mail padrão. | Todas as localidades |
| [AMAZÔNIA. FirstName](built-in-slot-first-name.md) | Reconhece palavras que representam um nome. | Todas as localidades |
| [AMAZÔNIA. LastName](built-in-slot-last-name.md) | Reconhece palavras que representam um sobrenome. | Todas as localidades |
| [AMAZON.NUMBER](built-in-slot-number.md) | Reconhece palavras numéricas e as converte em dígitos. | Todas as localidades |
| [AMAZON.Percentage](built-in-slot-percent.md) | Converte palavras que representam uma porcentagem em um número e um sinal de porcentagem (%). | Todas as localidades |
| [AMAZÔNIA. PhoneNumber](built-in-slot-phone.md) | Converte palavras que representam um número de telefone em uma string numérica. | Todas as localidades |
| [AMAZÔNIA. SpeedUnit](built-in-slot-speed.md) | Converte palavras que representam uma unidade de velocidade em uma abreviatura padrão. | Inglês (EUA) (en-US) |
| [AMAZON.State](built-in-slot-state.md) | Reconhece palavras que representam um estado. | Todas as localidades |
| [AMAZÔNIA. StreetName](built-in-slot-street-name.md) | Reconhece palavras que representam o nome de uma rua. | Todas as localidades, exceto inglês (EUA) (en-US) |
| [AMAZON.TIME](built-in-slot-time.md) | Converte palavras que indicam horários em um formato de hora. | Todas as localidades |
| [AMAZÔNIA. WeightUnit](built-in-slot-weight.md) | Converte palavras que representam uma unidade de peso em uma abreviatura padrão | Inglês (EUA) (en-US) |
**nota**
Para a localidade em inglês (EUA) (en-US), o Amazon Lex oferece suporte aos tipos de slots do Alexa Skill Kit. Para obter uma lista de tipos de slot integrados disponíveis, consulte [Referência do tipo de slot](https://developer.amazon.com/docs/custom-skills/slot-type-reference.html) na documentação do Alexa Skills Kit.
O Amazon Lex não oferece suporte ao tipo de slot integrado `AMAZON.LITERAL` ou ao `AMAZON.SearchQuery`.
# AMAZON.Airport
Fornece uma lista de aeroportos. Os exemplos incluem:
+ Aeroporto Internacional John F. Kennedy
+ Aeroporto de Melbourne
# AMAZÔNIA. AlphaNumeric
Reconhece strings compostas de letras e números, como **APQ123**.
Esse tipo de slot não está disponível na localidade coreana (ko-KR).
Você pode usar o tipo de slot `AMAZON.AlphaNumeric` para strings que contenham:
+ Caracteres alfabéticos, como **ABC**
+ Caracteres numéricos, como **123**
+ Uma combinação de caracteres alfanuméricos, como **ABC123**
Você pode adicionar uma expressão regular ao tipo de slot `AMAZON.AlphaNumeric` para validar os valores inseridos para o slot. Por exemplo, é possível usar uma expressão regular para validar:
+ Códigos postais do Reino Unido ou do Canadá
+ Números de carteira de motorista
+ Números de identificação de veículo
Use uma expressão regular padrão. O Amazon Lex suporta os seguintes caracteres na expressão regular:
+ A-Z, a-z
+ 0-9
O Amazon Lex também oferece suporte a caracteres Unicode em expressões regulares. O formato é `\uUnicode`. Use quatro dígitos para representar caracteres Unicode. Por exemplo, `[\u0041-\u005A]` é equivale a [A-Z].
Os seguintes operadores de expressão regular não são aceitos:
+ Repetidores infinitos: \$1, \$1 ou \$1x,\$1 sem limite superior.
+ Curinga (.)
O comprimento máximo da expressão regular é de 300 caracteres. O comprimento máximo de uma string armazenada em uma AMAZON. AlphaNumeric o tipo de slot que usa uma expressão regular é de 30 caracteres.
A seguir estão alguns exemplos de expressões regulares.
+ Strings alfanuméricas, como **APQ123** ou **APQ1**: `[A-Z]{3}[0-9]{1,3}` ou um `[A-DP-T]{3} [1-5]{1,3}` mais restrito
+ Formato internacional de correio prioritário do Serviço Postal dos EUA, como **CP123456789US**: `CP[0-9]{9}US`
+ Números de roteamento bancário, como **123456789**: `[0-9]{9}`
Para definir a expressão regular para um tipo de slot, use o console ou a operação [PutSlotType](API_PutSlotType.md). A expressão regular é validada quando você salva o tipo de slot. Se a expressão não for válida, o Amazon Lex retornará uma mensagem de erro.
Quando você usa uma expressão regular em um tipo de slot, o Amazon Lex verifica a entrada em slots desse tipo em relação à expressão regular. Se a entrada corresponder à expressão, o valor será aceito para o slot. Se a entrada não corresponder, o Amazon Lex solicitará que o usuário repita a entrada.
# AMAZON.City
Fornece uma lista de cidades locais e mundiais. O tipo de slot reconhece variações comuns de nomes de cidades. O Amazon Lex não faz a conversão de uma variação para um nome oficial.
Exemplos:
+ Nova York
+ Reykjavik
+ Tóquio
+ Versalhes
# AMAZON.Country
Os nomes dos países de todo o mundo. Exemplos:
+ Austrália
+ Alemanha
+ Japão
+ Estados Unidos
+ Uruguai
# AMAZON.DATE
Converte palavras que representam datas em um formato de data.
A data é fornecida de acordo com sua intenção no formato de data ISO-8601. A data em que sua intenção é recebida no slot pode variar dependendo da frase específica proferida pelo usuário.
+ Declaraçoes mapeadas para uma data específica, como "hoje", "agora" ou "vinte e cinco de novembro", são convertidas em uma data completa: `2020-11-25`. O padrão é datas iguais *ou posteriores à* data atual.
+ Declarações mapeadas para uma semana específica, como "esta semana" ou "semana que vem", são convertidas na data do primeiro dia da semana. No formato ISO-8601, a semana começa na segunda-feira e termina no domingo. Por exemplo, se hoje for 25/11/2020, a "próxima semana" será convertida em `2020-11-30`.
+ Declarações mapeadas para um mês, mas não para um dia específico, como "próximo mês", são convertidas no último dia do mês. Por exemplo, se hoje for 25/11/2020, o "próximo mês" será convertido em `2020-12-31`.
+ Declarações mapeadas para um ano, mas não para um mês ou dia específico, como "ano que vem", são convertidas no último dia do ano seguinte. Por exemplo, se hoje for 25/11/2020, o "próximo ano" será convertido em `2021-12-31`.
# AMAZON.DURATION
Converte palavras que indicam durações em uma duração numérica.
A duração é resolvida em um formato baseado no formato de duração [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Durations), `PnYnMnWnDTnHnMnS`. O `P` indica que essa é uma duração, `n` é um valor numérico e a letra maiúscula após `n` é o elemento específico de data ou hora. Por exemplo, `P3D` significa 3 dias. O `T` é usado para indicar que os valores restantes representam elementos de tempo em vez de elementos de data.
Exemplos:
+ "dez minutos": `PT10M`
+ "cinco horas": `PT5H`
+ "três dias": `P3D`
+ "quarenta e cinco segundos": `PT45S`
+ "oito semanas": `P8W`
+ "sete anos": `P7Y`
+ "cinco horas e dez minutos": `PT5H10M`
+ "dois anos três horas dez minutos": `P2YT3H10M`
# AMAZÔNIA. EmailAddress
Reconhece palavras que representam um endereço de e-mail fornecido, como nomedeusuário@domínio. Os endereços podem incluir os seguintes caracteres especiais em um nome de usuário: sublinhado (\$1), hífen (-), ponto (.) e o sinal de mais (\$1).
# AMAZÔNIA. FirstName
Nomes próprios comumente usados. Esse tipo de slot reconhece tanto nomes formais quanto apelidos informais. O nome enviado para sua intenção é o valor enviado pelo usuário. O Amazon Lex não converte do apelido para o nome formal.
Para nomes que soam parecidos, mas com grafia diferente, o Amazon Lex envia sua intenção em um único formulário comum.
Na localidade em inglês (EUA) (en-US), use o nome do slot Amazon.US\$1FIRST\$1NAME.
Exemplos:
+ Emily
+ John
+ Sophie
# AMAZÔNIA. LastName
Sobrenomes comumente usados. Para nomes com sons parecidos e escritos de forma diferente, o Amazon Lex envia sua intenção em um único formulário comum.
Na localidade em inglês (EUA) (en-US), use o nome do slot Amazon.US\$1last\$1name.
Exemplos:
+ Brosky
+ Dasher
+ Evers
+ Parres
+ Welt
# AMAZON.NUMBER
Converte palavras ou números que expressam um número em dígitos, incluindo números decimais. A tabela a seguir mostra como o tipo de slot `AMAZON.NUMBER` captura palavras numéricas.
| Input | Resposta |
| --- | --- |
| cento e vinte e três ponto quatro cinco | 123.45 |
| cento e vinte e três ponto quatro cinco | 123.45 |
| ponto quatro dois | 0.42 |
| ponto quarenta e dois | 0.42 |
| 232.998 | 232.998 |
| 50 | 50 |
# AMAZON.Percentage
Converte palavras e símbolos que representam uma porcentagem em um valor numérico com um sinal de porcentagem (%).
Se o usuário inserir um número sem um sinal de porcentagem ou as palavras "por cento", o valor do slot será definido para o número. A tabela a seguir mostra como o tipo de slot `AMAZON.Percentage` captura porcentagens.
| Input | Resposta |
| --- | --- |
| 50% | 50% |
| 0,4% | 0.4% |
| 23,5% | 23,5% |
| vinte e cinco por cento | 25% |
# AMAZÔNIA. PhoneNumber
Converte os números ou as palavras que representam um número de telefone em um formato de string sem a pontuação da seguinte forma.
| Tipo | Description | Input | Resultado |
| --- | --- | --- | --- |
| Número internacional com sinal de mais (\$1) no começo | Número de 11 dígitos com sinal de mais no começo. | \$161 7 4445 1061 1 (509) 555-1212 | `+61744431061` `+15095551212` |
| Número internacional sem sinal de mais (\$1) no começo | Número de 11 dígitos sem sinal de mais no começo | 1 (509) 555-1212 61 7 4445 1061 | `15095551212` `61744451061` |
| Número nacional | Número de 10 dígitos sem código internacional | (03) 5115 4444 (509) 555-1212 | `0351154444` `5095551212` |
| Número local | Número de 7 dígitos sem código internacional ou código de área | 555-1212 | 5551212 |
# AMAZÔNIA. SpeedUnit
Converte palavras que representam unidades de velocidade na abreviatura correspondente. Por exemplo, "milhas por hora" é convertido em `mph`.
Esse tipo de slot está disponível somente na localidade em inglês (EUA) (en-US).
Os exemplos a seguir mostram como o tipo de slot `AMAZON.SpeedUnit` captura unidades de velocidade.
| Unidade de velocidade | Abreviação |
| --- | --- |
| milhas por hora, mph, MPH, m/h | mph |
| quilômetros por hora, km por hora, kmph, KMPH, km/h | kmph |
| metros por segundo, mps, MPS, m/s | mps |
| milhas náuticas por hora, nós, nó | nó |
# AMAZON.State
Os nomes das regiões geográficas e políticas dos países.
Exemplos:
+ Baviera
+ Prefeitura de Fukushima
+ Noroeste do Pacífico
+ Queensland
+ Gales
# AMAZÔNIA. StreetName
Os nomes das ruas dentro de um endereço típico. Isso inclui apenas o nome da rua, não o número da casa.
Esse tipo de slot não está disponível na localidade em inglês (EUA) (en-US).
Exemplos:
+ Avenida Canberra
+ Rua da frente
+ Estrada do Mercado
# AMAZON.TIME
Converte palavras que representam horários em valores de hora. Inclui resoluções para tempos ambíguos. Quando o usuário insere um horário ambíguo, o Amazon Lex usa o atributo `slotDetails` de um evento do Lambda para passar resoluções para horários ambíguos à função do Lambda. Por exemplo, se seu bot solicitar um horário de entrega, o usuário poderá responder: "10 horas". Esse horário é ambíguo. Pode ser 10h ou 22h. Nesse caso, o valor no mapa `slots` é `null`, e a entidade `slotDetails` contém as duas possíveis resoluções de horário. O Amazon Lex insere o seguinte na função do Lambda.
```
"slots": {
"deliveryTime": null
},
"slotDetails": {
"deliveryTime": {
"resolutions": [
{
"value": "10:00"
},
{
"value": "22:00"
}
]
}
}
```
Quando o usuário responde com um horário não ambíguo, o Amazon Lex envia o horário para a função do Lambda no atributo `slots` do evento do Lambda, e o atributo `slotDetails` fica vazio. Por exemplo, se o usuário responder ao prompt para um horário de entrega com "10:00 PM (22h)", o Amazon Lex inserirá o seguinte na função do Lambda:
```
"slots": {
"deliveryTime": "22:00"
}
```
Para obter mais informações sobre os dados enviados do Amazon Lex para uma função do Lambda, consulte [Formato de eventos de entrada](lambda-input-response-format.md#using-lambda-input-event-format).
# AMAZÔNIA. WeightUnit
Converte palavras que representam uma unidade de peso na abreviatura correspondente. Por exemplo, "quilograma" é convertido para `kg`.
Esse tipo de slot está disponível somente na localidade em inglês (EUA) (en-US).
Os exemplos a seguir mostram como o tipo de slot `AMAZON.WeightUnit` captura unidades de peso:
| Unidade de peso | Abreviação |
| --- | --- |
| quilogramas, quilos, kg, KG | kg |
| gramas, g, g, G, g | g |
| miligramas, mg, mg | mg |
| libras, lb, LB | lb |
| onças, oz, OZ | oz |
| tonelada, tonelada, t | t |
| quilotonelada, kt | kt |