Senparc 全ぜん家いえ桶おけ的てき AI 扩展包つつめ，目前もくぜん主要しゅよう集中しゅうちゅう于 LLM（大だい语言模型もけい）的てき交互こうご。

名称めいしょう	说明	Nuget
Senparc.AI	为所有しょゆう标准接せっ口和くちわ基はじめ础功能のう的てき基もと础模块
Senparc.AI.Kernel	为基于 Senparc.AI 标准，使用しよう SemanticKernel 实现的てき接せっ口こう调用，可か以实现即插即用よう。
Senparc.AI.Agents	为基于 Senparc.AI 标准，使用しよう AutoGen 实现的てき Agent 集成しゅうせい扩展模も块。
Senparc.AI.PromptRange (独立どくりつ项目)	为基于 Senparc.AI 标准，为“PromptRange（提示ていじ词靶场）”生なま态提供ていきょう底そこ层标准じゅん支持しじ的てき底そこ层库。目前もくぜん已やめ经由 Senparc.Xncf.PromptRange 实现，可用かよう于开发基于 PromptRange 的てき扩展应用，兼けん容よう Web、桌面、手て机つくえ等とう系けい统（支持しじ .NET 6.0 及以上じょう框かまち架か）。NeuCharFramework(NCF) 框かまち架か已やめ经默认集成しゅうせい Senparc.Xncf.PromptRange，可か无需修おさむ改あらため任にん何なん代だい码，直接ちょくせつ使用しよう。（什么是ぜ PromptRange？）

在ざい appsettings.json 中ちゅう配置はいち OpenAI 或ある Azure OpenAI 的てき接せっ口こう信しん息いき，如：

//Senparc.AI 设置
"SenparcAiSetting": {
  "IsDebug": true,
  "AiPlatform": "NeuCharAI", //注意ちゅうい修おさむ改あらため为自己じこ平台ひらだい对应的てき枚まい举值
  "NeuCharAIKeys": {
    "ApiKey": "<Your ApiKey>", //在ざい https://www.neuchar.com/Developer/AiApp 申さる请
    "NeuCharEndpoint": "https://www.neuchar.com/<DeveloperId>", //查看 ApiKey 时可看み到いた DeveloperId
    "ModelName": {
      "Chat": "gpt-4o",
      "Embedding": "text-embedding-ada-002",
      "TextCompletion": "gpt-35-turbo-instruct"
    }
  },
  "AzureOpenAIKeys": {
    "ApiKey": "<Your AzureApiKey>", 
    "AzureEndpoint": "<Your AzureEndPoint>", //https://xxxx.openai.azure.com/
    "AzureOpenAIApiVersion": "2022-12-01", //调用限げん制せい请参考さんこう：https://learn.microsoft.com/en-us/azure/cognitive-services/openai/quotas-limits
    "ModelName": {
      "Chat": "gpt-35-turbo"
    }
  },
  "OpenAIKeys": {
    "ApiKey": "<Your OpenAIKey>",
    "OrganizationId": "<Your OpenAIOrgId>",
    "OpenAIEndpoint": null,
    "ModelName": {
      "Chat": "gpt-35-turbo"
    }
  },
  "HuggingFaceKeys": {
    "Endpoint": "<Your EndPoint>", //HuggingFace 的てき Endpoint
    "ModelName": {
      "TextCompletion": "chatglm2"
    }
  },
  "Items": {
    // 更さら多おお自じ定てい义配置はいち
  }
}

其中：AiPlatform 是ぜ平台ひらだい类型，目前もくぜん可か选值为 OpenAI、NeuCharAI、AzureOpenAI、HuggingFace 和わ FastAPI，分ふん别对应 openai.com 官かん方かた接せっ口こう（OpenAI）、https://www.neuchar.com 由よし Senparc 提供ていきょう的中てきちゅう转接口こう、基もと于微软 Azure 的てき AzureOpenAI 接せっ口こう（AOAI)、HuggingFace 接せっ口和くちわ FastAPI 接せっ口こう，系けい统会根ね据すえ配置はいち自じ动实现切换，无需在ざい逻辑代だい码中进行判断はんだん。

仅当 AiPlatform 设置为 OpenAI 时，才さい需要じゅよう设置 OpenAIKeys 及以下か参さん数すう。

仅当 AiPlatform 设置为 NeuCharAI 时，才さい需要じゅよう设置 NeuCharAIKeys 及以下か参さん数すう。

仅当 AiPlatform 设置为 AzureOpenAI 时，才さい需要じゅよう设置 AzureOpenAIKeys 及以下か参さん数すう。

其他平台ひらだい以此类推。

每まい一个平台类型配置下，都と有ゆう一いち个 ModelName 节点，用よう于设置おけ该平台下だいか需要じゅよう被ひ支持しじ的てき模型もけい类型，例れい如需要よう将しょう Chat 接せっ口こう设置为 GPT-4 模型もけい，则设置おけ："Chat": "gpt-4"。

提示ていじ：AzureOpenAI 调用限げん制せい请参考さんこう：https://learn.microsoft.com/en-us/azure/cognitive-services/openai/quotas-limits
OpenAI 调用限げん制せい请参考さんこう OpenAI 后きさき台だい：https://platform.openai.com/docs/guides/rate-limits

Senparc.AI 使用しよう了りょう创新的てき对话式しき编程体たい验，您无需了解りょうかい过多不同ふどう平台ひらだい、SDK 的てき详细用法ようほう，只ただ需要じゅよう按照自己じこ的てき想そう法ほう进行定てい义和编程，最さい后きさき接收せっしゅう结果，以目前ぜん最さい火ひ的てき聊天场景（Chat）为例：

//获取 AI 模型もけい配置はいち（从 appsettings.json 自じ动读取）
var aiSetting = Senparc.AI.Config.SenparcAiSetting;

// 创建 AI Handler 处理器き（也可以通过工厂依赖注入ちゅうにゅう）
var handler = new SemanticAiHandler(aiSetting);

// 定てい义 AI 接せっ口こう调用参さん数すう和わ Token 限げん制せい等とう
var promptParameter = new PromptConfigParameter()
{
    MaxTokens = 2000,
    Temperature = 0.7,
    TopP = 0.5,
};

// 准じゅん备运行ぎょう
var userId = "JeffreySu";//区分くぶん用よう户
var iWantToRun = 
     handler.IWantTo()
            .ConfigModel(aiSetting.ModelName.Chat, userId, modelName)
            .BuildKernel()
            .RegisterSemanticFunction("ChatBot", "Chat", promptParameter)
            .iWantToRun;

// 输入/提つつみ问，获取结果
var prompt = "请问中ちゅう国有こくゆう多少たしょう人口じんこう？";
var aiRequest = iWantToRun.CreateRequest(prompt, true, true);
var aiResult = await iWantToRun.RunAsync(aiRequest);
//aiResult.Result 结果：中国ちゅうごく的てき人口じんこう约为13.8亿。

所有しょゆう快速かいそく参考さんこう示しめせ例れい位い于 /Samples/ 文ぶん件けん夹内

打だ开解决方案あん Senparc.AI.sln，设置 appsettings.json 中ちゅう ApiKey 等とう平台ひらだい参さん数すう，启动项目 Senparc.AI.Samples.Consoles：

输入 1，进入对话操作そうさ：

在ざい主しゅ界面かいめん输入 2 进入 TextCompletion 操作そうさ：

在ざい主しゅ界面かいめん输入 3 即そく可か进入 Embedding 操作そうさ，Embedding 分ぶん为常规信息いき和わ引用いんよう信しん息いき两类，将はた在ざい下した一步中做选择：

选择 1，进入到いた常つね规 Embedding 测试，输入信にゅうしん息いき由よし 3 个英文えいぶん冒おかせ号ごう分割ぶんかつ，录入完成かんせい后きさき输入 n 开始对话测试：

2.2.2 上じょう一いち步ほ选择 2，进入到いた引用いんよう Embedding 测试，输入信にゅうしん息いき由よし 3 个英文えいぶん冒おかせ号ごう分割ぶんかつ，录入完成かんせい后きさき输入 n 开始对话测试：

初はつ始はじめ界面かいめん中ちゅう输入 4，进入 DallE 接せっ口こう的てき绘图操作そうさ：

结果将はた以 URL 的てき形式けいしき返かえし回かい，此时出入でいり s ，可か保存ほぞん图片到いた本地ほんじ：

注意ちゅうい：接せっ口こう返かえし回かい的てき URL 是ぜ一いち个暂存そん地ち址し，不ふ可用かよう于持久じきゅう化か的てき展示てんじ，需要じゅよう及时保存ほぞん，

1. 实现更さら多た模型もけい和わ模も式しき的てき匹ひき配はい。
2. 实现全ぜん自じ动的工こう厂模块自动配置はいち。
3. 集成しゅうせい到いた Senaprc.Weixin SDK，0 逻辑代だい码实现 AI 能力のうりょく接せっ入いれ（聊天场景为主）。
4. 集成しゅうせい到いた NeuCharFramework，0 逻辑代だい码实现 AI 能力のうりょく接せっ入いれ（开发和わ云うん运营场景为主）。
5. 完成かんせい更さら多おお默だま认模型がた适配（目前もくぜん已やめ经提供ていきょう自じ定てい义扩展てん能力のうりょく）
6. 完かん善ぜん独立どくりつ文ぶん档