Files
microsoft--semantic-kernel/dotnet/samples/LearnResources/MicrosoftLearn/SerializingPrompts.cs
T
wehub-resource-sync b957a53def
CodeQL / Analyze (csharp) (push) Has been cancelled
CodeQL / Analyze (python) (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 13:21:23 +08:00

126 lines
4.3 KiB
C#

// Copyright (c) Microsoft. All rights reserved.
using System.Reflection;
using Microsoft.SemanticKernel;
using Microsoft.SemanticKernel.ChatCompletion;
using Microsoft.SemanticKernel.Plugins.Core;
using Microsoft.SemanticKernel.PromptTemplates.Handlebars;
namespace Examples;
/// <summary>
/// This example demonstrates how to serialize prompts as described at
/// https://learn.microsoft.com/semantic-kernel/prompts/saving-prompts-as-files
/// </summary>
public class SerializingPrompts(ITestOutputHelper output) : LearnBaseTest([
"Can you send an approval to the marketing team?",
"That is all, thanks."], output)
{
[Fact]
public async Task RunAsync()
{
Console.WriteLine("======== Serializing Prompts ========");
string? endpoint = TestConfiguration.AzureOpenAI.Endpoint;
string? modelId = TestConfiguration.AzureOpenAI.ChatModelId;
string? apiKey = TestConfiguration.AzureOpenAI.ApiKey;
if (endpoint is null || modelId is null || apiKey is null)
{
Console.WriteLine("Azure OpenAI credentials not found. Skipping example.");
return;
}
var builder = Kernel.CreateBuilder()
.AddAzureOpenAIChatCompletion(modelId, endpoint, apiKey);
builder.Plugins.AddFromType<ConversationSummaryPlugin>();
Kernel kernel = builder.Build();
// Load prompts
var prompts = kernel.CreatePluginFromPromptDirectory("./../../../Plugins/Prompts");
// Load prompt from YAML
using StreamReader reader = new(Assembly.GetExecutingAssembly().GetManifestResourceStream("Resources.getIntent.prompt.yaml")!);
KernelFunction getIntent = kernel.CreateFunctionFromPromptYaml(
await reader.ReadToEndAsync(),
promptTemplateFactory: new HandlebarsPromptTemplateFactory()
);
// Create choices
List<string> choices = ["ContinueConversation", "EndConversation"];
// Create few-shot examples
List<ChatHistory> fewShotExamples =
[
[
new ChatMessageContent(AuthorRole.User, "Can you send a very quick approval to the marketing team?"),
new ChatMessageContent(AuthorRole.System, "Intent:"),
new ChatMessageContent(AuthorRole.Assistant, "ContinueConversation")
],
[
new ChatMessageContent(AuthorRole.User, "Can you send the full update to the marketing team?"),
new ChatMessageContent(AuthorRole.System, "Intent:"),
new ChatMessageContent(AuthorRole.Assistant, "EndConversation")
]
];
// Create chat history
ChatHistory history = [];
// Start the chat loop
Console.Write("User > ");
string? userInput;
while ((userInput = Console.ReadLine()) is not null)
{
// Invoke handlebars prompt
var intent = await kernel.InvokeAsync(
getIntent,
new()
{
{ "request", userInput },
{ "choices", choices },
{ "history", history },
{ "fewShotExamples", fewShotExamples }
}
);
// End the chat if the intent is "Stop"
if (intent.ToString() == "EndConversation")
{
break;
}
// Get chat response
var chatResult = kernel.InvokeStreamingAsync<StreamingChatMessageContent>(
prompts["chat"],
new()
{
{ "request", userInput },
{ "history", string.Join("\n", history.Select(x => x.Role + ": " + x.Content)) }
}
);
// Stream the response
string message = "";
await foreach (var chunk in chatResult)
{
if (chunk.Role.HasValue)
{
Console.Write(chunk.Role + " > ");
}
message += chunk;
Console.Write(chunk);
}
Console.WriteLine();
// Append to history
history.AddUserMessage(userInput);
history.AddAssistantMessage(message);
// Get user input again
Console.Write("User > ");
}
}
}