LUIS
O LUIS (serviço inteligente) de reconhecimento vocal dos Serviços Cognitivos do Azure permite que você entenda a linguagem contextualmente, para que seus aplicativos se comuniquem com as pessoas da maneira como elas falam.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Todas as regiões Power Automate |
| Aplicativos Lógicos | Standard | Todas as regiões de Aplicativos Lógicos |
| Power Apps | Standard | Todas as regiões Power Apps |
| Power Automate | Standard | Todas as regiões Power Automate |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
| Site | https://azure.microsoft.com/services/cognitive-services/language-understanding-intelligent-service/ |
Problemas e limitações conhecidos
Veja a seguir algumas limitações conhecidas do uso do conector luis
- Listas suspensas para id de aplicativo, versão do aplicativo, intenção desejada e pontos de extremidade de criação de chamada de entidade desejada e, portanto, exigem que uma chave de criação seja usada ao criar uma conexão. No caso de apenas uma chave de ponto de extremidade estar disponível, é necessário usar "Inserir valor personalizado" para inserir os valores de parâmetro correspondentes.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a visão geral dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave de API | secureString | Chave de API | Verdade |
| Ponto de extremidade de previsão | cadeia | Ponto de extremidade de previsão. Se não for especificado, ele será padronizado como https://westus.api.cognitive.microsoft.com. |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 1200 | 60 segundos |
Ações
| Obter entidade por tipo |
Para um determinado tipo de entidade, a operação retorna o melhor modelo de entidade correspondente do objeto de previsão do LUIS. |
| Obter previsão |
Considerando algum texto de entrada, essas operações retornam uma previsão com base em um modelo pré-treinado. O objeto de previsão retornado também pode ser usado como entrada para outras ações do LUIS. |
Obter entidade por tipo
Para um determinado tipo de entidade, a operação retorna o melhor modelo de entidade correspondente do objeto de previsão do LUIS.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do aplicativo
|
app-id | True | string |
ID do aplicativo treinado |
|
Entidade Desejada
|
desiredEntity | True | string |
A Entidade Desejada. |
|
Versão do aplicativo
|
versionId | string |
O nome da versão. O valor 0.1 será usado por padrão. |
|
|
luisPredictionObject
|
luisPredictionObject | True | string |
Retornos
Obter previsão
Considerando algum texto de entrada, essas operações retornam uma previsão com base em um modelo pré-treinado. O objeto de previsão retornado também pode ser usado como entrada para outras ações do LUIS.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do aplicativo
|
app-id | True | string |
ID do aplicativo treinado. |
|
Texto de enunciado
|
q | True | string |
Cadeia de caracteres para prever |
|
Intenção desejada
|
desiredIntent | string |
Intenção de pontuação superior desejada |
|
|
Versão do aplicativo
|
versionId | string |
O nome da versão. O valor 0.1 será usado por padrão. |
Retornos
- Corpo
- PredictResponse
Definições
PredictResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Previsão do LUIS
|
luisPrediciton | string |
Usado como entrada para outras ações do LUIS. |
|
É a intenção desejada
|
isDesiredIntent | boolean |
True se a intenção de pontuação superior corresponder à intenção desejada. |
|
Intenção desejada
|
desiredIntent | string |
Intenção desejada especificada como entrada, se houver. |
|
Texto de enunciado
|
query | string |
Cadeia de caracteres na qual a previsão é baseada. |
|
Nome
|
topScoringIntent.intent | string |
Nome do modelo de intenção. |
|
Score
|
topScoringIntent.score | float |
Porcentagem de confiança da previsão. |
|
Matriz de intenções
|
intents | array of object |
Lista de todas as intenções previstas. |
|
Nome da intenção
|
intents.intent | string |
Nome do modelo de intenção. |
|
Pontuação de intenção
|
intents.score | float |
Porcentagem de confiança da previsão. |
|
Matriz de entidades
|
entities | array of LuisPredictResponseEntity |
Lista de todas as entidades previstas. |
LuisPredictResponseEntity
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Valor da entidade
|
entity | string |
Valor do tipo de entidade correspondente. |
|
Tipo de entidade
|
type | string |
Nome do modelo de entidade. |
|
Pontuação da entidade
|
score | float |
Porcentagem de confiança da previsão. |
GetTopScoringMatchingEntityResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
entidade
|
entity | LuisPredictResponseEntityMinusType | |
|
entityMatchInfo
|
entityMatchInfo | EntityMatchInfo |
LuisPredictResponseEntityMinusType
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Valor da entidade
|
entity | string |
Valor do tipo de entidade correspondente. |
|
Pontuação da entidade
|
score | float |
Porcentagem de confiança da previsão. |
|
Resolução de entidade
|
resolution | string |
A resolução dessa entidade. Aplica-se apenas a entidades internas. |
EntityMatchInfo
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Entidade Desejada
|
desiredEntity | string |
Entidade desejada especificada como entrada, se houver. |
|
É correspondência de entidade
|
isEntityMatch | boolean |
True se a entidade específica foi encontrada. |
|
Contagem de correspondências de entidade
|
entityMatchCount | integer |
Número de entidades que correspondem ao tipo de entidade desejado. |