Desenvolver aplicativos de Comandos Personalizados

Artigo
01/21/2024

Importante

Os comandos personalizados serão desativados em 30 de abril de 2026. A partir de 30 de outubro de 2023, não é possível criar novos aplicativos de Comandos Personalizados no Speech Studio. Relacionado a essa alteração, o LUIS será desativado em 1º de outubro de 2025. A partir de 1º de abril de 2023, não é possível criar novos recursos do LUIS.

Neste artigo de instruções, você aprenderá a desenvolver e configurar aplicativos de Comandos Personalizados. O recurso Comandos Personalizados ajuda a criar aplicativos avançados de comando de voz que são otimizados para experiências de interação que priorizam a voz. O recurso é mais adequado para cenários de conclusão de tarefas ou de comando e controle. Ela é adequada para dispositivos IoT (Internet das Coisas) e para dispositivos de ambiente e sem periféricos.

Neste artigo, você criará um aplicativo que pode ligar e desligar uma TV, definir a temperatura e definir um alarme. Depois de criar esses comandos básicos, você aprenderá sobre as seguintes opções para Personalizar Comandos:

Adicionar parâmetros aos comandos
Adicionar configurações aos parâmetros dos comandos
Criar regras de interação
Criar modelos de geração de linguagem para respostas de Fala
Usar ferramentas de voz personalizada

Criar um aplicativo usando comandos simples

Começar criando um aplicativo vazio de Comandos Personalizados. Para obter detalhes, confira o início rápido. Nesse aplicativo, em vez de importar um projeto, você cria um projeto em branco.

Na caixa Nome, insira o nome do projeto Smart-Room-Lite (ou outro nome de sua escolha).
Na lista Idiomas, selecione Inglês (Estados Unidos) .
Selecione ou crie um recurso LUIS.

Atualizar recursos LUIS (opcional)

Você pode atualizar o recurso de criação que selecionou na janela Novo projeto. Você também pode definir um recurso de previsão.

Um recurso de previsão é usado para reconhecimento quando o aplicativo de Comandos Personalizados é publicado. Você não precisa de um recurso de previsão durante as fases de desenvolvimento e teste.

Adicionar um comando TurnOn

Adicione um comando no aplicativo vazio de Comandos Personalizados, Smart-Room-Lite, que você criou. O comando processa um enunciado: Turn on the tv. Ele responde com a mensagem Ok, turning the tv on.

Crie um comando selecionando Novo comando, na parte superior do painel esquerdo. A janela Novo comando será exibida.
Para o campo Nome, forneça o valor TurnOn.
Selecione Criar.

O painel central lista as propriedades do comando.

A tabela a seguir explica as propriedades de configuração do comando. Para obter mais informações, confira Definições e conceitos de Comandos Personalizados.

Configuração	Descrição
Sentenças de exemplo	Exemplos de enunciados que o usuário pode falar para disparar esse comando.
Parâmetros	Informações necessárias para concluir o comando.
Regras de conclusão	Ações a serem executadas para concluir o comando. Exemplos: respondendo ao usuário ou se comunicando com um serviço Web.
Regras de interação	Outras regras para lidar com situações mais específicas ou complexas.

Screenshot showing where to create a command.

Adicionar sentenças de exemplo

Na seção Sentenças de exemplo, você fornece um exemplo daquilo que o usuário pode dizer.

No painel central, selecione Sentenças de exemplo.
No painel à direita, adicione exemplos:
```
Turn on the tv
```
Na parte superior do painel, selecione Salvar.

Você ainda não tem parâmetros, portanto, você pode ir para a seção Regras de conclusão.

Adicionar uma regra de conclusão

Em seguida, o comando precisa de uma regra de conclusão. Essa regra informa ao usuário que uma ação de conclusão está sendo executada.

Para obter mais informações sobre regras e regras de conclusão, confira Definições e conceitos de Comandos Personalizados.

Selecione a regra de conclusão padrão Concluída. Em seguida, edite-a da seguinte maneira:

Configuração	Valor sugerido	Description
Nome	`ConfirmationResponse`	Um nome que descreve a finalidade da regra
Condições	Nenhum	Condições que determinam quando a regra pode ser executada
Ações	Enviar resposta de fala>Editor simples>`Ok, turning the tv on`	A ação a ser tomada quando a condição da regra for verdadeira

Screenshot showing where to create a speech response.

Selecione Salvar para salvar a ação.
De volta à seção Regras de conclusão, selecione Salvar para salvar todas as alterações.

Observação

Você não precisa usar a regra de conclusão padrão que vem com o comando. Você pode excluir a regra de conclusão padrão e adicionar a sua regra.

Adicionar um comando SetTemperature

Agora, adicione mais um comando, SetTemperature. Esse comando usa apenas um enunciado, Set the temperature to 40 degrees, e responde com a mensagem Ok, setting temperature to 40 degrees.

Para criar o novo comando, siga as etapas usadas para o comando TurnOn, mas use a sentença de exemplo Set the temperature to 40 degrees.

Em seguida, edite as regras de conclusão Concluídas existentes, da seguinte maneira:

Configuração	Valor sugerido
Nome	`ConfirmationResponse`
Condições	Nenhum
Ações	Enviar resposta de Fala>Editor simples>Primeira variação>`Ok, setting temperature to 40 degrees`

Selecione Salvar para salvar todas as alterações feitas no comando.

Adicionar um comando SetAlarm

Crie um comando SetAlarm. Use a sentença de exemplo Set an alarm for 9 am tomorrow. Em seguida, edite as regras de conclusão Concluídas existentes, da seguinte maneira:

Configuração	Valor sugerido
Nome	`ConfirmationResponse`
Condições	Nenhum
Ações	Enviar resposta de Fala>Editor simples>Primeira variação>`Ok, setting an alarm for 9 am tomorrow`

Selecione Salvar para salvar todas as alterações feitas no comando.

Experimente

Teste o comportamento do aplicativo usando o painel de teste:

No canto superior direito do painel, selecione o ícone Treinar.
Quando o treinamento for concluído, selecione Testar.

Experimente os seguintes exemplos de enunciado usando voz ou texto:

Você digita: definir a temperatura como 40 graus
Resposta esperada: ok, definindo a temperatura como 40 graus
Você digita: ligar a TV
Resposta esperada: ok, ligando a TV
Você digita: definir um alarme para 9h, amanhã
Resposta esperada: ok, definindo um alarme para 9h, amanhã

Screenshot showing the test in a web-chat interface.

Dica

No painel de teste, você pode selecionar Ativar detalhes para obter informações sobre como essa entrada de voz ou de texto foi processada.

Adicionar parâmetros a comandos

Nesta seção, você aprenderá como adicionar parâmetros aos seus comandos. Os comandos exigem parâmetros para concluir uma tarefa. Em cenários complexos, os parâmetros podem ser usados para definir condições que disparam ações personalizadas.

Configurar parâmetros do comando TurnOn

Comece editando o comando TurnOn existente para ligar e desligar vários dispositivos.

Agora que o comando gerencia os cenários ativado e desativado, renomeie o comando para TurnOnOff.
1. No painel à esquerda, selecione o comando TurnOn. Em seguida, ao lado do Novo comando, na parte superior do painel, selecione o botão editar.
2. Na janela Renomear comando, altere o nome para TurnOnOff.

Adicione um novo parâmetro ao comando. O parâmetro representa se o usuário deseja ativar ou desativar o dispositivo.

Na parte superior do painel central, selecione Adicionar. No menu suspenso, selecione Parâmetro.
No painel à direita, na seção Parâmetros, na caixa Nome, adicione OnOff.
Selecione Obrigatório. Na janela Adicionar resposta para um parâmetro obrigatório, selecione Editor simples. No campo Primeira variação, adicione Ativado ou Desativado.
Selecione Atualizar.

Configure as propriedades do parâmetro usando a tabela a seguir. Para obter informações sobre todas as propriedades de configuração de um comando, confira Definições e conceitos de Comandos Personalizados.

Configuração	Valor sugerido	Description
Nome	`OnOff`	Um nome descritivo para o parâmetro
Necessário	Selecionado	Caixa de seleção que indica se é obrigatório fornecer um valor para esse parâmetro antes que o comando seja concluído.
Resposta para o parâmetro obrigatório	Editor simples>`On or Off?`	Um prompt solicitando o valor desse parâmetro quando ele não for conhecido.
Tipo	Cadeia de caracteres	Tipo do parâmetro, tal como número, cadeia de caracteres, datetime ou geografia.
Configuration	Aceitar valores de entrada predefinidos provenientes de um catálogo interno	Para cadeias de caracteres, essa configuração limita as entradas a um conjunto de valores possíveis.
Valores de entrada predefinidos	`on`, `off`	Conjunto de valores possíveis e seus alias.

Para adicionar valores de entrada predefinidos, selecione Adicionar uma entrada predefinida. Na janela Novo Item, digite o Nome, conforme mostrado na tabela anterior. Nesse caso, como você não está usando alias, pode deixar esse campo em branco.
Selecione Salvar para salvar todas as configurações do parâmetro.

Adicionar um parâmetro SubjectDevice

Para adicionar um segundo parâmetro a fim de representar o nome dos dispositivos que podem ser controlados usando esse comando, selecione Adicionar. Use a configuração a seguir.

Configuração	Valor sugerido
Nome	`SubjectDevice`
Necessário	Selecionado
Resposta para o parâmetro obrigatório	Editor simples>`Which device do you want to control?`
Tipo	Cadeia de caracteres
Configuration	Aceitar valores de entrada predefinidos provenientes de um catálogo interno
Valores de entrada predefinidos	`tv`, `fan`
Alias (`tv`)	`television`, `telly`

Clique em Salvar.

Modificar sentenças de exemplo

Para comandos que usam parâmetros, é útil adicionar frases de exemplo que abrangem todas as combinações possíveis. Por exemplo:

Informações completas sobre o parâmetro: turn {OnOff} the {SubjectDevice}
Informações parciais sobre o parâmetro: turn it {OnOff}
Nenhuma informação sobre o parâmetro: turn something

As sentenças de exemplo que usam diferentes graus de informações permitem que o aplicativo de Comandos Personalizados solucione as resoluções pontuais e as resoluções recorrentes usando informações parciais.

Com essas informações em mente, edite as sentenças de exemplo para usar esses parâmetros sugeridos:

turn {OnOff} the {SubjectDevice}
{SubjectDevice} {OnOff}
turn it {OnOff}
turn something {OnOff}
turn something

Clique em Salvar.

Dica

No editor de sentenças de exemplo, use os símbolos de chaves para fazer referência aos parâmetros. Por exemplo, turn {OnOff} the {SubjectDevice}. Use uma guia para a conclusão automática apoiada por parâmetros criados anteriormente.

Modificar regras de conclusão para incluir parâmetros

Modifique a regra de conclusão ConfirmationResponse existente.

Na seção Condições, selecione Adicionar uma condição.
Na janela Nova condição, na lista Tipo, selecione Parâmetros obrigatórios. Na lista que vem a seguir, marque OnOff e SubjectDevice.
Selecione Criar.
Na seção Ações, edite a ação Enviar resposta de Fala passando o mouse sobre ela e selecionando o botão Editar. Desta vez, use os parâmetros criados recentemente OnOff e SubjectDevice:
```
Ok, turning the {SubjectDevice} {OnOff}
```
Clique em Salvar.

Experimente as alterações selecionando o ícone Treinar, na parte superior do painel à direita.

Quando o treinamento for concluído, selecione Testar. A janela Testar seu aplicativo será exibida. Experimente as seguintes interações:

Entrada: desligar a TV
Saída: ok, desligando a TV
Entrada: desligar a televisão
Saída: ok, desligando a TV
Entrada: desligar
Saída: qual dispositivo você deseja controlar?
Entrada: a TV
Saída: ok, desligando a TV

Configurar parâmetros do comando SetTemperature

Modifique o comando SetTemperature a fim de habilitá-lo para definir a temperatura conforme determinado pelo usuário.

Adicionar um parâmetro TemperatureValue. Use a seguinte configuração:

Configuração	Valor sugerido
Nome	`TemperatureValue`
Necessário	Selecionado
Resposta para o parâmetro obrigatório	Editor simples>`What temperature would you like?`
Tipo	`Number`

Edite os exemplos de enunciados a fim de usar os valores a seguir.

set the temperature to {TemperatureValue} degrees
change the temperature to {TemperatureValue}
set the temperature
change the temperature

Edite as regras de conclusão existentes. Use a configuração a seguir.

Configuração	Valor sugerido
Condições	Parâmetro obrigatório>TemperatureValue
Ações	Enviar resposta de Fala>`Ok, setting temperature to {TemperatureValue} degrees`

Configurar parâmetros do comando SetAlarm

Adicione um parâmetro chamado DateTime. Use a configuração a seguir.

Configuração	Valor sugerido
Nome	`DateTime`
Necessário	Selecionado
Resposta para o parâmetro obrigatório	Editor simples>`For what time?`
Tipo	DateTime
Padrões de data	Se a data estiver ausente, use o dia atual.
Padrões de hora	Se a hora estiver ausente, use o início do dia.

Observação

Este artigo usa principalmente os tipos de parâmetro cadeia de caracteres, número e datetime. Para obter uma lista com todos os tipos de parâmetro compatíveis e suas respectivas propriedades, confira Definições e conceitos de Comandos Personalizados.

Edite os enunciados de exemplo. Use os seguintes valores.

set an alarm for {DateTime}
set alarm {DateTime}
alarm for {DateTime}

Edite as regras de conclusão existentes. Use a configuração a seguir.

Configuração	Valor sugerido
Ações	Enviar resposta de Fala>`Ok, alarm set for {DateTime}`

Teste os três comandos juntos usando enunciados relacionados a diferentes comandos. (Você pode alternar entre os diferentes comandos.)

Entrada: definir um alarme
Saída: para que hora?
Entrada: ligar a TV
Saída: ok, ligando a TV
Entrada: definir um alarme
Saída: para que hora?
Entrada: 17:00
Saída: ok, alarme definido para 2020-05-01 17:00:00

Adicionar configurações aos parâmetros do comando

Nesta seção, você aprenderá mais sobre a configuração avançada de parâmetros, incluindo:

Como os valores de parâmetro podem pertencer a um conjunto que é definido fora do aplicativo de Comandos Personalizados.
Como adicionar cláusulas de validação nos valores de parâmetro.

Configurar um parâmetro como uma entidade do catálogo externo

O recurso de Comandos Personalizados permite que você configure parâmetros do tipo cadeia de caracteres para se referir a catálogos externos hospedados em um ponto de extremidade da Web. Portanto, você pode atualizar o catálogo externo de maneira independe, sem editar o aplicativo de Comandos Personalizados. Essa abordagem é útil para casos em que as entradas do catálogo são numerosas.

Reutilize o parâmetro SubjectDevice do comando TurnOnOff. A configuração atual desse parâmetro é Aceitar entradas predefinidas do catálogo interno. Essa configuração se refere a uma lista estática de dispositivos na configuração do parâmetro. Mova esse conteúdo para uma fonte de dados externa que possa ser atualizada de maneira independente.

Para mover o conteúdo, comece adicionando um novo ponto de extremidade da Web. No painel à esquerda, vá para a seção pontos de extremidade da Web. Adicione uma nova URL de ponto de extremidade da Web. Use a configuração a seguir.

Configuração	Valor sugerido
Nome	`getDevices`
URL	`<Your endpoint of getDevices.json>`
Método	GET

Em seguida, configure e hospede um ponto de extremidade da Web que retorna um arquivo JSON que lista os dispositivos que podem ser controlados. O ponto de extremidade da Web deve retornar um arquivo JSON formatado como este exemplo:

{
    "fan" : [],
    "refrigerator" : [
        "fridge"
    ],
    "lights" : [
        "bulb",
        "bulbs",
        "light",
        "light bulb"
    ],
    "tv" : [
        "telly",
        "television"
        ]
}

Em seguida, vá para a página de configurações do parâmetro SubjectDevice. Defina as propriedades a seguir.

Configuração	Valor sugerido
Configuration	Aceitar entradas predefinidas do catálogo externo
Ponto de extremidade do catálogo	`getDevices`
Método	GET

Em seguida, selecione Salvar.

Importante

Você não verá uma opção para configurar um parâmetro a fim de aceitar entradas de um catálogo externo, a menos que tenha o ponto de extremidade da Web definido na seção Ponto de extremidade da Web, no painel à esquerda.

Experimente selecionando Treinar. Após a conclusão do treinamento, selecione Testar e experimente algumas interações.

Entrada: ligar
Saída: qual dispositivo você deseja controlar?
Entrada: luzes
Saída: ok, acendendo as luzes

Observação

Agora você pode controlar todos os dispositivos hospedados no ponto de extremidade da Web. Mas você ainda precisa treinar o aplicativo para testar as novas alterações e, em seguida, republicar o aplicativo.

Adicionar validação aos parâmetros

Validações são constructos que se aplicam a determinados tipos de parâmetro que permitem configurar restrições para o valor do parâmetro. Elas solicitam correções se os valores não ficam dentro das restrições. Para obter uma lista de tipos de parâmetro que estendem o constructo de validação, confira Definições e conceitos de Comandos Personalizados.

Teste as validações usando o comando SetTemperature. Use as etapas a seguir para adicionar uma validação ao parâmetro Temperature.

No painel à esquerda, selecione o comando SetTemperature.
No painel central, selecione Temperatura.
No painel à direita, selecione Adicionar uma validação.

Na janela Nova validação, configure a validação, conforme mostrado na tabela a seguir. Em seguida, selecione Criar.

Configuração de parâmetro	Valor sugerido	Descrição
Valor mínimo	`60`	Para parâmetros numéricos, o valor mínimo que o parâmetro pode assumir
Valor máximo	`80`	Para parâmetros numéricos, o valor máximo que o parâmetro pode assumir
Resposta a falhas	Editor simples>Primeira variação>`Sorry, I can only set temperature between 60 and 80 degrees. What temperature do you want?`	Um prompt para solicitar um novo valor se a validação falhar

Screenshot showing how to add a range validation.

Experimente selecionando o ícone Treinar, na parte superior do painel à direita. Depois que o treinamento for concluído, selecione Testar. Experimente algumas interações:

Entrada: definir a temperatura como 72 graus
Saída: ok, definindo a temperatura como 72 graus
Entrada: definir a temperatura como 45 graus
Saída: só posso definir a temperatura entre 60 e 80 graus
Entrada: então, definir como 72 graus
Saída: ok, definindo a temperatura como 72 graus

Adicionar regras de interação

Regras de interação são regras adicionais que lidam com situações específicas ou complexas. Embora você esteja livre para criar suas próprias regras de interação, neste exemplo, você usa regras de interação para os seguintes cenários:

Confirmar comandos
Adicionar uma correção de uma etapa aos comandos

Para obter mais informações sobre as regras de interação, confira Definições e conceitos de Comandos Personalizados.

Adicionar confirmações a um comando

Para adicionar uma confirmação, use o comando SetTemperature. Para alcançar a confirmação, crie regras de interação usando as seguintes etapas:

No painel à esquerda, selecione o comando SetTemperature.
No painel central, adicione regras de interação selecionando Adicionar. Em seguida, selecione Regras de interação>Confirmar comando.

Essa ação adiciona três regras de interação. As regras solicitam que o usuário confirme a data e a hora do alarme. Elas esperam uma confirmação (sim ou não) para a próxima rodada.
1. Modifique a regra de interação do comando Confirmar usando a seguinte configuração:
  1. Altere o nome para Confirmar temperatura.
  2. A condição Todos os parâmetros necessários já está definida.
  3. Adicione uma nova ação: Tipo>Enviar resposta de Fala>Tem certeza de que deseja definir a temperatura como {TemperatureValue} graus?
  4. Na seção Expectativas, deixe o valor padrão de Esperando confirmação do usuário.
2. Modifique a regra de interação Confirmação bem-sucedida para gerenciar uma confirmação bem-sucedida (em que o usuário diz sim).
  1. Altere o nome para Confirmação de temperatura bem-sucedida.
  2. Deixe a condição existente A confirmação foi bem-sucedida.
  3. Adicione uma nova condição: Tipo>Parâmetros obrigatórios>TemperatureValue.
  4. Deixe o valor padrão do Estado pós-execução como Executar regras de conclusão.
3. Modifique a regra de interação Confirmação negada para gerenciar cenários quando a confirmação for negada (em que o usuário diz não).
  1. Altere o nome para Confirmação de temperatura negada.
  2. Deixe a condição existente A confirmação foi negada.
  3. Adicione uma nova condição: Tipo>Parâmetros obrigatórios>TemperatureValue.
  4. Adicione uma nova ação: Tipo>Enviar resposta de fala>Sem problemas. Qual temperatura, então? .
  5. Altere o valor padrão do Estado pós-execução para Aguardar a entrada do usuário.

Importante

Neste artigo, você usa a funcionalidade interna de confirmação. Você também pode adicionar manualmente as regras de interação, uma a uma.

Experimente as alterações selecionando Treinar. Quando o treinamento for concluído, selecione Testar.

Entrada: defina a temperatura como 80 graus
Saída: tem certeza de que deseja definir a temperatura como 80 graus?
Entrada: não
Saída: sem problema. Qual temperatura, então?
Entrada: 72 graus
Saída: tem certeza de que deseja definir a temperatura como 72 graus?
Entrada: sim
Saída: ok, definindo a temperatura como 72 graus

Implementar correções em um comando

Nesta seção, você vai configurar uma correção de uma etapa. Essa correção é usada após a execução da ação de conclusão. Você também verá um exemplo de como uma correção é habilitada por padrão se o comando ainda não for concluído. Para adicionar uma correção quando o comando não for concluído, adicione o novo parâmetro AlarmTone.

No painel esquerdo, selecione o comando SetAlarm. Em seguida, adicione o novo parâmetro AlarmTone.

Nome>AlarmTone
Tipo>Cadeia de caracteres
Valor padrão>Chimes
Configuração>Aceitar valores de entrada predefinidos do catálogo interno
Valores de entrada predefinidos>Chimes, Jingle e Echo (esses valores são entradas individuais predefinidas.)

Em seguida, atualize a resposta para o parâmetro DateTime como Pronto para definir o alarme com o tom {AlarmTone}. Para que hora? . Então, modifique a regra de conclusão da seguinte maneira:

Selecione a regra de conclusão existente ConfirmationResponse.
No painel à direita, passe o mouse sobre a ação existente e selecione Editar.
Atualize a resposta de Fala para OK, alarm set for {DateTime}. The alarm tone is {AlarmTone}.

Importante

O tom de alarme pode ser alterado sem nenhuma configuração explícita no comando em andamento. Por exemplo, ele pode mudar quando o comando ainda não tiver terminado. Uma correção é habilitada por padrão para todos os parâmetros do comando, independentemente da ordem, se o comando ainda não tiver sido concluído.

Implementar uma correção quando um comando for concluído

A plataforma de Comandos Personalizados permite a correção de uma etapa mesmo quando o comando for concluído. Esse recurso não é habilitado por padrão. Ele deve ser configurado explicitamente.

Execute as seguintes etapas para configurar uma conexão de uma etapa:

No comando SetAlarm, adicione uma regra de interação do tipo Atualizar comando anterior para atualizar o alarme definido anteriormente. Renomeie a regra de interação como Atualizar alarme anterior.
Deixe a condição padrão: Comando anterior precisa ser atualizado.
Adicione uma nova condição: Tipo>Parâmetro Obrigatório>DateTime.
Adicionar uma nova ação: Tipo>Enviar resposta de fala>Editor simples>Atualizando a hora do alarme anterior para {DateTime} .
Deixe o valor padrão do Estado pós-execução como Comando concluído.

Experimente as alterações selecionando Treinar. Aguarde a conclusão do treinamento e, em seguida, selecione Testar.

Entrada: definir um alarme.
Saída: pronto para definir o alarme com o tom Chimes. Para que hora?
Entrada: definir um alarme com o tom Jingle para 9:00, amanhã.
Saída: ok, alarme definido para 2020-05-21 09:00:00. O tom do alarme é o Jingle.
Entrada: não, 8:00.
Saída: atualizando a hora do alarme anterior para 29/05/2020 08:00.

Observação

Em um aplicativo real, na seção Ações dessa regra de correção, você também precisará enviar de volta uma atividade para o cliente ou chamar um ponto de extremidade HTTP para atualizar a hora do alarme no seu sistema. Essa ação deve ser exclusivamente responsável por atualizar a hora do alarme. Ela não deve ser responsável por nenhum outro atributo do comando. Nesse caso, esse atributo seria o tom do alarme.

Adicionar modelos de geração de linguagem para respostas de Fala

Os modelos de LG (geração de linguagem) permitem que você personalize as respostas enviadas ao cliente. Eles introduzem a variação nas respostas. Você pode obter a geração de linguagem usando:

Modelos de geração de linguagem.
Expressões adaptáveis.

Os modelos de Comandos Personalizados são baseados nos modelos de LG do Bot Framework. Como o recurso de Comandos Personalizados cria um modelo de LG quando necessário (para respostas de Fala em parâmetros ou ações), você não precisa especificar o nome do modelo de LG.

Portanto, você não precisa definir seu modelo da seguinte maneira:

   # CompletionAction
   - Ok, turning {OnOff} the {SubjectDevice}
   - Done, turning {OnOff} the {SubjectDevice}
   - Proceeding to turn {OnOff} {SubjectDevice}

Em vez disso, você pode definir o corpo do modelo sem o nome, desta forma:

Screenshot showing a template editor example.

Essa alteração introduz a variação nas respostas de Fala que são enviadas ao cliente. Para um enunciado, a resposta de Fala correspondente é separada aleatoriamente das opções fornecidas.

Aproveitando os modelos de LG, você também pode definir respostas de Fala complexas para os comandos usando expressões adaptáveis. Para obter mais informações, confira o Formato de modelos de LG.

Por padrão, o recurso de Comandos Personalizados dá suporte a todas as funcionalidades, com as seguintes diferenças secundárias:

Nos modelos de LG, as entidades são representadas como ${entityName}. O recurso de Comandos Personalizados não usa entidades. Mas você pode usar parâmetros como variáveis com a representação ${parameterName} ou a representação {parameterName}.
O recurso de Comandos Personalizados não dá suporte à composição e expansão de modelos, pois você nunca edita o arquivo .lg diretamente. Você edita apenas as respostas de modelos criados automaticamente.
O recurso de Comandos Personalizados não dá suporte a funções personalizadas que a LG injeta. Há suporte para funções predefinidas.
O recurso de Comandos Personalizados não oferece suporte a opções como strict, replaceNull e lineBreakStyle.

Adicionar respostas de modelo ao comando TurnOnOff

Modifique o comando TurnOnOff para adicionar um novo parâmetro. Use a configuração a seguir.

Configuração	Valor sugerido
Nome	`SubjectContext`
Necessário	Não selecionado
Tipo	Cadeia de caracteres
Valor padrão	`all`
Configuration	Aceitar valores de entrada predefinidos provenientes do catálogo interno
Valores de entrada predefinidos	`room`, `bathroom`, `all`

Modificar uma regra de conclusão

Edite a seção Ações da regra de conclusão existente ConfirmationResponse. Na janela Editar ação, alterne para o Editor de modelos. Então, substitua o texto pelos exemplos a seguir.

- IF: @{SubjectContext == "all" && SubjectDevice == "lights"}
    - Ok, turning all the lights {OnOff}
- ELSEIF: @{SubjectDevice == "lights"}
    - Ok, turning {OnOff} the {SubjectContext} {SubjectDevice}
- ELSE:
    - Ok, turning the {SubjectDevice} {OnOff}
    - Done, turning {OnOff} the {SubjectDevice}

Treine e teste seu aplicativo usando a entrada e a saída a seguir. Observe a variação de respostas. A variação é criada por várias alternativas do valor do modelo e também pelo uso de expressões adaptáveis.

Entrada: ligar a TV
Saída: ok, ligando a TV
Entrada: ligar a TV
Saída: concluído, TV ligada
Entrada: desligar as luzes
Saída: ok, desligando todas as luzes
Entrada: desligar as luzes da sala
Saída: ok, desligando as luzes da sala

Usar uma voz personalizada

Outra maneira de personalizar as respostas de Comandos Personalizados é selecionando uma voz de saída. Use as seguintes etapas para alternar a voz padrão para uma voz personalizada:

Em seu aplicativo de Comandos Personalizados, no painel à esquerda, selecione Configurações.
No painel central, selecione Voz Personalizada.
Na tabela, selecione uma voz personalizada ou uma voz pública.
Selecione Salvar.

Screenshot showing sample sentences and parameters.

Observação

Para vozes públicas, os tipos neurais estão disponíveis apenas para regiões específicas. Para obter mais informações, confira Regiões com suporte para o serviço de Fala.

Você pode criar vozes personalizadas na página do projeto de Voz personalizada. Para saber mais, confira Introdução à voz personalizada.

Agora, o aplicativo responde na voz selecionada, em vez da voz padrão.

Próximas etapas

Saiba como integrar seu aplicativo de Comandos Personalizados a um aplicativo cliente usando o SDK de Fala.
Configure a implantação contínua para o seu aplicativo de Comandos Personalizados usando o Azure DevOps.

Desenvolver aplicativos de Comandos Personalizados

Criar um aplicativo usando comandos simples

Atualizar recursos LUIS (opcional)

Adicionar um comando TurnOn

Adicionar sentenças de exemplo

Adicionar uma regra de conclusão

Adicionar um comando SetTemperature

Adicionar um comando SetAlarm

Experimente

Adicionar parâmetros a comandos

Configurar parâmetros do comando TurnOn

Adicionar um parâmetro SubjectDevice

Modificar sentenças de exemplo

Modificar regras de conclusão para incluir parâmetros

Configurar parâmetros do comando SetTemperature

Configurar parâmetros do comando SetAlarm

Adicionar configurações aos parâmetros do comando

Configurar um parâmetro como uma entidade do catálogo externo

Adicionar validação aos parâmetros

Adicionar regras de interação

Adicionar confirmações a um comando

Implementar correções em um comando

Implementar uma correção quando um comando for concluído

Adicionar modelos de geração de linguagem para respostas de Fala

Adicionar respostas de modelo ao comando TurnOnOff

Modificar uma regra de conclusão

Usar uma voz personalizada

Próximas etapas

Recursos adicionais