{"id":1551,"date":"2023-11-13T16:15:03","date_gmt":"2023-11-14T00:15:03","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/semantic-kernel\/?p=1551"},"modified":"2024-01-10T15:09:33","modified_gmt":"2024-01-10T23:09:33","slug":"introducing-v1-0-0-beta6-for-the-net-semantic-kernel-sdk","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/agent-framework\/introducing-v1-0-0-beta6-for-the-net-semantic-kernel-sdk\/","title":{"rendered":"Introducing v1.0.0 Beta6 for the .NET Semantic Kernel SDK"},"content":{"rendered":"

Semantic Kernel v1.0<\/a> has shipped and the contents of this blog entry is now out of date.<\/p><\/blockquote>\n

The Semantic Kernel team continues to make improvements to our beta release of the .NET library. Our sixth Beta release<\/a> is the most jam packed one so far, so we wanted to take the opportunity to share everything new inside of it.<\/p>\n

As a reminder, if you want visibility into our full<\/em> plans for v1 of Semantic Kernel, please check out this blog post<\/a>. Additionally, if you\u2019re needing to update from pre-Beta, we recommend our first Beta blog post<\/a> where we outline some of the initial breaking changes.<\/p>\n

Semantic functions are getting way<\/em> more powerful.<\/h2>\n

With this release, we\u2019ve made to substantial improvements to how semantic functions work. We now have Handlebars support out-of-the-box and<\/em> you can start authoring semantic functions that take full control of the chat completion API.<\/p>\n

Initial Handlebars support (with extensibility for more!)<\/h3>\n

With Semantic Kernel, we already provided an out-of-the-box template engine. We heard from the community, however, that this template engine was too limiting, so with Beta6 we\u2019re now adding support for Handlebars.<\/p>\n

var templateFactory = new HandlebarsPromptTemplateFactory();\r\nvar handlebarsPrompt = \"Hello AI, my name is {{name}}. What is the origin of my name?\";\r\n\r\n\r\n\/\/ Create the semantic function with Handlebars\r\nvar skfunction = kernel.CreateSemanticFunction(\r\n    promptTemplate: prompt,\r\n    functionName: \"MyFunction\",\r\n    promptTemplateConfig: new PromptTemplateConfig()\r\n    {\r\n        TemplateFormat = templateFormat\r\n    },\r\n    promptTemplateFactory:\r\n);\r\n\r\n\/\/ Create your variables\r\nvar variables = new ContextVariables()\r\n{\r\n    { \"name\", \"Bob\" }\r\n};\r\n\r\n\/\/ Run your semantic function\r\nvar result = await kernel.RunAsync(skfunction, variables);<\/pre>\n
If you have a different templating language that you favor (e.g., Jinja2, Liquid, etc.), we also used this release to update how you can author and use templating languages. You can follow the patterns we set while creating our new HandlebarsPromptTemplateFactory<\/a> class to add support for any<\/em> template language. Afterwards, you can use it to create new semantic functions.<\/p>\n
Lastly, our approach to adding template engines also allows you to use prompts with multiple different template engines all in the same kernel! No need to refactor prompts that you\u2019ve collected from other prompt repositories to bring them into your AI application. To see an example of this in action, check out example 64 in our kernel syntax examples<\/a>.<\/p>\n
Chat role support in semantic functions<\/h3>\n
One of the biggest limiting factors of semantic functions was that you couldn\u2019t leverage different messages or roles while using chat completion APIs. This changes with the introduction of a new prompt syntax that we\u2019re introducing that will work across all<\/em> model types.<\/p>\n
We\u2019re starting today with just the new <message \/> tag. With it, you\u2019ll be able to create prompts like the following:<\/p>\n
<message role=\"user\">Can you tell me about Seattle?<\/message>\r\n<message role=\"system\">Respond to the user request in JSON<\/message><\/code><\/pre>\n
This is powerful, because it means you can quickly and easily author prompts with system messages at the top and<\/em> bottom of your prompt to better control the behavior of the AI. Behind the scenes, we\u2019ll parse these tags and turn them into a chat history object for you.<\/p>\n
In the near future, we\u2019ll also use these tags to support multi-modal applications. For example, if you wanted to add an image to a message, you\u2019d be able to use the <img\/> tag straight from HTML! The same will be true for other file types like audio and video.<\/p>\n
<message role=\"user\">Can you describe this image?<img src=\".\/cat.png\"\/><\/message><\/code><\/pre>\n
We now have full OpenAI function calling support.<\/h2>\n
Semantic Kernel has had function calling support with Open AI for awhile, but it wasn\u2019t possible to add the results of a function call back into the chat history to facilitate long running conversations. With Beta6, that is now possible with the new AddFunctionMessage method on Chat History.<\/p>\n
To see function calling working end-to-end, we recommend checking out example 59 in our kernel syntax examples<\/a>. In it, we highlight the following:<\/p>\n
    \n
  1. \n
      \n
    1. Use a kernel to automatically add functions to the OpenAI function calling request.<\/li>\n
    2. Take the response from OpenAI to invoke a function with the kernel.<\/li>\n
    3. Use the results of the function to create a new function message in the chat history.<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n
      To make function calling even easier, we\u2019re currently updating our implementation of stepwise planner to leverage it. Keep an eye out for it in out next release!<\/p>\n
      Monitor your functions with hooks.<\/h2>\n
      For enterprises, it\u2019s extremely important to know what your AI applications are doing every step of the process. To provide this visibility, we\u2019ve introduced pre- and post-hooks that run for every SKFunction, which allows you to do the following things:<\/p>\n