dotnet SemanticKernel 入门 SemanticFunction 自然语言函数

本文将和大家介绍 LLM 的魔法，通过自然语言编程的方式开发 SemanticFunction 函数

大家都知道，编程里面的函数可以是一个完成某个功能的逻辑片段，绝大部分的函数都需要使用人类不友好的编程语言进行开发。以往只有熟练掌控和计算机沟通的编程语言的程序员才能开发出一个个功能函数，而现在有了 LLM 的魔法帮助下，人们也可以用自然语言编写出完成某项功能逻辑函数，更有趣的是使用自然语言编程写出的函数在特定领域下可以实现出更加智能容错更高的函数。如宵伯特所说：LLM的强大之处在于可以架起自然语言与机器语言之间的桥梁。通过合适的提示词，我们可以让LLM把自然语言中的关健信息提取出来，哪怕是文本背后的一些隐含信息也可以进行处理

接下来我将和大家介绍在配合 AzureAI 的 GPT 大语言模型下的 SemanticFunction 自然语言函数的开发和对接方法

本文属于 SemanticKernel 入门系列博客，更多博客内容请参阅我的博客导航或博客园的合集

本文开始之前，需要大家有一个 AzureAI 或 OpenAI 的账号，包括 Endpoint 和 ApiKey 等对接必备信息。否则你将不能跟随本文的演示代码进入 LLM 的世界

申请 AzureAI 地址：https://aka.ms/oai/access

如等不急申请且咱认识的情况下，可以向我要一个号给你测试

配置

在 KernelBuilder 里面可以通过 WithAzureChatCompletionService 或 WithAzureTextCompletionService 方法进行配置和 AzureAI 的对接。我这里申请的是 GPT 3.5 16K 的，只支持 ChatCompletion 方式，因此就选 WithAzureChatCompletionService 进行配置

需要传入的是部署的模型和 Endpoint 和 ApiKey 这两个必要的信息，如以下代码进行配置

代码语言：javascript复制

using Microsoft.Extensions.Logging;
using Microsoft.SemanticKernel;

var loggerFactory = LoggerFactory.Create(builder =>
{
    builder.AddConsole();
    builder.SetMinimumLevel(LogLevel.Debug);
});
var logger = loggerFactory.CreateLogger("SemanticKernel");

// 这里的演示代码需要用到 AzureAI 的支持，需要提前申请好，申请地址：https://aka.ms/oai/access

var endpoint = "https://lindexi.openai.azure.com/"; // 请换成你的地址
var apiKey = args[0]; // 请换成你的密钥

IKernel kernel = new KernelBuilder()
    .WithLogger(logger)
    .WithAzureChatCompletionService("GPT35", endpoint, apiKey)
    // 当然，这里也可以支持 OpenAI 的服务。或者是其他第三方的服务
    //.WithOpenAIChatCompletionService()
    .Build();

以上代码还在配置的时候注入控制台日志，方便出错时了解错误原因

关于 AzureAI 的模型部署，可以在网上搜到非常多大佬的博客，我这里就不进行展开。相信大家看 Azure 界面也就知道如何配置了

如果拿到的是 OpenAI 的服务，则可以选用 WithOpenAIChatCompletionService 或 WithOpenAITextCompletionService 进行配置

定义自然语言函数

接下来的编程可就是用自然语言开始编写了。本文的例子是做一个帮忙找借口的函数，这个函数的作用就是你输入做了什么事情，然后 GPT 帮你找一个夸张的借口。这个例子是原本 SemanticKernel 官方的例子，我只是将其修改为中文

先使用自然语言定义出函数，这里采用 $input 作为变量的占位符号，这是上一篇博客自定义变量和技能里所提到的方法

代码语言：javascript复制

const string FunctionDefinition = @"
为给定的事件想出一个创造性的理由或借口。
要有创意，要有趣。让你的想象力尽情驰骋。

事情：我要迟到了。
借口：我被长颈鹿帮绑架了。

事情：我有一年没去健身房了
借口：我一直忙着训练我的宠物龙。

事情： { {$input} }
借口：";

以上的函数就是先给 GPT 两个例子，然后第三个就是让 GPT 进行自由发挥

完成了自然语言函数编写之后，接下来就可以和 SemanticKernel 框架进行对接了

更多关于 Prompt 提示词相关，请参阅简介 - Learning Prompt

对接框架

对接框架最简单的方法就是通过 CreateSemanticFunction 方法创建出 SemanticFunction 函数，如以下代码

代码语言：javascript复制

ISKFunction excuseFunction = kernel.CreateSemanticFunction(FunctionDefinition, maxTokens: 200,
    // 温度高一些，这样 GPT 才会乱说
    temperature: 1);

这时候为了让 GPT 能够回答更加有趣，这里提升了温度

完成函数的制作之后，接下来咱来看看怎么调用吧

调用函数

由于 CreateSemanticFunction 方法返回的是一个 ISKFunction 接口，也就是和前面博客提到的技能的函数在使用上没有多少的不同，从这里也可以看出 SemanticKernel 故意模糊了传统的编程函数和自然语言函数，从而让大家在调用的时候不需要关注某个函数是如何创建的

代码语言：javascript复制

var result = await excuseFunction.InvokeAsync("我错过了篮球赛");
Console.WriteLine(result);

我跑了一次，输出了以下代码

代码语言：javascript复制

我被邀请参加了一个秘密的超级英雄训练营，我必须去拯救世界！

看起来 GPT 的这个函数算是定义成功了，但就是回答有些奇怪，还需要继续炼丹，修改自然语言

也许后面会有许多面向 LLM 的开发者，这些开发者不再编写传统的编程语言的代码，而是编写自然语言，让 LLM 实现魔法的功能

代码

本文的代码放在github 和 gitee 欢迎访问

可以通过如下方式获取本文的源代码，先创建一个空文件夹，接着使用命令行 cd 命令进入此空文件夹，在命令行里面输入以下代码，即可获取到本文的代码

代码语言：javascript复制

git init
git remote add origin https://gitee.com/lindexi/lindexi_gd.git
git pull origin 27492e28eee195378642ec34e3cc8d9d9e1417a9

以上使用的是 gitee 的源，如果 gitee 不能访问，请替换为 github 的源。请在命令行继续输入以下代码

代码语言：javascript复制

git remote remove origin
git remote add origin https://github.com/lindexi/lindexi_gd.git
git pull origin 27492e28eee195378642ec34e3cc8d9d9e1417a9

获取代码之后，进入 SemanticKernelSamplesExample05_InlineFunctionDefinition 文件夹

参考文档

Semantic Kernel 入门系列：LLM的魔法 - 宵伯特 - 博客园

编程博客函数配置入门

0 人点赞