Recursos de desenvolvimento de SDK, REST e CLI para Language Understanding (LUIS)

  • Artigo
  • 4 minutos para ler

Importante

O LUIS será reformado a 1 de outubro de 2025 e a partir de 1 de abril de 2023 não poderá criar novos recursos LUIS. Recomendamos migrar as suas aplicações LUIS para a compreensão da linguagem de conversação para beneficiar do suporte contínuo do produto e das capacidades multilingues.

SDKs, REST APIs, CLI, ajudam-no a desenvolver aplicações Language Understanding (LUIS) na sua linguagem de programação. Gerencie os seus recursos Azure e previsões LUIS.

Gestão de recursos Azure

Utilize a camada de Gestão de Serviços Cognitivos Azure para criar, editar, listar e eliminar o recurso Language Understanding ou Serviço Cognitivo.

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

Language Understanding pedidos de autoria e previsão

O serviço Language Understanding é acedido a partir de um recurso Azure que precisa de criar. Existem dois recursos:

  • Utilize o recurso de autoria para formação para criar, editar, treinar e publicar.
  • Utilize a previsão para o tempo de funcionação para enviar o texto do utilizador e receber uma previsão.

Saiba mais sobre o ponto final da previsão V3.

Utilize o código de amostra dos Serviços Cognitivos para aprender e utilizar as tarefas mais comuns.

Especificações DE REPOUSO

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

APIs REST

Tanto a autoria como a previsão do ponto final APIS estão disponíveis a partir de APIs REST:

Tipo Versão
Criação V2
pré-visualização V3
Predição V2
V3

REST Pontos finais

A LUIS tem atualmente 2 tipos de pontos finais:

  • autoria no ponto final de formação
  • previsão de consulta sobre o ponto final de tempo de execução.
Objetivo URL
V2 Autoria no ponto final da formação https://{your-resource-name}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/
V3 Autoria no ponto final da formação https://{your-resource-name}.api.cognitive.microsoft.com/luis/authoring/v3.0-preview/apps/{appID}/
Previsão V2 - todas as previsões no ponto final do tempo de execução 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 final do tempo de execução 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 final do tempo de execução 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 seguinte explica os parâmetros, denotados {}com chaves encaracoladas, na tabela anterior.

Parâmetro Objetivo
your-resource-name Nome de recurso Azure
q ou query texto de expressão enviado a partir de aplicação do cliente, como chat bot
version Nome da versão de 10 caracteres
slot production ou staging

Parâmetros de cadeia de consulta DE REST

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

Parâmetro de consulta Nome do portal LUIS Tipo Versão Predefinição Objetivo
log Guardar registos boolean V2 & V3 false Faça a consulta no ficheiro de registo. O valor predefinido é falso.
query - string Apenas V3 Sem predefinição - é necessário no pedido GET Em V2, a expressão a prever está no q parâmetro.

Na V3, a funcionalidade é passada no query parâmetro.
show-all-intents Incluir pontuações para todos os efeitos boolean Apenas V3 false Devolva todas as intenções com a pontuação correspondente no objeto de previsão.intenções . As intenções são devolvidas como objetos num objeto principal intents . Isto permite o acesso programático sem necessidade de encontrar a intenção numa matriz: prediction.intents.give. Em V2, estes foram devolvidos numa matriz.
verbose Incluir mais detalhes de entidades boolean V2 & V3 false Em V2, quando definido como verdadeiro, todas as intenções previstas foram devolvidas. Se precisar de todas as intenções previstas, use o param V3 de show-all-intents.

Na V3, este parâmetro apenas fornece detalhes de metadados de entidades da previsão da entidade.
timezoneOffset - string V2 - O timezone aplicado às entidades datav2.
datetimeReference - string V3 - O timezone aplicado às entidades datav2. timezoneOffset Substitui a V2.

Esquema da aplicação

O esquema da aplicação é importado e exportado em formato .json ou formato .lu .

SDKs baseados em linguagem

Linguagem Documentação de referência Pacote Guias de Início Rápido
C# Autoria
Previsão		 Autoria nuGet
Previsão do NuGet		 Criação
Previsão de consulta
Go Autoria e previsão SDK
Java Autoria e previsão Autoria de Maven
Previsão de Maven
JavaScript Criação
Predição		 Autoria do NPM
Previsão do NPM		 Criação
Predição
Python Autoria e previsão Pip Criação
Predição

Contentores

Language Understanding (LUIS) fornece um recipiente para fornecer no local e versões contidas da sua aplicação.

Formatos de exportação e importação

Language Understanding fornece a capacidade de gerir a sua app e os seus modelos em formato JSON, o .LU formato (LUDown) e um pacote comprimido para o recipiente Language Understanding.

Importar e exportar estes formatos está disponível nas APIs e no portal LUIS. O portal fornece importação e exportação como parte da lista de aplicações e versões.

Workshops

Ferramentas de integração contínua

Ferramentas de estrutura de bot

A estrutura bot está disponível como SDK em uma variedade de idiomas e como um serviço usando Azure Bot Service.

A estrutura do bot fornece várias ferramentas para ajudar com Language Understanding, incluindo:

  • Emulador Bot Framework - uma aplicação para desktop que permite aos desenvolvedores de bots testar e depurar bots construídos usando o Bot Framework SDK
  • Bot Framework Composer - uma ferramenta integrada de desenvolvimento para desenvolvedores e equipas multidisciplinares para construir bots e experiências de conversação com o Microsoft Bot Framework
  • Amostras de estrutura de bot - em #C, JavaScript, TypeScript e Python

Passos seguintes