Recursos de desenvolvedor de SDK, REST e CLI para Reconhecimento vocal (LUIS)SDK, REST, and CLI developer resources for Language Understanding (LUIS)

SDKs, APIs REST, CLI, ajudam você a desenvolver aplicativos Reconhecimento vocal (LUIS) em sua linguagem de programação.SDKs, REST APIs, CLI, help you develop Language Understanding (LUIS) apps in your programming language. Gerencie seus recursos do Azure e previsões do LUIS.Manage your Azure resources and LUIS predictions.

Gerenciamento de recursos do AzureAzure resource management

Use a camada de gerenciamento de serviços cognitivas do Azure para criar, editar, listar e excluir o Reconhecimento vocal ou recurso de serviço cognitiva.Use the Azure Cognitive Services Management layer to create, edit, list, and delete the Language Understanding or Cognitive Service resource.

Encontre a documentação de referência com base na ferramenta:Find reference documentation based on the tool:

Solicitações de criação e previsão de Reconhecimento vocalLanguage Understanding authoring and prediction requests

O serviço de Reconhecimento vocal é acessado de um recurso do Azure que você precisa criar.The Language Understanding service is accessed from an Azure resource you need to create. Há dois recursos:There are two resources:

  • Use o recurso de criação para treinamento para criar, editar, treinar e publicar.Use the authoring resource for training to create, edit, train, and publish.
  • Use a previsão de tempo de execução para enviar o texto do usuário e receber uma previsão.Use the prediction for runtime to send user's text and receive a prediction.

Saiba mais sobre o ponto de extremidade de previsão v3.Learn about the V3 prediction endpoint.

Use o código de exemplo de serviços cognitivas para aprender e usar as tarefas mais comuns.Use Cognitive Services sample code to learn and use the most common tasks.

Especificações RESTREST specifications

As especificações REST do Luis, juntamente com todas as especificações REST do Azure, estão disponíveis publicamente no github.The LUIS REST specifications, along with all Azure REST specifications, are publicly available on GitHub.

APIs RESTREST APIs

As APIS de ponto de extremidade de criação e de previsão estão disponíveis em APIs REST:Both authoring and prediction endpoint APIS are available from REST APIs:

TypeType VersãoVersion
CriaçãoAuthoring V2V2
visualização v3preview V3
PrevisãoPrediction V2V2
V2V3

Pontos de extremidade RESTREST Endpoints

O LUIS atualmente tem dois tipos de pontos de extremidade:LUIS currently has 2 types of endpoints:

  • criação no ponto de extremidade de treinamentoauthoring on the training endpoint
  • previsão de consulta no ponto de extremidade de tempo de execução.query prediction on the runtime endpoint.
FinalidadePurpose URLURL
V2 de criação no ponto de extremidade de treinamentoV2 Authoring on training endpoint https://{your-resource-name}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/
Criação de v3 no ponto de extremidade de treinamentoV3 Authoring on training endpoint https://{your-resource-name}.api.cognitive.microsoft.com/luis/authoring/v3.0-preview/apps/{appID}/
Versão de previsão v2-todas as previsões no ponto de extremidade de tempo de execuçãoV2 Prediction - all predictions on runtime endpoint 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 tempo de execuçãoV3 Prediction - versions prediction on runtime endpoint 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 tempo de execuçãoV3 Prediction - slot prediction on runtime endpoint 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.The following table explains the parameters, denoted with curly braces {}, in the previous table.

ParâmetroParameter FinalidadePurpose
your-resource-name Nome do recurso do AzureAzure resource name
q ou queryq or query texto de expressão enviado do aplicativo cliente como chat botutterance text sent from client application such as chat bot
version nome da versão de 10 caracteres10 character version name
slot production ou stagingproduction or staging

Parâmetros de cadeia de caracteres de consulta RESTREST query string parameters

Os parâmetros da cadeia de consulta da API v3 incluem:V3 API query string parameters include:

Parâmetro de consultaQuery parameter Nome do portal do LUISLUIS portal name TypeType VersãoVersion PadrãoDefault FinalidadePurpose
log Salvar logsSave logs booleanoboolean V2 & V3V2 & V3 falsefalse Armazenar consulta no arquivo de log.Store query in log file. O valor padrão é falso.Default value is false.
query - stringstring Somente V3V3 only Nenhum padrão-ele é necessário na solicitação GETNo default - it is required in the GET request Em v2, o expressão a ser previsto está no q parâmetro.In V2, the utterance to be predicted is in the q parameter.

No v3, a funcionalidade é passada no query parâmetro.In V3, the functionality is passed in the query parameter.
show-all-intents Incluir pontuações para todas as intençõesInclude scores for all intents booleanoboolean Somente V3V3 only falsefalse Retorne todas as intenções com a pontuação correspondente no objeto preditiva. retenções .Return all intents with the corresponding score in the prediction.intents object. As intenções são retornadas como objetos em um intents objeto pai.Intents are returned as objects in a parent intents object. Isso permite o acesso programático sem a necessidade de encontrar a intenção em uma matriz: prediction.intents.give .This allows programmatic access without needing to find the intent in an array: prediction.intents.give. Em v2, elas foram retornadas em uma matriz.In V2, these were returned in an array.
verbose Incluir mais detalhes de entidadesInclude more entities details booleanoboolean V2 & V3V2 & V3 falsefalse Em v2, quando definido como true, todas as intenções previstas foram retornadas.In V2, when set to true, all predicted intents were returned. Se você precisar de todas as intenções previstas, use o parâmetro v3 de show-all-intents .If you need all predicted intents, use the V3 param of show-all-intents.

No v3, esse parâmetro fornece apenas detalhes de metadados de entidade de previsão de entidade.In V3, this parameter only provides entity metadata details of entity prediction.
timezoneOffset - stringstring V2V2 - Fuso horário aplicado às entidades datetimeV2.Timezone applied to datetimeV2 entities.
datetimeReference - stringstring V3V3 - Fuso horário aplicado às entidades datetimeV2.Timezone applied to datetimeV2 entities. Substitui timezoneOffset de v2.Replaces timezoneOffset from V2.

Esquema de aplicativoApp schema

O esquema do aplicativo é importado e exportado em um .json .lu formato ou.The app schema is imported and exported in a .json or .lu format.

SDKs baseados em linguagemLanguage-based SDKs

LinguagemLanguage Documentação de referênciaReference documentation PacotePackage Inícios rápidosQuickstarts
C#C# CriaçãoAuthoring
PrevisãoPrediction
Criação de NuGetNuGet authoring
Previsão do NuGetNuGet prediction
CriaçãoAuthoring
Previsão de consultaQuery prediction
GoGo Criação e previsãoAuthoring and prediction SDKSDK
JavaJava Criação e previsãoAuthoring and prediction Criação do MavenMaven authoring
Previsão do MavenMaven prediction
JavaScriptJavaScript CriaçãoAuthoring
PrevisãoPrediction
Criação de NPMNPM authoring
Previsão de NPMNPM prediction
CriaçãoAuthoring
PrevisãoPrediction
PythonPython Criação e previsãoAuthoring and prediction PipPip CriaçãoAuthoring
PrevisãoPrediction

ContêineresContainers

O Reconhecimento vocal (LUIS) fornece um contêiner para fornecer versões locais e contidas do seu aplicativo.Language Understanding (LUIS) provides a container to provide on-premises and contained versions of your app.

Exportar e importar formatosExport and import formats

Reconhecimento vocal fornece a capacidade de gerenciar seu aplicativo e seus modelos em um formato JSON, o .LU formato (LUDown) e um pacote compactado para o reconhecimento vocal contêiner.Language Understanding provides the ability to manage your app and its models in a JSON format, the .LU (LUDown) format, and a compressed package for the Language Understanding container.

A importação e a exportação desses formatos estão disponíveis nas APIs e no portal do LUIS.Importing and exporting these formats is available from the APIs and from the LUIS portal. O portal fornece importação e exportação como parte da lista de aplicativos e lista de versões.The portal provides import and export as part of the Apps list and Versions list.

WorkshopWorkshops

Ferramentas de integração contínuaContinuous integration tools

Ferramentas do bot FrameworkBot Framework tools

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 do Azure.The bot framework is available as an SDK in a variety of languages and as a service using Azure Bot Service.

O bot Framework fornece várias ferramentas para ajudar com reconhecimento vocal, incluindo:Bot framework provides several tools to help with Language Understanding, including:

  • LUDown -criar modelos de reconhecimento de linguagem Luis usando arquivos de reduçãoLUDown - Build LUIS language understanding models using markdown files
  • CLI do Luis – criar e gerenciar seus aplicativos do Luis.aiLUIS CLI - Create and manage your LUIS.ai applications
  • Expedição-gerenciar aplicativos pai e filhoDispatch- manage parent and child apps
  • LUISGen – gere backup de classes C#/typescript para suas intenções e entidades de Luis.LUISGen - Auto generate backing C#/Typescript classes for your LUIS intents and entities.
  • Emulador do bot Framework -um aplicativo de área de trabalho que permite que os desenvolvedores de bot testem e depurem bots criados usando o SDK do bot FrameworkBot Framework emulator - a desktop application that allows bot developers to test and debug bots built using the Bot Framework SDK
  • Bot Framework Composer – uma ferramenta de desenvolvimento integrada para desenvolvedores e equipes multidisciplinares para criar bots e experiências de conversas com o Microsoft bot FrameworkBot Framework Composer - an integrated development tool for developers and multi-disciplinary teams to build bots and conversational experiences with the Microsoft Bot Framework
  • Exemplos do bot Framework – em #C, JavaScript, TypeScript e PythonBot Framework Samples - in #C, JavaScript, TypeScript, and Python

Próximas etapasNext steps