Semantic Kernel: Practical Recipes and Code Examples
Cross-language Semantic Kernel recipes — Q&A, structured summaries, translation, plugins, RAG, multi-agent debate and tool-using agents, in Python and C#.
Targets
semantic-kernel1.45.0 (Python) andMicrosoft.SemanticKernel1.81.0 (.NET), checked 2026-11-19. Each recipe shows both languages briefly; fuller versions are in the Python recipes and .NET recipes. Model names are examples.
All Python snippets assume:
from semantic_kernel import Kernelfrom semantic_kernel.connectors.ai.open_ai import OpenAIChatCompletion, OpenAIChatPromptExecutionSettingsfrom semantic_kernel.functions import KernelArguments
kernel = Kernel()kernel.add_service(OpenAIChatCompletion(ai_model_id="gpt-6-luna")) # OPENAI_API_KEY from envAll C# snippets assume:
using System.ComponentModel;using Microsoft.SemanticKernel;using Microsoft.SemanticKernel.Agents;using Microsoft.SemanticKernel.Connectors.OpenAI;
var builder = Kernel.CreateBuilder();builder.AddOpenAIChatCompletion("gpt-6-luna", Environment.GetEnvironmentVariable("OPENAI_API_KEY")!);Kernel kernel = builder.Build();Table of contents
Section titled “Table of contents”- Question answering
- Structured summary
- Translation with a reusable prompt function
- Calculator plugin with function calling
- RAG over your documents
- Two-agent debate
- Reason-and-act agent
1. Question answering
Section titled “1. Question answering”answer = await kernel.invoke_prompt( "Answer concisely; say if you are unsure.\n\nQuestion: {{$q}}", arguments=KernelArguments(q="What is Semantic Kernel?"),)print(answer)var answer = await kernel.InvokePromptAsync( "Answer concisely; say if you are unsure.\n\nQuestion: {{$q}}", new() { ["q"] = "What is Semantic Kernel?" });Console.WriteLine(answer);2. Structured summary
Section titled “2. Structured summary”from pydantic import BaseModel
class Summary(BaseModel): title: str bullets: list[str]
result = await kernel.invoke_prompt( "Summarise:\n{{$text}}", arguments=KernelArguments(text=article, settings=OpenAIChatPromptExecutionSettings(response_format=Summary)),)summary = Summary.model_validate_json(str(result))public sealed record Summary(string Title, string[] Bullets);
var settings = new OpenAIPromptExecutionSettings { ResponseFormat = typeof(Summary) };var result = await kernel.InvokePromptAsync("Summarise:\n{{$text}}", new(settings) { ["text"] = article });var summary = System.Text.Json.JsonSerializer.Deserialize<Summary>(result.ToString());3. Translation with a reusable prompt function
Section titled “3. Translation with a reusable prompt function”translate = kernel.add_function( plugin_name="lang", function_name="translate", prompt="Translate into {{$language}}. Keep formatting. Return only the translation.\n\n{{$text}}",)french = await kernel.invoke(translate, KernelArguments(text="Good morning", language="French"))var translate = kernel.CreateFunctionFromPrompt( "Translate into {{$language}}. Keep formatting. Return only the translation.\n\n{{$text}}", functionName: "translate");var french = await kernel.InvokeAsync(translate, new() { ["text"] = "Good morning", ["language"] = "French" });Registering the function in a plugin (plugin_name="lang" / kernel.Plugins.AddFromFunctions("lang", [translate])) also lets agents call it as a tool.
4. Calculator plugin with function calling
Section titled “4. Calculator plugin with function calling”from typing import Annotatedfrom semantic_kernel.connectors.ai.function_choice_behavior import FunctionChoiceBehaviorfrom semantic_kernel.functions import kernel_function
class Calculator: @kernel_function(description="Add two numbers.") def add(self, a: float, b: float) -> float: return a + b
@kernel_function(description="Multiply two numbers.") def multiply(self, a: float, b: float) -> float: return a * b
@kernel_function(description="Raise a number to a power.") def power(self, base: float, exponent: Annotated[float, "The exponent"]) -> float: return base ** exponent
kernel.add_plugin(Calculator(), plugin_name="calc")settings = OpenAIChatPromptExecutionSettings(function_choice_behavior=FunctionChoiceBehavior.Auto())print(await kernel.invoke_prompt("What is (2^10) + 24?", arguments=KernelArguments(settings=settings)))public sealed class Calculator{ [KernelFunction, Description("Add two numbers.")] public double Add(double a, double b) => a + b;
[KernelFunction, Description("Multiply two numbers.")] public double Multiply(double a, double b) => a * b;
[KernelFunction, Description("Raise a number to a power.")] public double Power(double @base, [Description("The exponent")] double exponent) => Math.Pow(@base, exponent);}
kernel.ImportPluginFromType<Calculator>("calc");var settings = new OpenAIPromptExecutionSettings { FunctionChoiceBehavior = FunctionChoiceBehavior.Auto() };Console.WriteLine(await kernel.InvokePromptAsync("What is (2^10) + 24?", new(settings)));Arithmetic is a good first tool precisely because models are unreliable at it — the result shows clearly whether the tool was used. Recipe 7 reuses the plugin for a compound-interest question (1000 × 1.05¹⁰), which needs both power and multiply.
5. RAG over your documents
Section titled “5. RAG over your documents”The recipe is the same in both languages: define a record type, put it in a vector store collection with an embedding generator, expose search as a function, and let an agent call it.
- Python:
@vectorstoremodelrecord +InMemoryCollection(record_type=..., embedding_generator=...)+collection.create_search_function(...)— see Python recipe 4. - C#:
[VectorStoreKey]/[VectorStoreData]/[VectorStoreVector]record +InMemoryVectorStore(CommunityToolkit.VectorData.InMemory) +VectorStoreTextSearch<T>— see .NET recipe 5.
Production stores (Azure AI Search, Qdrant, Postgres, Redis …) are drop-in replacements for the in-memory collection.
6. Two-agent debate
Section titled “6. Two-agent debate”A group chat between two agents with a round limit:
from semantic_kernel.agents import ChatCompletionAgent, GroupChatOrchestration, RoundRobinGroupChatManagerfrom semantic_kernel.agents.runtime import InProcessRuntime
svc = OpenAIChatCompletion(ai_model_id="gpt-6-luna")pro = ChatCompletionAgent(name="Pro", description="Argues for", service=svc, instructions="Argue FOR the motion in under 80 words. Rebut the last point.")con = ChatCompletionAgent(name="Con", description="Argues against", service=svc, instructions="Argue AGAINST the motion in under 80 words. Rebut the last point.")
debate = GroupChatOrchestration(members=[pro, con], manager=RoundRobinGroupChatManager(max_rounds=4), agent_response_callback=lambda m: print(f"{m.name}: {m.content}\n"))runtime = InProcessRuntime(); runtime.start()result = await debate.invoke(task="Motion: remote work is better for software teams.", runtime=runtime)await result.get(timeout=300)await runtime.stop_when_idle()using Microsoft.SemanticKernel.Agents;using Microsoft.SemanticKernel.Agents.Orchestration.GroupChat;using Microsoft.SemanticKernel.Agents.Runtime.InProcess;
ChatCompletionAgent pro = new() { Name = "Pro", Description = "Argues for", Kernel = kernel, Instructions = "Argue FOR the motion in under 80 words. Rebut the last point." };ChatCompletionAgent con = new() { Name = "Con", Description = "Argues against", Kernel = kernel, Instructions = "Argue AGAINST the motion in under 80 words. Rebut the last point." };
GroupChatOrchestration debate = new(new RoundRobinGroupChatManager { MaximumInvocationCount = 4 }, pro, con){ ResponseCallback = m => { Console.WriteLine($"{m.AuthorName}: {m.Content}\n"); return ValueTask.CompletedTask; },};InProcessRuntime runtime = new();await runtime.StartAsync();var result = await debate.InvokeAsync("Motion: remote work is better for software teams.", runtime);await result.GetValueAsync(TimeSpan.FromMinutes(5));await runtime.RunUntilIdleAsync();(.NET orchestrations are in the -preview packages Microsoft.SemanticKernel.Agents.Orchestration and .Agents.Runtime.InProcess, and need SKEXP0110 suppressed.)
7. Reason-and-act agent
Section titled “7. Reason-and-act agent”There is no special “ReAct agent” class: a ChatCompletionAgent with plugins and automatic function calling already alternates between reasoning and tool use. Ask it to show its plan if you want the trace:
from semantic_kernel.agents import ChatCompletionAgent
agent = ChatCompletionAgent( service=OpenAIChatCompletion(ai_model_id="gpt-6-luna"), name="Analyst", instructions="Before each tool call, state in one line what you are checking and why.", plugins=[Calculator()],)
async def on_step(message): for item in message.items: print("step:", type(item).__name__, getattr(item, "name", ""))
async for reply in agent.invoke(messages="If I invest 1000 at 5% for 10 years, what do I end up with?", on_intermediate_message=on_step): print(reply.content)ChatCompletionAgent agent = new(){ Name = "Analyst", Instructions = "Before each tool call, state in one line what you are checking and why.", Kernel = kernel, // with the Calculator plugin imported Arguments = new KernelArguments(new OpenAIPromptExecutionSettings { FunctionChoiceBehavior = FunctionChoiceBehavior.Auto() }),};
var options = new AgentInvokeOptions{ OnIntermediateMessage = m => { Console.WriteLine($"step: {m.Items.Count} item(s)"); return Task.CompletedTask; },};await foreach (var reply in agent.InvokeAsync("If I invest 1000 at 5% for 10 years, what do I end up with?", options: options)) Console.WriteLine(reply.Message.Content);Revision history
Section titled “Revision history”| Date | Version | Changes |
|---|---|---|
| 2026-10-21 | Py 1.45.0 / .NET 1.81.0 | multiply added to the calculator so recipe 7 can be answered with tools; missing C# usings added. |
| 2026-10-21 | Py 1.45.0 / .NET 1.81.0 | Rewritten. Previous recipes used pre-1.0 Python APIs (invoke_async, create_function_from_prompt, model_id=), the legacy memory-store API (VolatileMemoryStore, ISemanticTextMemory, WithMemoryStore) and placeholder API keys in code. All snippets now use current APIs; versions read from the site’s version registry. |