v0.1.2 优化 ReponseMessageFactory，当 OpenAI 未配置时，始终以文字方式返回

Author: JeffreySu

README.md

@@ -1,2 +1,81 @@
 # Senparc.Weixin.AI
 Senparc.Weixin SDK 的 AI 扩展，赋能微信应用基于 OpenAI API、ChatGPT 等 AIGC 能力。
+
+
+## 使用说明
+
+> 注意：Senparc.AI 基于 Senparc.CO2NET 等盛派全家桶的能力，可无缝对接到 Senparc.Weixin SDK 项目中。
+
+### 第一步：配置
+
+首先，按照 [Senparc.Weixin SDK](https://github.com/JeffreySu/WeiXinMPSDK) 的标准格式，在 appsettings.json 文件内设置常规的微信配置信息，以公众号为例：
+
+默认项目 appsettings.json 内容如下：
+```
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  },
+  "AllowedHosts": "*"
+}
+```
+
+在 JSON 中添加以下 CO2NET 及 Senaprc.Weixin SDK 配置：
+```
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  },
+  "AllowedHosts": "*",
+
+  //CO2NET 设置
+  "SenparcSetting": {
+    "IsDebug": true,
+    "DefaultCacheNamespace": "DefaultCacheTest"
+  },
+  //Senparc.Weixin SDK 设置
+  "SenparcWeixinSetting": {
+    //微信全局
+    "IsDebug": true,
+    //公众号
+    "Token": "YourToken",
+    "EncodingAESKey": "YourEncodingAESKey",
+    "WeixinAppId": "YourWeixinAppId",
+    "WeixinAppSecret": "YourWeixinAppSecret"
+  }
+}
+```
+
+为使用 Senaprc.AI，在原有项目配置的基础上，继续追加一段 Senparc.AI 的配置：
+
+```
+  //Senparc.AI 设置
+  "SenparcAiSetting": {
+    "IsDebug": true,
+    "AiPlatform": "AzureOpenAI",
+    "AzureOpenAIKeys": {
+      "ApiKey": "YourAzureApiKey", 
+      "AzureEndpoint": "https://xxxx.openai.azure.com/",
+      "AzureOpenAIApiVersion": "2022-12-01" 
+    },
+    "OpenAIKeys": {
+      "ApiKey": "YourOpenAIKey", 
+      "OrgaizationId": "YourOpenAIOrgId"
+    }
+  }
+```
+
+> 各项配置含义详见：https://github.com/Senparc/Senparc.AI
+
+### 设置 MessageHandler
+
+> 您可以在已经创建好的 MessageHandler 中继续集成 Senparc.AI（以及 Senparc.Weixin.AI），机器人默认使用文字方式接收和应答，但当内容被判断为需要输出图片时，使用 OpenAI 的 DallE 接口生成图片（注意：如果 `appsettings.json`文件中未配置 OpenAIKeys 信息，将始终使用文字方式返回）。<br>
+> 下面以一个全新的文件为例，创建一个对话聊天机器人。
+
+

Samples/Senparc.Weixin.AI.MPSample/appsettings.-remove-here-.json

@@ -12,24 +12,14 @@
     "IsDebug": true,
     "DefaultCacheNamespace": "DefaultCacheTest"
   },
-  "SenparcAiSetting": {
-    "IsDebug": true,
-    "AiPlatform": "AzureOpenAI",
-    "ApiKey": "f23272c02aed406b8a214cbbcf0decdf", //TODO：加密
-    //"ApiKey": "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", //TODO：加密
-    "OrgaizationId": "org-Bp9B5eGmPFtwDsnIwCV7UjKO",
-    //当设置 AiPlatform 为 AzureOpenAI 时需要设置以下参数：
-    "AzureEndpoint": "https://zuibot-test.openai.azure.com/",
-    "AzureOpenAIApiVersion": "2022-12-01" //调用限制请参考：https://learn.microsoft.com/en-us/azure/cognitive-services/openai/quotas-limits
-  },
   //Senparc.Weixin SDK 设置
   "SenparcWeixinSetting": {
     //微信全局
     "IsDebug": true,
     //公众号
-    "Token": "weixin",
-    "EncodingAESKey": "",
-    "WeixinAppId": "wxe273c3a02e09ff8c",
-    "WeixinAppSecret": "631f30445f640e1a870f1ef79aa543bd"
+    "Token": "YourToken",
+    "EncodingAESKey": "YourEncodingAESKey",
+    "WeixinAppId": "YourWeixinAppId",
+    "WeixinAppSecret": "YourWeixinAppSecret"
   }
 }

src/Senparc.Weixin.AI/ReponseMessageFactory.cs

@@ -13,6 +13,7 @@
 using Senparc.Weixin.AI.Entities;
 using Senparc.Weixin.AI.WeixinSkills;
 using Senparc.Weixin.MP.AdvancedAPIs;
+using Senparc.Weixin.MP.Entities;
 using System;
 using System.IO;
 using System.Linq;
@@ -31,6 +32,15 @@ public ReponseMessageFactory(IServiceProvider serviceProvider)
 
         public async Task<string> GetResponseMessageByPlanAsync(IAiHandler aiHandler, string openId, string text)
         {
+            //判断 OpenAI 是否已配置
+            if (!Senparc.AI.Config.SenparcAiSetting.IsOpenAiKeysSetted)
+            {
+                //如果没有配置 OpenAI，则始终使用文字消息
+                return nameof(ResponseMessageText);
+            }
+
+            //已经配置了 OpenAI，根据用户消息的提示，进行判断
+
             var skAiHandler = aiHandler as Senparc.AI.Kernel.SemanticAiHandler;
             var iWantToRun = skAiHandler
                              .IWantTo()

src/Senparc.Weixin.AI/Senparc.Weixin.AI.csproj

@@ -2,7 +2,7 @@
 
 	<PropertyGroup>
 		<TargetFramework>netstandard2.1</TargetFramework>
-		<Version>0.1.1-beta1</Version>
+		<Version>0.1.2-beta1</Version>
 		<Nullable>enable</Nullable>
 		<LangVersion>10.0</LangVersion>
 		<AssemblyName>Senparc.Weixin.AI</AssemblyName>
@@ -26,7 +26,8 @@
 		<PackageIcon>icon.jpg</PackageIcon>
 		<PackageReleaseNotes>
 			v0.1.0 创世
-			
+			v0.1.1 提供 ReponseMessageFactory 等基础设施，完成使用 GPT 判断用户对话意图
+			v0.1.2 优化 ReponseMessageFactory，当 OpenAI 未配置时，始终以文字方式返回
 		</PackageReleaseNotes>
 		<RepositoryUrl>https://github.com/Senparc/Senparc.Weixin.AI</RepositoryUrl>
 		<Configurations>Debug;Release;Test</Configurations>
@@ -80,9 +81,9 @@
 
 		<PackageReference Include="Senparc.AI.Kernel" Version="0.1.3-beta1" />-->
 
-		<PackageReference Include="Senparc.AI" Version="0.1.4.1-beta1" />
+		<PackageReference Include="Senparc.AI" Version="0.1.4.2-beta1" />
 
-		<PackageReference Include="Senparc.AI.Kernel" Version="0.1.4.1-beta1" />
+		<PackageReference Include="Senparc.AI.Kernel" Version="0.1.4.2-beta1" />
 
 		<PackageReference Include="Senparc.NeuChar" Version="2.1.3.6" />