Conceitos e definições de Comandos Personalizados
Importante
Os Comandos Personalizados serão desativados em 30 de abril de 2026. A partir de 30 de outubro de 2023, você não poderá criar novos aplicativos de Comandos Personalizados no Speech Studio. Relacionado com esta mudança, o LUIS será aposentado a 1 de outubro de 2025. A partir de 1 de abril de 2023 não é possível criar novos recursos LUIS.
Este artigo serve como referência para conceitos e definições para aplicativos de Comandos Personalizados.
Configuração de comandos
Os comandos são os blocos de construção básicos de um aplicativo de Comandos Personalizados. Um comando é um conjunto de configurações necessárias para concluir uma tarefa específica definida por um usuário.
Frases de exemplo
Exemplos de enunciados são os exemplos definidos que o usuário pode dizer para acionar um determinado comando. Você precisa fornecer apenas uma amostra de enunciados e não uma lista exaustiva.
Parâmetros
Os parâmetros são informações exigidas pelos comandos para concluir uma tarefa. Em cenários complexos, os parâmetros também podem ser usados para definir condições que acionam ações personalizadas.
Regras de conclusão
As regras de conclusão são uma série de regras a serem executadas depois que o comando estiver pronto para ser cumprido, por exemplo, quando todas as condições das regras forem satisfeitas.
Regras de interação
As regras de interação são regras extras para lidar com situações mais específicas ou complexas. Você pode adicionar mais validações ou configurar recursos avançados, como confirmações ou uma correção de uma etapa. Você também pode criar suas próprias regras de interação personalizadas.
Configuração de parâmetros
Os parâmetros são informações exigidas pelos comandos para concluir uma tarefa. Em cenários complexos, os parâmetros também podem ser usados para definir condições que acionam ações personalizadas.
Nome
Um parâmetro é identificado pela propriedade name. Você sempre deve dar um nome descritivo a um parâmetro. Um parâmetro pode ser referido em diferentes seções, por exemplo, quando você constrói condições, respostas de fala ou outras ações.
Necessário
Essa caixa de seleção indica se um valor para esse parâmetro é necessário para o cumprimento ou conclusão do comando. Você deve configurar respostas para solicitar que o usuário forneça um valor se um parâmetro for marcado como necessário.
Se você configurou um parâmetro necessário para ter um valor Default, o sistema ainda solicitará o valor do parâmetro.
Type
Comandos personalizados suporta os seguintes tipos de parâmetros:
- Antiguidade
- Moeda
- DateTime
- Dimensão
- Geografia
- Número
- Ordinal
- Percentagem
- Nome da Pessoa
- PhoneNumber
- String
- Temperatura
- Url
Cada localidade suporta o tipo de parâmetro "String", mas a disponibilidade de todos os outros tipos difere de acordo com a localidade. Os Comandos Personalizados usam a resolução de entidade pré-criada do LUIS, portanto, a disponibilidade de um tipo de parâmetro em uma localidade depende do suporte de entidade pré-criada do LUIS nessa localidade. Você pode encontrar mais detalhes sobre o suporte de entidade pré-construída do LUIS por localidade. Atualmente, não há suporte para entidades LUIS personalizadas (como entidades aprendidas por máquina).
Alguns tipos de parâmetros como Number, String e DateTime suportam a configuração de valor padrão, que você pode configurar a partir do portal.
Configuração
Configuration é uma propriedade de parâmetro definida apenas para o tipo String. Os seguintes valores são suportados:
- Nenhum.
- Aceitar entrada completa: Quando ativado, um parâmetro aceita qualquer enunciado de entrada. Esta opção é útil quando o usuário precisa de um parâmetro com o enunciado completo. Um exemplo são os endereços postais.
- Aceitar valores de entrada predefinidos de um catálogo externo: esse valor é usado para configurar um parâmetro que pode assumir uma ampla variedade de valores. Um exemplo é um catálogo de vendas. Nesse caso, o catálogo é hospedado em um ponto de extremidade da Web externo e pode ser configurado independentemente.
- Aceitar valores de entrada predefinidos do catálogo interno: esse valor é usado para configurar um parâmetro que pode assumir alguns valores. Nesse caso, os valores devem ser configurados no Speech Studio.
Validação
As validações são construções aplicáveis a determinados tipos de parâmetros que permitem configurar restrições no valor de um parâmetro. Atualmente, os Comandos Personalizados suportam validações nos seguintes tipos de parâmetros:
- DateTime
- Número
Configuração de regras
Uma regra em Comandos Personalizados é definida por um conjunto de condições que, quando atendidas, executam um conjunto de ações. As regras também permitem configurar o estado pós-execução e as expectativas para o próximo turno.
Tipos
Comandos personalizados suporta as seguintes categorias de regras:
- Regras de conclusão: Estas regras devem ser executadas após o cumprimento do comando. Todas as regras configuradas nesta seção para as quais as condições são verdadeiras serão executadas.
- Regras de interação: essas regras podem ser usadas para configurar validações personalizadas extras, confirmações e uma correção de uma etapa, ou para realizar qualquer outra lógica de diálogo personalizada. As regras de interação são avaliadas em cada turno no processamento e podem ser usadas para acionar regras de conclusão.
As diferentes ações configuradas como parte de uma regra são executadas na ordem em que aparecem no portal de criação.
Condições
Condições são os requisitos que devem ser atendidos para que uma regra seja executada. As condições das regras podem ser dos seguintes tipos:
- Valor do parâmetro é igual: O valor do parâmetro configurado é igual a um valor específico.
- Nenhum valor de parâmetro: Os parâmetros configurados não devem ter nenhum valor.
- Parâmetros necessários: O parâmetro configurado tem um valor.
- Todos os parâmetros necessários: Todos os parâmetros que foram marcados como obrigatórios têm um valor.
- Parâmetros atualizados: Um ou mais valores de parâmetros foram atualizados como resultado do processamento da entrada atual (emissão ou atividade).
- A confirmação foi bem-sucedida: O enunciado ou atividade de entrada foi uma confirmação bem-sucedida (sim).
- A confirmação foi negada: a emissão ou atividade de entrada não foi uma confirmação bem-sucedida (não).
- O comando anterior precisa ser atualizado: essa condição é usada nos casos em que você deseja capturar uma confirmação negada junto com uma atualização. Nos bastidores, essa condição é configurada para quando o mecanismo de diálogo deteta uma confirmação negativa em que a intenção é a mesma do turno anterior e o usuário respondeu com uma atualização.
Ações
- Enviar resposta de fala: envie uma resposta de fala de volta para o cliente.
- Valor do parâmetro Update: atualize o valor de um parâmetro de comando para um valor especificado.
- Limpar valor do parâmetro: limpe o valor do parâmetro de comando.
- Chamar ponto de extremidade da Web: faça uma chamada para um ponto de extremidade da Web.
- Enviar atividade para o cliente: envie uma atividade personalizada para o cliente.
Expectativas
As expectativas são usadas para configurar dicas para o processamento da próxima entrada do usuário. São suportados os seguintes tipos:
- Aguardando confirmação do usuário: essa expectativa especifica que o aplicativo está esperando uma confirmação (sim/não) para a próxima entrada do usuário.
- Esperando a entrada do(s) parâmetro(s) do usuário: essa expectativa especifica um ou mais parâmetros de comando que o aplicativo está esperando da entrada do usuário.
Estado pós-execução
O estado pós-execução é o estado da caixa de diálogo após o processamento da entrada atual (enunciado ou atividade). É dos seguintes tipos:
- Manter o estado atual: mantenha apenas o estado atual.
- Conclua o comando: conclua o comando e não mais regras do comando são processadas.
- Executar regras de conclusão: Execute todas as regras de conclusão válidas.
- Aguarde a entrada do usuário: aguarde a próxima entrada do usuário.