/// <summary> /// Tries to extract intent and entities from the input utterance and validates if the the current parameter should be updated or if a context switch is needed. /// </summary> /// <param name="service">Instance of Microsoft.Bot.Builder.Luis.ILuisService to use for extracting intent and entities.</param> /// <param name="action">The current action and context.</param> /// <param name="paramName">The parameter to try to assign.</param> /// <param name="paramValue">The parameter value to assign.</param> /// <param name="token">Cancellation Token.</param> /// <param name="entityExtractor">Optional: EntityExtractor to disambiguate multiple values into a single one.</param> /// <returns>Indicates if the Action Parameter was validated (and set) or a if a Context Switch should occur.</returns> public static async Task <QueryValueResult> QueryValueFromLuisAsync( ILuisService service, ILuisAction action, string paramName, object paramValue, CancellationToken token, Func <PropertyInfo, IEnumerable <EntityRecommendation>, EntityRecommendation> entityExtractor = null) { var originalValue = paramValue; if (service == null) { throw new ArgumentNullException(nameof(service)); } if (action == null) { throw new ArgumentNullException(nameof(action)); } if (string.IsNullOrWhiteSpace(paramName)) { throw new ArgumentNullException(nameof(paramName)); } if (paramValue == null) { throw new ArgumentNullException(nameof(paramValue)); } var result = await service.QueryAsync(paramValue.ToString(), token); var queryIntent = result.Intents.FirstOrDefault(); if (queryIntent != null && !Intents.None.Equals(queryIntent.Intent, StringComparison.InvariantCultureIgnoreCase)) { var newIntentName = default(string); var newAction = new LuisActionResolver(action.GetType().Assembly).ResolveActionFromLuisIntent(result, out newIntentName); if (newAction != null && !newAction.GetType().Equals(action.GetType())) { return(new QueryValueResult(false) { NewAction = newAction, NewIntent = newIntentName }); } } var properties = new List <PropertyInfo> { action.GetType().GetProperty(paramName, BindingFlags.Public | BindingFlags.Instance) }; if (!LuisActionResolver.AssignEntitiesToMembers(action, properties, result.Entities, entityExtractor)) { return(new QueryValueResult(AssignValue(action, properties.First(), originalValue))); } return(new QueryValueResult(true)); }
/// <summary> /// Returns an action based on the LUIS intent. /// </summary> /// <param name="luisResult">The LUIS Result containing intent and extracted entities.</param> /// <param name="intentName">The LUIS intent name.</param> /// <param name="intentEntities">The LUIS extracted entities.</param> /// <param name="entityExtractor">Optional: EntityExtractor to disambiguate multiple values into a single one.</param> /// <returns>The matched action plus its parameters filled with the extracted entities, or Null if no action was matched.</returns> public ILuisAction ResolveActionFromLuisIntent( LuisResult luisResult, out string intentName, out IList <EntityRecommendation> intentEntities, Func <PropertyInfo, IEnumerable <EntityRecommendation>, EntityRecommendation> entityExtractor = null) { intentEntities = default(IList <EntityRecommendation>); if (luisResult == null) { throw new ArgumentNullException(nameof(luisResult)); } // Has Intent? intentName = (luisResult.TopScoringIntent ?? luisResult.Intents?.MaxBy(i => i.Score ?? 0d)).Intent; if (string.IsNullOrWhiteSpace(intentName)) { return(null); } // Set out intent entities reference intentEntities = luisResult.Entities; // Get Actions that map to this intent var actionType = default(Type); if (!this.luisActions.TryGetValue(intentName, out actionType)) { return(null); } // Get the action instance and check if it implements ILuisAction var luisAction = Activator.CreateInstance(actionType) as ILuisAction; if (luisAction == null) { return(null); } // Try complete parameters from entities var properties = luisAction.GetType().GetProperties(BindingFlags.Public | BindingFlags.Instance); LuisActionResolver.AssignEntitiesToMembers(luisAction, properties, luisResult.Entities, entityExtractor); return(luisAction); }