Forge.OpenAI
v1.5.5
مكتبة عميل Openai API لـ .NET. وهو يدعم Openai و Azure-Openai APIs. تم تطوير هذه المكتبة للاستخدام العام وهي مجانية في الاستخدام. إصدارات .NET المدعومة:
x> = v4.6.1 ،
x> = netstandard 2.0 ،
x> = dotnetcore 3.1 ،
.NET 6.0 ،
.NET 7.0
.NET 8.0
يعمل مع Blazor Webassembly و Blazor Server.
لتثبيت الحزمة ، أضف السطر التالي إلى ملف csproj الذي يحل محل xxx بأحدث رقم إصدار:
<PackageReference Include="Forge.OpenAI" Version="x.x.x" />
يمكنك أيضًا التثبيت عبر .NET CLI مع الأمر التالي:
dotnet add package Forge.OpenAI
إذا كنت تستخدم Visual Studio ، فيمكنك أيضًا التثبيت عبر مدير حزمة Nuget المدمج.
يجب عليك إنشاء apikey للعمل مع API Openai.
إذا لم يكن لديك حساب في Openai ، فقم بإنشاء حساب هنا: https://platform.openai.com/
من التنقل إلى: https://platform.openai.com/account/api- keys
بشكل افتراضي ، تستخدم هذه المكتبة حقن Microsoft Trepency ، ومع ذلك فهي ليست ضرورية.
يمكنك تسجيل خدمات العميل مع مجموعة الخدمة في ملف startup.cs / program.cs في التطبيق الخاص بك.
public void ConfigureServices ( IServiceCollection services )
{
services . AddForgeOpenAI ( options => {
options . AuthenticationInfo = Configuration [ " OpenAI:ApiKey " ] ! ;
} ) ;
}أو في ملف برنامجك .
public static async Task Main ( string [ ] args )
{
var builder = WebAssemblyHostBuilder . CreateDefault ( args ) ;
builder . RootComponents . Add < App > ( " app " ) ;
builder . Services . AddForgeOpenAI ( options => {
options . AuthenticationInfo = builder . Configuration [ " OpenAI:ApiKey " ] ! ;
} ) ;
await builder . Build ( ) . RunAsync ( ) ;
}أو
public static async Task Main ( string [ ] args )
{
using var host = Host . CreateDefaultBuilder ( args )
. ConfigureServices ( ( builder , services ) =>
{
services . AddForgeOpenAI ( options => {
options . AuthenticationInfo = builder . Configuration [ " OpenAI:ApiKey " ] ! ;
} ) ;
} )
. Build ( ) ;
}يجب عليك توفير مفتاح Openai API واختياري مؤسستك لتوضيح الخدمة. إذا لم تقدمه في التكوين ، فابحث الخدمة تلقائيًا المعلومات اللازمة في متغيرات البيئة الخاصة بك ، في ملف JSON (.Openai) أو في ملف البيئة (.env).
مثال على متغيرات البيئة:
Openai_key أو Openai_API_Key أو Openai_Secret_Key أو test_openai_secret_key يتم فحصهم لمفتاح API
تم فحص مفتاح المنظمة للعضو
مثال على ملف JSON:
{"apikey": "your_api_key" ، "المنظمة": "منظمة _id"}
يجب أن يحتوي ملف البيئة على أزواج مفتاح/قيمة في هذا التنسيق {key} = {value}
بالنسبة إلى " المفتاح " ، استخدم واحدة من نفس القيمة الموضحة في متغيرات البيئة أعلاه.
مثال على ملف البيئة:
openai_key = your_api_key
المنظمة = اختياريا_your_organization
تتطلب Openai والخدمات التابعة OpenAioptions ، والتي يمكن توفيرها يدويًا أو ستحدث ، إذا كنت تستخدم حقن التبعية. إذا كنت بحاجة إلى استخدام مثيلات خدمة Openai المتعددة في نفس الوقت ، فيجب عليك تقديم هذه الخيارات بشكل فردي بإعدادات مختلفة وبيانات اعتماد المصادقة.
في الخيارات ، هناك العديد من إعدادات URI ، والتي لم يتم لمسها بشكل طبيعي. الخيار الأكثر أهمية هو خاصية AuthenticationInfo ، التي تحتوي على معرف Apkikey و Presentation.
أيضًا ، هناك خيار إضافي ، يسمى httpmessageHandlerFactory ، والذي يبني httpmessageHandler لـ httpclient في بعض الحالات الخاصة ، على سبيل المثال ، إذا كنت ترغب في تجاوز بعض سلوك HTTPClient.
هناك ميزة تسجيل مدمجة ، فقط لأغراض الاختبار والتصحيح ، تسمى LogRequestSandResPonses ، والتي لا تزال قائمة جميع الطلبات والاستجابات في مجلد (LogRequestSandResponsesSfolder). باستخدام هذه الميزة ، يمكنك التحقق من الرسائل ذات المستوى المنخفض. لا أوصي باستخدامه في بيئة الإنتاج.
إذا كنت ترغب في معرفة المزيد حول إمكانيات API ، فيرجى زيارة https://platform.openai.com/docs/api- المرجع إذا كنت بحاجة إلى إنشاء مفتاح API ، يرجى زيارة: https://platform.openai.com/account/api- keys
لقد أنشأت ملعبًا ، وهو جزء من هذا الحل. ويغطي جميع الميزات التي توفرها هذه المكتبة. لا تتردد في الركض من خلال هذه الأمثلة واللعب مع الإعدادات.
هنا أيضًا هو ملعب Openai ، حيث يمكنك أيضًا العثور على أمثلة حول الاستخدام: https://platform.openai.com/playground/p/fault-chat؟lang=node.js&mode=complete&model=text-davinci-003
قم بإعداد الخدمة باستخدام مزود Azure-Openai ، فأنت بحاجة إلى تحديد اسم مورد Azure Openai بالإضافة إلى معرف نشر النموذج الخاص بك.
المتطلبات الأساسية: https://learn.microsoft.com/en-us/azure/cealitive-services/openai/quickstart؟tabs=command-line&pivots=programming-clanguage-studio الوثائق:
مثال: https://github.com/jzo001/forge.openai/blob/main/playgrounds/azure-openai_setup_example/program.cs
