Recursos de desenvolvedor de SDK, REST e CLI para Reconhecimento vocal (LUIS)

  • Artigo

Importante

O LUIS será desativado em 1º de outubro de 2025 e, a partir de 1º de abril de 2023, você não poderá criar novos recursos do LUIS. É recomendável migrar seus aplicativos LUIS para a compreensão da linguagem coloquial a fim de usufruir do suporte contínuo ao produto e dos recursos multilíngues.

SDKs, APIs REST, CLI, ajudam a desenvolver aplicativos Reconhecimento vocal (LUIS) na linguagem de programação. Gerenciar recursos do Azure e previsões do LUIS.

Gerenciamento de recursos do Azure

Use a camada de gerenciamento de serviços de IA do Azure para criar, editar, listar e excluir o Reconhecimento vocal ou recurso de serviços de IA do Azure.

Encontre a documentação de referência com base na ferramenta:

Solicitações de criação e previsão de Reconhecimento vocal

O serviço de Reconhecimento vocal é acessado de um recurso do Azure que precisa ser criado. Há dois recursos:

  • Use o recurso de criação para treinamento para criar, editar, treinar e publicar.
  • Use a previsão de runtime para enviar o texto do usuário e receber uma previsão.

Use o código de exemplo de serviços de IA do Azure para aprender e usar as tarefas mais comuns.

Especificações REST

As especificações REST do LUIS, juntamente com todas as especificações REST do Azure, estão disponíveis publicamente no GitHub.

APIs REST

As APIS de ponto de extremidade de criação e de previsão estão disponíveis em APIs REST:

Tipo Versão
Criação V2
V3 versão prévia
Previsão V2
V3

Pontos de extremidade REST

Atualmente, o LUIS tem dois tipos de pontos de extremidade:

  • criação no ponto de extremidade de treinamento
  • previsão de consulta no ponto de extremidade de tempo de execução.
Finalidade URL
Criação no ponto de extremidade de treinamento V2 https://{your-resource-name}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/
Criação no ponto de extremidade de treinamento V3 https://{your-resource-name}.api.cognitive.microsoft.com/luis/authoring/v3.0-preview/apps/{appID}/
Previsão V2 – todas as previsões no ponto de extremidade de runtime https://{your-resource-name}.api.cognitive.microsoft.com/luis/v2.0/apps/{appId}?q={q}[&timezoneOffset][&verbose][&spellCheck][&staging][&bing-spell-check-subscription-key][&log]
Previsão V3 – previsão de versões no ponto de extremidade de runtime https://{your-resource-name}.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/{appId}/versions/{versionId}/predict?query={query}[&verbose][&log][&show-all-intents]
Previsão V3 – previsão de slot no ponto de extremidade de runtime https://{your-resource-name}.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/{appId}/slots/{slotName}/predict?query={query}[&verbose][&log][&show-all-intents]

A tabela a seguir explica os parâmetros, indicados com chaves {}, na tabela anterior.

Parâmetro Finalidade
your-resource-name Nome do recurso do Azure
q ou query texto de expressão enviado do aplicativo cliente como chat bot
version nome da versão de 10 caracteres
slot production ou staging

Parâmetros de cadeia de caracteres de Consulta REST

Os parâmetros de cadeia de caracteres de consulta da API V3 incluem:

Parâmetro de consulta Nome do portal do LUIS Tipo Versão Padrão Finalidade
log Salvar logs boolean V2 e V3 false Armazenar consulta no arquivo de log. O valor padrão é false.
query - string Somente V3 Nenhum padrão - ele é necessário na solicitação GET Na V2, o enunciado a ser previsto está no parâmetro q.

Na V3, a funcionalidade é passada no parâmetro query.
show-all-intents Incluir pontuações para todas as intenções booleano Somente V3 false Retorne todas as intenções com a pontuação correspondente no objeto prediction.intents. As intenções são retornadas como objetos em um objeto pai intents. Isso permite acesso programático sem a necessidade de encontrar a intenção em uma matriz: prediction.intents.give. Na V2, elas foram retornadas em uma matriz.
verbose Incluir mais detalhes de entidades boolean V2 e V3 false Na V2, quando definidas como true, todas as intenções previstas foram retornadas. Se você precisar de todas as intenções previstas, use o parâmetro V3 de show-all-intents.

Na V3, esse parâmetro fornece apenas detalhes de metadados de entidade de previsão de entidades.
timezoneOffset - string V2 - Fuso horário aplicado às entidades datetimeV2.
datetimeReference - string V3 - Fuso horário aplicado às entidades datetimeV2. Substitui timezoneOffset de V2.

Esquema de aplicativo

O esquema do aplicativo é importado e exportado em um formato .json ou .lu.

SDKs baseados em linguagem

Idioma Documentação de referência Pacote Início rápido
C# Criação
Previsão		 Criação do NuGet
Previsão do NuGet		 Criação
Previsão da consulta
Go Criação e previsão SDK
Java Criação e previsão Criação do Maven
Previsão do Maven
JavaScript Criação
Previsão		 Criação do NPM
Previsão do NPM		 Criação
Previsão
Python Criação e previsão Pip Criação
Previsão

Contêineres

O Reconhecimento vocal (LUIS) fornece um contêiner para fornecer versões locais e contidas do seu aplicativo.

Exportar e importar formatos

Reconhecimento vocal fornece a capacidade de gerenciar o aplicativo e seus modelos em um formato JSON, o .LU formato (LUDown) e um pacote compactado para o contêiner de Reconhecimento vocal.

A importação e a exportação desses formatos estão disponíveis nas APIs e no portal do LUIS. O portal fornece importação e exportação como parte da lista de aplicativos e lista de versões.

Workshops

Ferramentas de integração contínua

Ferramentas do Bot Framework

A estrutura de bot está disponível como um SDK em uma variedade de linguagens e como um serviço usando o Serviço de Bot de IA do Azure.

O Bot Framework fornece várias ferramentas para ajudar com Reconhecimento vocal, incluindo:

  • O Bot Framework Emulator – um aplicativo de área de trabalho que permite aos desenvolvedores testar e depurar bots criados usando o SDK do Bot Framework
  • Bot Framework Composer – uma ferramenta de desenvolvimento integrada para desenvolvedores e equipes multidisciplinares destinada a criar bots e experiências de conversa com o Microsoft Bot Framework
  • Exemplos do Bot Framework – em #C, JavaScript, TypeScript e Python

Próximas etapas