打造台灣本地化的C# OpenAI ChatGPT插件
目錄
[TOC]
🚀 Blazer Chat GPT Plugin: 教學指南
- 介紹
- 系統需求
- 開始之前的準備
- 在 Visual Studio 中建立 Blazer Server 專案
- 安裝 NuGet 套件
- 編輯 Program.cs 檔案
- 新增控制器方法
- 新增 AI 插件所需的文件和圖示
- 發佈和測試
- 將插件上傳至 OpenAI 平台
🚀 Blazer Chat GPT Plugin: 教學
Blazer Chat GPT 插件是一個用於 Blazer Server 應用程式的擴充,它可以實現與 OpenAI GPT 模型的集成,讓聊天機器人回應使用者的提問。本教程將引導您完成安裝、設置和使用 Blazer Chat GPT 插件的步驟。
1. 介紹
Blazer Chat GPT 插件以 Blazer Server 應用程式為基礎,並將 OpenAI GPT 模型集成到其中,以實現聊天機器人的功能。使用此插件,您可以建立一個基於 GPT 模型的聊天介面,該模型可以回答使用者的提問並進行對話。
2. 系統需求
在開始設置 Blazer Chat GPT 插件之前,請確保您的開發環境滿足以下系統需求:
- Visual Studio 2019 或更新版本
- .NET Core 3.1 或更新版本
- OpenAI GPT 模型的存取權限
3. 開始之前的準備
在開始設置 Blazer Chat GPT 插件之前,請完成以下準備工作:
- 確保您已獲取 OpenAI GPT 模型的存取權限
- 確保您已安裝最新版本的 Visual Studio
- 確保您已安裝最新版本的 .NET Core
4. 在 Visual Studio 中建立 Blazer Server 專案
- 打開 Visual Studio,點擊「新建專案」。
- 在「新增專案」視窗中,選擇「Blazer Server App」作為專案種類,並命名為「Blazer Chat GPT Plugin」。
- 點擊「下一步」,選擇專案的保存位置,然後點擊「建立」。
5. 安裝 NuGet 套件
為了集成 OpenAPI 和 Swashbuckle,我們需要安裝一些 NuGet 套件。請按照以下步驟進行:
- 右鍵點擊專案,選擇「管理 NuGet 套件」。
- 在「NuGet 套件管理」視窗中,搜尋並安裝「OpenAPI」套件。
- 點擊「確定」,同意授權協議。
- 安裝「Swashbuckle」及「Swashbuckle Annotations」套件,同樣按照上述步驟執行。
6. 編輯 Program.cs 檔案
現在,我們將編輯 Program.cs
檔案以設置 Blazer Chat GPT 插件的相關配置。請按照以下步驟操作:
- 打開
Program.cs
檔案。
- 在
ConfigureServices
方法中,新增以下程式碼以允許 OpenAI API 調用我們的專案:
services.AddCors(options =>
{
options.AddPolicy("CorsPolicy",
builder => builder.AllowAnyOrigin()
.AllowAnyMethod()
.AllowAnyHeader());
});
- 在
Configure
方法中,新增以下程式碼以啟用 Swagger 和 Swagger UI:
app.UseSwagger();
app.UseSwaggerUI(c =>
{
c.SwaggerEndpoint("/swagger/v1/swagger.json", "Blazer Chat GPT Plugin API");
c.RoutePrefix = "docs";
});
- 儲存並關閉
Program.cs
。
7. 新增控制器方法
接下來,我們將新增幾個控制器方法,這些方法將由 OpenAI 調用以觸發插件的功能。請按照以下步驟操作:
- 在專案中創建一個名為
Controllers
的文件夾。
- 在
Controllers
文件夾中,右鍵點擊,選擇「新增(Add)」,然後選擇「類別(Class)」。
- 在類別名稱中輸入
TodosController
,然後點擊「新增(Add)」。
8. 新增 AI 插件所需的文件和圖示
為了讓 OpenAI 能夠識別並調用我們的插件,我們需要在專案中添加一些必需的文件和圖示。請按照以下步驟進行:
- 在專案中創建一個名為
wwwroot
的文件夾。
- 在
wwwroot
文件夾中,將 favicon.png 文件複製並粘貼到該文件夾中。
- 在
wwwroot
文件夾上點擊右鍵,選擇「新增(Add)」,然後選擇「新建項目(New Item)」。
- 在「新增項目」視窗中,選擇「檔案(File)」,並將檔案名稱設為
ai-plugin.json
。
- 打開
ai-plugin.json
檔案並添加以下內容:
{
"url": "http://localhost:5000",
"icon": "/favicon.png",
"methods": [
{
"name": "AddTodoItem",
"route": "api/todos/add",
"httpVerb": "POST"
},
{
"name": "GetTodoItems",
"route": "api/todos",
"httpVerb": "GET"
},
{
"name": "DeleteTodoItem",
"route": "api/todos/delete/{id}",
"httpVerb": "DELETE"
}
]
}
請確保 url
的端口與您的專案相符。
9. 發佈和測試
完成所有設置和配置後,現在我們可以進行發佈並測試插件了。請按照以下步驟操作:
- 在 Visual Studio 中,選擇「建置(Build)」>「重新建置解決方案(Rebuild Solution)」以確保所有更改都已保存並構建成功。
- 在 Visual Studio 中,選擇「偵錯(Debug)」>「開始偵錯(Start Debugging)」以使用 http 啟動專案。
- 系統會自動開啟預設瀏覽器,並導航到 Swagger 端點,您可以在 Swagger UI 中查看控制器方法及其相應的路由。
- 若要測試插件,請將 Swagger 端點更改為
/swagger/v1/swagger.yaml
,然後導航到該頁面。這是 OpenAI 調用插件所需的 Swagger Yaml 文件。
10. 將插件上傳至 OpenAI 平台
完成開發和測試後,您可以將插件上傳至 OpenAI 平台,以在您的應用程序中使用。請按照以下步驟操作:
- 前往 OpenAI 插件商店網站。
- 選擇「開發自己的插件」選項。
- 在 URL 欄位中輸入您的本地網站 URL。
- 點擊「安裝插件」按鈕以安裝插件。
- 確保插件旁邊的選框已選中。
- 開啟您的控制器檔案,設置一個斷點,以便於調試和監視插件的運行情況。
- 回到 OpenAI 平台,點擊「添加新的待辦事項步驟一和步驟二」按鈕,觸發插件的
AddTodoItem
方法。
- 您將看到程式碼中設定的斷點被觸發,並且可以檢查請求和回應的內容。
- 您可以通過不同的請求觸發其他控制器方法,以測試插件的各種功能和情境。
💡 亮點
- Blazer Server 應用程式集成 OpenAI GPT 模型
- 通過 Swagger UI 查看和測試控制器方法
- 在 OpenAI 平台上安裝和測試插件
- 使用 AI 插件提供的控制器方法進行對話回應
🙋 常見問題
Q: 如何獲取 OpenAI GPT 模型存取權限?
A: 您需要前往 OpenAI 官方網站,註冊帳號並購買 GPT 模型的存取權限。詳細訊息請參閱 OpenAI 官方網站上的文件和指南。
Q: 是否支援其他語言?
A: 是的,Blazer Chat GPT 插件支援多種語言,包括但不限於英語、西班牙語、法語、德語、日語等。
Q: 是否支援自訂對話邏輯?
A: 是的,您可以根據自己的需求在控制器方法中定義任意的對話邏輯。
Q: 是否可以在生產環境中使用此插件?
A: 是的,Blazer Chat GPT 插件可以在生產環境中使用。您可以根據需要對插件進行配置和優化。
🔗 相關資源:
注意:本指南中提到的所有 URL 和路徑僅供示範,請根據您的實際專案設定進行調整。