前言

上一章我们熟悉了
Semantic Kernel
中的内置插件和对
ConversationSummaryPlugin
插件进行了实战,本章我们讲解一下另一个常用的内置插件
HttpPlugin
的应用。

上一章对
ConversationSummaryPlugin
总结进行了调整之后,顺便给
Semantic Kernel
提了一个
PR
已经被采纳了,在此记录一下!

image

.Net: refactor : SummarizeConversation #6719

HttpPlugin

HttpPlugin
插件属于
Native Plugins
原生插件。它提供了
Http
的功能,允许用户通过
Http
协议与外部进行交互。

我们对这个插件的整体进行分析一下

构造函数

提供了两个构造函数。第一个构造函数没有参数,它调用了第二个构造函数,并传递
null
作为参数。

第二个构造函数接受一个
HttpClient
类型的参数,如果未提供,则使用
HttpClientProvider.GetHttpClient()
方法获取一个新的
HttpClient
实例。

   public HttpPlugin() : this(null)
   {
   }

    [ActivatorUtilitiesConstructor]
    public HttpPlugin(HttpClient? client = null) =>
     this._client = client ?? HttpClientProvider.GetHttpClient();

这里重点说一下第二个构造函数,支持
HttpClient
的构造函数,这就有更多的可玩性了,比如可以定义一个
HttpclientHandler
对请求进行添加自定义的
HttpHeader
或者进行参数的拼接转发等操作。

Native functions

GetAsync
:发送一个
HTTP GET
请求,并返回响应体作为字符串。
PostAsync
:发送一个
HTTP POST
请求,带有请求体,并返回响应体作为字符串。
PutAsync
:发送一个
HTTP PUT
请求,带有请求体,并返回响应体作为字符串。
DeleteAsync
:发送一个
HTTP DELETE
请求,并返回响应体作为字符串。

实战

第一步需要安装
Nuget

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

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

Semantic Kernel
注册插件有两种方式:

kernel.ImportPluginFromType<HttpPlugin>();
var httpclient = new HttpClient();
kernel.ImportPluginFromObject(new HttpPlugin(httpclient));

以上两种方式对应两种生命周期的注册

创建的接口

image

这个接口都很简单 对我们
Student
对象的增删改查

public class Student
{
 
    public string Name { get; set; }


    public int Age { get; set; }

}

执行测试

我们的测试程序还是以
Semantic Kernel
的会话服务,自动触发
function calling
的形式

// Get chat completion service
var chatCompletionService = kernel.GetRequiredService<IChatCompletionService>();

// Start the conversation
Console.Write("User > ");
string? userInput;
while ((userInput = Console.ReadLine()) is not null)
{
    // Add user input
    history.AddUserMessage(userInput);

    // Enable auto function calling
    OpenAIPromptExecutionSettings openAIPromptExecutionSettings = new()
    {
        ToolCallBehavior = ToolCallBehavior.AutoInvokeKernelFunctions
    };

    // Get the response from the AI
    var result = await chatCompletionService.GetChatMessageContentAsync(
        history,
        executionSettings: openAIPromptExecutionSettings,
        kernel: kernel);

    // Print the results
    Console.WriteLine("Assistant > " + result);

    // Add the message from the agent to the chat history
    history.AddMessage(result.Role, result.Content ?? string.Empty);

    // Get user input again
    Console.Write("User > ");
}

Get请求测试

User > 帮我向https://localhost:7014/Student发一个get请求
Assistant > 向https://localhost:7014/Student发起GET请求后成功得到了响应,返回的数据显示包含了一个学生的信息。该学生名为 张三,年龄为16岁。这表明请求执行成功,获取到了预期的数据。

Post请求测试

HttpPlugin
的这个功能比较鸡肋,可以看一下代码

 [KernelFunction]
 [Description("Makes a POST request to a uri")]
 public Task<string> PostAsync([Description("The URI of the request")] string uri, [Description("The body of the request")] string body, CancellationToken cancellationToken = default(CancellationToken))
 {
     return SendRequestAsync(uri, HttpMethod.Post, new StringContent(body), cancellationToken);
 }

参数形式是
new StringContent(body)
,也就是说
MediaTypeHeaderValue
媒体类型默认为
StringContent text/plain

Asp.Net Core
只能接收
Post
请求
json
格式的
string
,不能接收原始
string

content-type

text/plain

post
请求,如果支持需要自定义实现没有提供对应的
MediaTypeFormatter

所以说这个插件的
Post
请求场景局限,真正用到生产还需要自己去实现一个插件!!!

User > 向https://localhost:7014/student 发一个post请求
Assistant > 已成功向 https://localhost:7014/student 发送了 POST 请求。如果需要发送具体的数据,请提供要包含在请求体内的 JSON 数据。

其他

Put

Delete
类似。

最后

可以借鉴
HttpPlugin
的实现思路在项目中灵活的运行,如果不支持那就可以自定义插件来完成需求的开发,还是比较期待这个插件能够更加完善的一点,在未来以更灵活的方式支持Post等请求的多种形式。

标签: none

添加新评论