Tentativas em seu aplicativo LUISIntents in your LUIS app

Uma intenção representa uma tarefa ou ação que o usuário deseja executar.An intent represents a task or action the user wants to perform. É uma finalidade ou meta expressa na declaração de um usuário.It is a purpose or goal expressed in a user's utterance.

Defina um conjunto de intenções que corresponda às ações que os usuários desejem executar em seu aplicativo.Define a set of intents that corresponds to actions users want to take in your application. Por exemplo, um aplicativo de viagem define várias intenções:For example, a travel app defines several intents:

Intenções do aplicativo de viagemTravel app intents Exemplo de enunciadosExample utterances
BookFlightBookFlight "Reserve um voo para mim para o Rio na semana que vem""Book me a flight to Rio next week"
"Coloque-me num voo para o Rio no dia 24""Fly me to Rio on the 24th"
"Preciso de uma passagem de avião no próximo domingo para o Rio de Janeiro""I need a plane ticket next Sunday to Rio de Janeiro"
SaudaçãoGreeting "Oi""Hi"
"Olá""Hello"
"Bom dia""Good morning"
CheckWeatherCheckWeather "Como está o clima em Boston?""What's the weather like in Boston?"
"Mostre-me a previsão para este fim de semana""Show me the forecast for this weekend"
NenhumNone "Encontre uma receita de biscoitos para mim""Get me a cookie recipe"
"Os Lakers venceram?""Did the Lakers win?"

Todos os aplicativos vêm com a intenção predefinida, "None", que é a tentativa de fallback.All applications come with the predefined intent, "None", which is the fallback intent.

Domínios predefinidos fornecem intençõesPrebuilt domains provide intents

Além de tentativas que você define, você pode usar tentativas predefinidas de um dos domínios predefinidos.In addition to intents that you define, you can use prebuilt intents from one of the prebuilt domains.

Retornar pontuações de todas as intençõesReturn all intents' scores

Atribua uma declaração a uma única intenção.You assign an utterance to a single intent. Quando LUIS recebe um expressão no ponto de extremidade, por padrão, ele retorna a principal intenção desse expressão.When LUIS receives an utterance on the endpoint, by default, it returns the top intent for that utterance.

Se você quiser as pontuações para todas as intenções para o expressão, poderá fornecer um sinalizador na cadeia de caracteres de consulta da API de previsão.If you want the scores for all intents for the utterance, you can provide a flag on the query string of the prediction API.

Versão da API de previsãoPrediction API version SinalizadorFlag
V2V2 verbose=true
V3V3 show-all-intents=true

Intenção comparada com a entidadeIntent compared to entity

A intenção representa a ação que o aplicativo deve executar para o usuário e é baseado em todo o expressão.The intent represents action the application should take for the user and is based on the entire utterance. Uma declaração pode ter apenas uma intenção de pontuação principal, mas pode ter muitas entidades.An utterance can have only one top scoring intent but it can have many entities.

Crie uma intenção quando a intenção do usuário disparar uma ação em seu aplicativo cliente, como uma chamada à função checkweather().Create an intent when the user's intention would trigger an action in your client application, like a call to the checkweather() function. Em seguida, crie entidades para representar os parâmetros necessários para executar a ação.Then create entities to represent parameters required to execute the action.

IntencionalIntent EntidadeEntity Exemplo de enunciadoExample utterance
CheckWeatherCheckWeather { "type": "location", "entity": "seattle" }{ "type": "location", "entity": "seattle" }
{ "type": "builtin.datetimeV2.date","entity": "tomorrow","resolution":"2018-05-23" }{ "type": "builtin.datetimeV2.date","entity": "tomorrow","resolution":"2018-05-23" }
Qual é o clima como em Seattle tomorrow?What's the weather like in Seattle tomorrow?
CheckWeatherCheckWeather { "type": "date_range", "entity": "this weekend" }{ "type": "date_range", "entity": "this weekend" } Mostre-me a previsão para this weekendShow me the forecast for this weekend

Intenções de domínio predefinidasPrebuilt domain intents

Domínios pré-criados fornecem intenções com declarações.Prebuilt domains provide intents with utterances.

Intenção NoneNone intent

A intenção None é criada, mas deixada vazia de propósito.The None intent is created but left empty on purpose. A intenção None é uma intenção necessária e não pode ser excluída nem renomeada.The None intent is a required intent and can't be deleted or renamed. Preencha-a com declarações que estejam fora de seu domínio.Fill it with utterances that are outside of your domain.

A intenção None é a intenção de fallback, importante em todos os aplicativos e deve ter 10% do total de declarações.The None intent is the fallback intent, important in every app, and should have 10% of the total utterances. Ela é usada para ensinar ao LUIS declarações que não são importantes no domínio de aplicativo (área de assunto).It is used to teach LUIS utterances that are not important in the app domain (subject area). Se você não adicionar nenhuma declaração para a intenção None, o LUIS forçará uma declaração que está fora do domínio para uma das intenções do domínio.If you do not add any utterances for the None intent, LUIS forces an utterance that is outside the domain into one of the domain intents. Isso distorcerá as pontuações de previsão ensinando ao LUIS a intenção incorreta para a declaração.This will skew the prediction scores by teaching LUIS the wrong intent for the utterance.

Quando um expressão é previsto como a intenção None, o aplicativo cliente pode fazer mais perguntas ou fornecer um menu para direcionar o usuário a opções válidas.When an utterance is predicted as the None intent, the client application can ask more questions or provide a menu to direct the user to valid choices.

Intenções negativasNegative intentions

Se desejar determinar intenções negativas e positivas, como "Eu quero um carro" e "Eu não quero um carro", será possível criar duas intenções (uma positiva e uma negativa) e adicionar declarações adequadas para cada uma.If you want to determine negative and positive intentions, such as "I want a car" and "I don't want a car", you can create two intents (one positive, and one negative) and add appropriate utterances for each. Ou é possível criar uma única intenção e marcar os dois termos positivos e negativos diferentes como uma entidade.Or you can create a single intent and mark the two different positive and negative terms as an entity.

Tentativas e padrõesIntents and patterns

Se você tiver um exemplo de declarações, que pode ser definido em parte ou inteiro como uma expressão regular, considere usar a entidade de expressão regular emparelhada com um padrão.If you have example utterances, which can be defined in part or whole as a regular expression, consider using the regular expression entity paired with a pattern.

O uso de uma entidade de expressão regular garante a extração de dados para que o padrão seja correspondido.Using a regular expression entity guarantees the data extraction so that the pattern is matched. O padrão de correspondência garante que uma intenção exata seja retornada.The pattern matching guarantees an exact intent is returned.

Equilíbrio de intençõesIntent balance

As intenções do domínio de aplicativo devem ter um equilíbrio de declarações em cada intenção.The app domain intents should have a balance of utterances across each intent. Não tenha uma intenção com 10 declarações e outra intenção com 500 declarações.Do not have one intent with 10 utterances and another intent with 500 utterances. Isso não está equilibrado.This is not balanced. Se você tiver essa situação, examine a intenção com 500 declarações para ver se muitas intenções podem ser reorganizadas em um padrão.If you have this situation, review the intent with 500 utterances to see if many of the intents can be reorganized into a pattern.

A intenção None não está incluída no equilíbrio.The None intent is not included in the balance. A intenção deve conter 10% das declarações totais no aplicativo.That intent should contain 10% of the total utterances in the app.

Limites de intençãoIntent limits

Examine os limites para entender a quantidade de intenções que você pode adicionar a um modelo.Review limits to understand how many intents you can add to a model.

Se precisar de mais do que o número máximo de intençõesIf you need more than the maximum number of intents

Primeiro, considere se o sistema está usando um número excessivo de intenções.First, consider whether your system is using too many intents.

Várias intenções poderão ser combinadas em uma única intenção com entidadesCan multiple intents be combined into single intent with entities

Intenções muito semelhantes poderão dificultar sua diferenciação pelo LUIS.Intents that are too similar can make it more difficult for LUIS to distinguish between them. As intenções devem ser variadas o suficiente para capturar as principais tarefas que o usuário está solicitando, mas elas não precisam capturar todo caminho que seu código usa.Intents should be varied enough to capture the main tasks that the user is asking for, but they don't need to capture every path your code takes. Por exemplo, BookFlight e FlightCustomerService podem ser intenções separadas em um aplicativo de viagem, mas BookInternationalFlight e BookDomesticFlight são semelhantes demais.For example, BookFlight and FlightCustomerService might be separate intents in a travel app, but BookInternationalFlight and BookDomesticFlight are too similar. Se o sistema precisar diferenciá-las, use entidades ou outra lógica, em vez de intenções.If your system needs to distinguish them, use entities or other logic rather than intents.

Modelo de DispatcherDispatcher model

Saiba como combinar aplicativos LUIS e QnA Maker com o modelo de expedição.Learn more about combining LUIS and QnA maker apps with the dispatch model.

Solicite ajuda para aplicativos com quantidades significativas de intençõesRequest help for apps with significant number of intents

Se a redução do número de intenções ou a divisão das suas intenções em vários aplicativos não funcionar para você, contate o suporte.If reducing the number of intents or dividing your intents into multiple apps doesn't work for you, contact support. Se a assinatura do Azure incluir serviços de suporte, contate o suporte técnico do Azure.If your Azure subscription includes support services, contact Azure technical support.

Próximas etapasNext steps