探索Semantic Kernel内置插件：深入了解ConversationSummaryPlugin的应用

前言

经过前几章的学习我们已经熟悉了 Semantic Kernel 插件的概念，以及基于 Prompts 构造的 Semantic Plugins 和基于本地方法构建的 Native Plugins 。本章我们来讲解一下在 Semantic Kernel 中内置的一些插件，让我们避免重复造轮子。

内置插件

Semantic Kernel 有非常多的预定义插件，作为解决通用业务的相关能力。 Plugins 地址 ^[1]

这里面每一个类库都是一组相关功能的插件 SDK ，其中 Plugins.Core 里面提供的使我们高频使用的插件集合。

Plugins.Core

可以看到 Plugins.Core 内有以下几个插件：

实战

我们来对 Semantic Kernel 中提供的内置插件来做一个实战练习

第一步需要安装 Nuget 包

NuGet\Install-Package Microsoft.SemanticKernel.Plugins.Core -Version 1.14.1-alpha


该包目前只有预览版本，如果用 VS 的包管理器安装，那需要勾选 包括预览发行版

ConversationSummaryPlugin

这是一个对话总结插件，以提示词构造的 Semantic Plugins ,插件内定义了三个 Kernel Function 分别是：

unset unset SummarizeConversation unset unset

我们先定义一个对话用户我们测试的对话数据


string chatTranscript = @"
A: 你好，最近工作很忙碌，我们需要安排下周的会议时间，你觉得周几比较合适？
B: 嗯，我明白，工作确实很忙。周三或周四应该比较合适，因为那时候大家的日程相对空闲一些。
A: 好的，周三或周四都可以，我们再确认一下其他同事的时间表。
B: 对，最好再和大家核实一下，免得出现时间冲突。
A: 我今天会发邮件询问大家的意见，然后我们再做最终决定。
B: 好的，我也会在群里提醒大家留意邮件。
A: 大家好，关于下周的会议安排，我建议定在周四下午两点，在会议室A举行，大家觉得怎么样？
C: 周四下午两点可以，我在日历上已经标注了。
D: 对不起，周四下午我有其他安排，能否改到周三下午呢？
A: 好的，我们尽量照顾大家的时间，那就改到周三下午两点吧，地点仍然是会议室A。
B: 没问题，我会通知其他同事，让大家知道时间的变动。
"

;


Kernel 注册插件:

var conversationSummaryPlugin = kernel.ImportPluginFromType<ConversationSummaryPlugin>();


总结会话内容

Console.WriteLine("SamplePlugins - Conversation Summary Plugin - Summarize");
{
FunctionResult summary = await kernel.InvokeAsync(
conversationSummaryPlugin["SummarizeConversation"], new() { ["input"] = chatTranscript });
Console.WriteLine($"Generated Summary:{summary.ToString()}");
}

OutPut:

Generated Summary:In the conversation, A and B discuss scheduling a meeting for the following week, considering Wednesday or Thursday as potential dates due to lighter schedules. A decides to send an email to confirm the availability of all colleagues. Later, A proposes holding the meeting on Thursday at 2 PM in Conference Room A, but D requests a change due to a scheduling conflict. A agrees to reschedule the meeting to Wednesday at 2 PM in the same room, and B confirms that they will inform the rest of the team about the change.


Semantic Kernel 的这个插件我用了 GPT-4o 和 Kimi 都回复的是英文，我感觉这个内置的这个 Semantic Kernel 插件还是不够完善。

我们可以看一下 SummarizeConversation 方法的 Prompts 定义

BEGIN CONTENT TO SUMMARIZE:
{{$INPUT}}
END CONTENT TO SUMMARIZE.
Summarize the conversation in 'CONTENT TO SUMMARIZE', identifying main points of discussion and any conclusions that were reached.
Do not incorporate other general knowledge.
Summary is in plain text, in complete sentences, with no markup or tags.
BEGIN SUMMARY:



简要理解一下这个提示词：

针对上述我们发现的问题： 会话摘要全部是中文的问题 我觉得可以进行提示词的优化

优化的第一点内容是： 总结应选择最切合内容的语言 即 in the language that best fits the content. 。

@"BEGIN CONTENT TO SUMMARIZE:
{{$INPUT}}
END CONTENT TO SUMMARIZE.
Please summarize the conversation, highlighting the main points and any conclusions reached, in the language that best fits the content. Do not incorporate any external general knowledge. The summary should be in plain text, in complete sentences, without any markup or tags.
BEGIN SUMMARY:



我们自定义一个插件测试一下，创建一个 CustomConversationSummaryPlugin 的插件，这个和原生 SummarizeConversation 插件只有 Prompts 有区别

privateconstint MaxTokens = 1024;
privatereadonly KernelFunction _summarizeConversationFunction;
publicCustomConversationSummaryPlugin()
{

PromptExecutionSettings settings = new()
{
ExtensionData = new Dictionary<string, object>()
{
{ "Temperature", 0.1 },
{ "TopP", 0.5 },
{ "MaxTokens", MaxTokens }
}
};
this._summarizeConversationFunction = KernelFunctionFactory.CreateFromPrompt(
CustomConversationSummaryPlugin.SummarizeConversationDefinition,
description: "Given a p of a conversation transcript, summarize the part of the conversation.",
executionSettings: settings);
}
///<summary>
/// Given a long conversation transcript, summarize the conversation.
///</summary>
///<param name="input">A long conversation transcript.</param>
///<param name="kernel">The <see cref="Kernel"/> containing services, plugins, and other state for use throughout the operation.</param>
[KernelFunction, Description("Given a long conversation transcript, summarize the conversation.")]
public Task<string> SummarizeConversationAsync(
[Description("A long conversation transcript.")] string input,
Kernel kernel) =>
ProcessAsync(this._summarizeConversationFunction, input, kernel);
privatestaticasync Task<string> ProcessAsync(KernelFunction func, string input, Kernel kernel)
{
List<string> lines = TextChunker.SplitPlainTextLines(input, MaxTokens);
List<string> paragraphs = TextChunker.SplitPlainTextParagraphs(lines, MaxTokens);
string[] results = newstring[paragraphs.Count];
for (int i = 0; i < results.Length; i++)
{
// The first parameter is the input text.
results[i] = (await func.InvokeAsync(kernel, new() { ["input"] = paragraphs[i] }).ConfigureAwait(false))
.GetValue<string>() ?? string.Empty;
}
returnstring.Join("\n", results);
}







Kernel 对象注册自定义插件

var customCustomConversationSummaryPlugin = kernel.ImportPluginFromType<CustomConversationSummaryPlugin>();


新跑一边测试一下：

Generated Summary:在这段对话中，A和B讨论了安排下周会议的时间。B建议周三或周四比较合适，因为那时大家的日程相对空闲。A决定通过邮件询问其他同事的意见，然后做出最终决定 。在邮件中，A提议将会议安排在周四下午两点，地点是会议室A。然而，D表示周四下午有其他安排，请求将会议改到周三下午。A同意了D的请求，将会议时间调整为周三下午两点，地点仍然是会议室A。B表示会通知其他同事关于时间变动的情况。


可以看到满足我们的需求了，根据我们输入生成的摘要信息没有问题了。

这个插件对于我们的聊天会话也是十分有用，对话历史记录随着不断聊天，消息越来越多，那每次对话消耗的 token 也是不断增加，此时 ConversationSummaryPlugin 插件的就可以帮助我们对聊天记录进行摘要总结，提高聊天效率。

提取会话行动项

识别对话记录中的动作项（ action items ）是一种重要的沟通技巧，它有助于提高效率、确保任务的完成和促进团队协作。

使用场景包括：

要完成这个需要用到 ConversationSummaryPlugin 插件的 GetConversationActionItems 方法

Console.WriteLine("======== SamplePlugins - Conversation Summary Plugin - Action Items ========");
{
FunctionResult summary = await kernel.InvokeAsync(
conversationSummaryPlugin["GetConversationActionItems"], new() { ["input"] = chatTranscript });
Console.WriteLine($"Generated Action Items:{summary.ToString()}");
Console.WriteLine(summary.GetValue<string>());
}



输出：

{
"actionItems": [
{
"owner": "A",
"actionItem": "发邮件询问大家的意见",
"dueDate": "",
"status": "Open",
"notes": "今天会发"
},
{
"owner": "B",
"actionItem": "在群里提醒大家留意邮件",
"dueDate": "",
"status": "Open",
"notes": ""
},
{
"owner": "B",
"actionItem": "通知其他同事时间的变动",
"dueDate": "",
"status": "Open",
"notes": "让大家知道时间的变动"
}
]
}


提取会话的主题

用于对话摘要的工具或插件，它的作用是帮助用户快速识别和总结对话中的主要话题。

使用场景可能包括但不限于：

要完成这个功能需要用到 ConversationSummaryPlugin 插件的 GetConversationTopics 方法

使用：

Console.WriteLine("======== SamplePlugins - Conversation Summary Plugin - Topics ========");
FunctionResult summary = await kernel.InvokeAsync(
conversationSummaryPlugin["GetConversationTopics"], new() { ["input"] = chatTranscript });
Console.WriteLine($"Generated Topics:{summary.ToString()}");


输出：

Generated Topics:
{
"topics": [
"Work busy",
"Schedule meeting",
"Wednesday or Thursday",
"Confirm colleagues' availability",
"Email for opinions",
"Meeting reschedule",
"Thursday 2 PM",
"Change to Wednesday 2 PM",
"Notify colleagues"
]
}


最后

剩下的插件我们后续章节在讲解吧，本章重点讲解了 ConversationSummaryPlugin 会话总结插件的使用。

示例代码

本文源代码 ^[2]

参考资料

[1]

Plugins 地址: https://github.com/microsoft/semantic-kernel/tree/main/dotnet/src/Plugins