![](\"https:\/\/devblogs.microsoft.com\/semantic-kernel\/wp-content\/uploads\/sites\/78\/2023\/03\/skpatternlarge-1536x128.png\")
<\/p>\n<\/p>\n
Semantic Kernel (SK) is a lightweight SDK that lets you mix conventional programming languages, like C# and Python, with the latest in Large Language Model (LLM) AI \u201cprompts\u201d with prompt templating, chaining, and planning capabilities.\u00a0 Its Planner<\/a> Skill allows users to create and execute plans based on semantic queries. Recently, the addition of embeddings exposed via In this blog post, we will discuss how integrating embeddings into the Planner Skill to determine related skills enhances its usability and functionality.<\/p>\n When you create a Plan with Planner Skill<\/a> today, it uses all registered functions to compose a natural language manual. However, when the number of functions and skills grows, it can hinder the quality of the generated results. By enabling semantic filtering, Plan creation will use Semantic Memory to store embeddings for registered functions. It will then search the Semantic Memory Store based on the Plan goal to filter what functions are used when generating the natural language manual.<\/p>\n Additionally, users can limit the number of functions returned from semantic filtering, specify skills and function to exclude and specify functions to include regardless of their semantic relevance.<\/em><\/p>\n First, to support Semantic Filtering with Planner Skill<\/a>, you need to register an embeddings backend and include an Then, to enable Semantic Filtering when using the Planner Skill, you simply need to supply Lastly, the other configuration values can be set like this:<\/p>\n So, there you have it! With the integration of embeddings and Semantic Memory, the Planner Skill in the Semantic Kernel just got even cooler. It’s like giving your conversational agent a superpower – the ability to understand context and generate more accurate plans. Follow along for a closer look at how the Planner does this using Semantic Memory.<\/p>\n First, all registered functions need to be saved to memory. When Then, we can use the goal text as a semantic query against the This is just one basic example of how embeddings and semantic searching can bring LLM capabilities into applications using the Planner. As the Semantic Kernel evolves in its Alpha stage, we’ll prioritize other methods of using embeddings for plan creation that will be even more powerful.<\/p>\n Read the documentation about the Planner<\/a><\/p>\nSemanticTextMemory<\/code> has made the Planner Skill even more versatile.<\/p>\nWhat It Does<\/strong><\/h2>\n
Enable Semantic Filtering with Planner Skill<\/strong><\/h3>\n
IMemoryStore<\/code> implementation with the kernel used for Planning. For example:<\/p>\nvar kernel = new KernelBuilder()\r\n\u00a0 \u00a0 .Configure(\r\n\u00a0 \u00a0 \u00a0 \u00a0 config =>\r\n\u00a0 \u00a0 \u00a0 \u00a0 {\r\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 config.AddAzureOpenAITextCompletion(...);\r\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 config.AddAzureOpenAIEmbeddingGeneration(...);<\/strong>\r\n\u00a0 \u00a0 \u00a0 \u00a0 })\r\n\u00a0 \u00a0 .WithMemoryStorage(new VolatileMemoryStore())<\/strong>\r\n\u00a0 \u00a0 .Build();<\/code><\/pre>\nContextVariable<\/code> for setting a relevance threshold when creating a plan. When you do this, upon creation of a plan using the Planner Skill, the IMemoryStore<\/code> implementation associated with the kernel instance will be used to search for relevant functions.<\/p>\nvar planner = kernel.ImportSkill(new PlannerSkill(kernel), \"planning\");\r\n\r\n\/\/ import any other skills or functions ....\r\n\r\nvar context = new ContextVariables(\"Create a book with 3 chapters about a group of kids in a club called 'The Thinking Caps.'\");\r\n\r\n\/\/ Set the RelevancyThreshold to enable semantic filtering\r\ncontext.Set(PlannerSkill.Parameters.RelevancyThreshold, \"0.78\");\r\n\r\nvar results = await kernel.RunAsync(context, planner[\"CreatePlan\"]);<\/code><\/pre>\n\/\/ To limit the number of relevant functions to include\r\ncontext.Set(PlannerSkill.Parameters.MaxRelevantFunctions, \"5\");\r\n\r\n\/\/ To exclude certain functions or entire Skills from being included in plan creation requests\r\ncontext.Set(PlannerSkill.Parameters.ExcludedFunctions, \"NovelChapter\");\r\ncontext.Set(PlannerSkill.Parameters.ExcludedSkills, \"email\");\r\n\r\n\/\/ Or to ensure specific functions are included in plan creation requests regardless of semantic filtering\r\ncontext.Set(PlannerSkill.Parameters.IncludedFunctions, \"DadJoke\");<\/code><\/pre>\nHow It Works<\/strong><\/h3>\n
CreatePlan<\/code> is called, we use the SKContext<\/code> as context to retrieve pointer to the Memory<\/code> instance and call SaveInformationAsync<\/code> with known registered functions in the SkillCollection<\/code> on theSKContext<\/code>.<\/p>\n\/\/ Loop through available functions and save them to memory.\r\nforeach (var function in availableFunctions)\r\n{\r\n var functionName = function.ToFullyQualifiedName();\r\n var key = string.IsNullOrEmpty(function.Description) ? functionName : function.Description;\r\n\r\n await context.Memory.SaveInformationAsync(PlannerMemoryCollectionName, key, functionName, function.ToManualString(),\r\n context.CancellationToken);\r\n}<\/code><\/pre>\nMemory<\/code> in the SKContext<\/code>.<\/p>\n\/\/ Search for functions that match the semantic query.\r\nvar memories = context.Memory.SearchAsync(PlannerMemoryCollectionName, semanticQuery, config.MaxRelevantFunctions, config.RelevancyThreshold.Value,\r\n context.CancellationToken);<\/code><\/pre>\nNext steps<\/strong><\/h2>\n
![](\"https:\/\/devblogs.microsoft.com\/semantic-kernel\/wp-content\/uploads\/sites\/78\/2023\/03\/skpatternsmallbw.png\")
<\/p>\n","protected":false},"excerpt":{"rendered":"