SDK, REST e CLI recursos do desenvolvedor para Language Understanding (LUIS)

  • Artigo

Importante

O LUIS será aposentado em 1º de outubro de 2025 e a partir de 1º de abril de 2023 você não poderá criar novos recursos do LUIS. Recomendamos migrar seus aplicativos LUIS para o entendimento de linguagem conversacional para se beneficiar do suporte contínuo ao produto e dos recursos multilíngues.

SDKs, APIs REST, CLI ajudam você a desenvolver aplicativos de Compreensão de Linguagem (LUIS) em sua linguagem de programação. Gerencie seus recursos do Azure e previsões 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 recurso de Compreensão de Linguagem ou Serviços de IA do Azure.

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

Solicitações de criação e previsão de Compreensão de Idiomas

O serviço de Compreensão de Idiomas é acessado a partir de um recurso do Azure que você precisa criar. Existem dois recursos:

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

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

Especificações REST

As especificações LUIS REST, 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 previsão estão disponíveis em APIs REST:

Type Versão
Criação V2
pré-visualização V3
Previsão V2
V3

Pontos finais REST

O LUIS tem atualmente 2 tipos de endpoints:

  • Criação no ponto de extremidade de treinamento
  • previsão de consulta no ponto de extremidade de tempo de execução.
Propósito URL
Criação V2 no endpoint de treinamento https://{your-resource-name}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/
Criação V3 no endpoint de treinamento 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 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]
V3 Prediction - previsão de versões no endpoint de 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 endpoint de 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 a seguir explica os parâmetros, indicados com chaves {}, na tabela anterior.

Parâmetro Propósito
your-resource-name Nome do recurso do Azure
q ou query texto de emissão enviado do aplicativo cliente, como bot de bate-papo
version Nome da versão de 10 caracteres
slot production ou staging

Parâmetros da cadeia de caracteres de consulta REST

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

Parâmetro de consulta Nome do portal LUIS Type Versão Predefinido Propósito
log Guardar registos boolean V2 & V3 false Armazene a consulta no arquivo de log. O valor predefinido é falso.
query - string Apenas V3 Sem padrão - é necessário na solicitação GET Em V2, o enunciado q a ser previsto está no parâmetro.

Na V3, a funcionalidade é passada no query parâmetro.
show-all-intents Incluir pontuações para todos os fins boolean Apenas 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 o acesso programático sem a necessidade de encontrar a intenção em uma matriz: prediction.intents.give. Na V2, eles foram retornados em uma matriz.
verbose Incluir mais detalhes das entidades boolean V2 & V3 false Em V2, quando definido 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 entidade.
timezoneOffset - string V2 - Fuso horário aplicado a entidades datetimeV2.
datetimeReference - string V3 - Fuso horário aplicado a entidades datetimeV2. Substitui timezoneOffset a partir da V2.

Esquema da aplicação

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

SDKs baseados em linguagem

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

Contentores

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

Exportar e importar formatos

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

A importação e exportação destes formatos está disponível a partir das APIs e do portal LUIS. O portal fornece importação e exportação como parte da lista Aplicativos e da lista Versões.

Oficinas

Ferramentas de integração contínua

Ferramentas do Bot Framework

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

A estrutura do Bot fornece várias ferramentas para ajudar com a compreensão da linguagem, incluindo:

  • Emulador do Bot Framework - um aplicativo de desktop que permite que os desenvolvedores de bots testem e depurem bots criados usando o SDK do Bot Framework
  • Bot Framework Composer - uma ferramenta de desenvolvimento integrada para desenvolvedores e equipes multidisciplinares criarem bots e experiências de conversação com o Microsoft Bot Framework
  • Exemplos de Bot Framework - em #C, JavaScript, TypeScript e Python

Próximos passos