Semantic Kernel: Package Previews, Graduations & Deprecations
We are excited to share a summary of recent updates and continuous clean-up efforts across the Semantic Kernel .NET codebase. These changes focus on improving maintainability, aligning with the latest APIs, and ensuring a consistent experience for users. Below you’ll find details on package graduations, deprecations, and a few other improvements.
Graduations
- Plugins.Core Package Graduated to Preview
The
Microsoft.SemanticKernel.Plugins.Core
package has been moved from “alpha” to “preview” status, reflecting its maturity and readiness for broader use. This change does not introduce new features but signals increased stability for those relying and building on these core plugins. - PromptTemplates.Liquid Package Graduated The Microsoft.SemanticKernel.Liquid prompt template package has also graduated, with package validation enabled to ensure quality and compatibility.
Spring Cleaning – Deprecations
- Markdown Package Deprecated
The
Microsoft.SemanticKernel.Markdown
package has been removed due to lack of usage. If you still use this package, please refer to the migration guide. - Math and Wait Plugins Removed The Math and Wait plugins, which were part of the project since its early days, have been removed as they are no longer relevant.
- OpenAI and Handlebars Planners Deprecated
The
Microsoft.SemanticKernel.Planners.Handlebars
andMicrosoft.SemanticKernel.Planners.OpenAI
planners were deprecated in favor of more reliable mechanisms such as function calling, and the decision was made to discontinue their availability on NuGet packages. For migration details, see the stepwise planner migration guide.
Improvements & Updates
- Plugins.Core Package API Is No Longer Experimental The experimental attribute has been removed from the Plugins.Core package API, reflecting its stable usage in production environments.
- Stable OpenAPI API The experimental attribute was also removed from the stable OpenAPI API, and package validation was enabled to ensure ongoing reliability.
- SessionsPythonPlugin Updates
- API Migration
The plugin was migrated to the latest Azure code interpreter API version (
2024-10-02-preview
). This required some breaking changes to the plugin public API surface. See the migration guide for details. - Structured Results Python code execution results are now represented by a dedicated type, allowing for more structured handling and easier integration with other components.
- Request Handling The plugin now propagates cancellation tokens through all kernel functions, ensuring that operations can be gracefully terminated in response to user requests or timeouts, thereby improving resource management and application responsiveness.
- Domain Control Added the ability to control which domains requests can be sent to, increasing security and configurability.
- HTTP Consistency
Refactored to use
SendWithSuccessCheckAsync
extension methods for HTTP requests, aligning with other Semantic Kernel components. - Code Clean-up Common functionality was consolidated to reduce duplication, and minor logging and readability improvements were made.
- Integration Tests Added integration tests for the plugin to ensure its reliability, and early detection of issues.
- API Migration
The plugin was migrated to the latest Azure code interpreter API version (
These updates are part of our ongoing effort to keep the Semantic Kernel codebase clean, stable, and easy to use. For more information on migrating from deprecated or updated components, please refer to the linked migration guides.
If you have feedback or questions, please join the discussion on our GitHub repository.
0 comments
Be the first to start the discussion.