ملحق Azure OpenAI ل Azure Functions
هام
ملحق Azure OpenAI ل Azure Functions قيد المعاينة حاليا.
ينفذ ملحق Azure OpenAI ل Azure Functions مجموعة من المشغلات والروابط التي تمكنك من دمج ميزات وسلوكيات خدمة Azure OpenAI بسهولة في عمليات تنفيذ التعليمات البرمجية للدالة.
Azure Functions هي خدمة حساب مستندة إلى الحدث توفر مجموعة من المشغلات والروابط للاتصال بسهولة بخدمات Azure الأخرى.
مع التكامل بين Azure OpenAI و Functions، يمكنك إنشاء وظائف يمكنها:
| الإجراء | نوع المشغل/الربط |
|---|---|
| استخدام مطالبة نص قياسية لإكمال المحتوى | ربط إدخال إكمال نص Azure OpenAI |
| الاستجابة لطلب مساعد لاستدعاء دالة | مشغل مساعد Azure OpenAI |
| إنشاء مساعد | مساعد Azure OpenAI لإنشاء ربط الإخراج |
| إرسال رسالة إلى مساعد | ربط إدخال آخر لمساعد Azure OpenAI |
| الحصول على سجل المساعد | ربط إدخال استعلام مساعد Azure OpenAI |
| قراءة تضمينات النص | تضمين ربط الإدخال في Azure OpenAI |
| الكتابة إلى قاعدة بيانات متجهة | تخزن عمليات تضمين Azure OpenAI ربط الإخراج |
| القراءة من قاعدة بيانات متجهة | ربط إدخال البحث الدلالي ل Azure OpenAI |
تثبيت الملحق
تعتمد حزمة NuGet الملحقة التي تقوم بتثبيتها على وضع C# قيد المعالجة أو عملية العامل المعزولة التي تستخدمها في تطبيق الوظائف الخاص بك:
أضف ملحق Azure OpenAI إلى مشروعك عن طريق تثبيت حزمة Microsoft.Azure.Functions.Worker.Extensions.OpenAI NuGet، والتي يمكنك القيام بها باستخدام .NET CLI:
dotnet add package Microsoft.Azure.Functions.Worker.Extensions.OpenAI --prerelease
عند استخدام قاعدة بيانات متجهة لتخزين المحتوى، يجب عليك أيضا تثبيت حزمة واحدة على الأقل من حزم NuGet هذه:
- Azure الذكاء الاصطناعي Search: Microsoft.Azure.Functions.Worker.Extensions.OpenAI.AzureAISearch
- Azure Cosmos DB ل MongoDB: Microsoft.Azure.Functions.Worker.Extensions.OpenAI.CosmosDBSearch
- Azure Data Explorer: Microsoft.Azure.Functions.Worker.Extensions.OpenAI.Kusto
تثبيت الحزمة
يمكنك إضافة ملحق المعاينة عن طريق إضافة التعليمات البرمجية التالية أو استبدالها في الملف الخاص بك host.json ، والذي يستهدف على وجه التحديد إصدار معاينة من مجموعة 4.x التي تحتوي على ملحق OpenAI:
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
"version": "[4.*, 5.0.0)"
}
}
إعدادات التطبيق
لاستخدام ملحق ربط Azure OpenAI، تحتاج إلى إضافة واحد أو أكثر من هذه الإعدادات، والتي تستخدم للاتصال بمورد OpenAI الخاص بك. أثناء التطوير المحلي، تحتاج أيضا إلى إضافة هذه الإعدادات إلى ملفك local.settings.json .
| اسم الإعداد | الوصف |
|---|---|
AZURE_OPENAI_ENDPOINT |
مطلوب. تعيين نقطة النهاية لمورد OpenAI المستخدم بواسطة الروابط الخاصة بك. |
AZURE_OPENAI_KEY |
تعيين المفتاح المستخدم للوصول إلى مورد Azure OpenAI. |
OPENAI_API_KEY |
تعيين المفتاح المستخدم للوصول إلى مورد غير Azure OpenAI. |
AZURE_CLIENT_ID |
تعيين هوية مدارة معينة من قبل المستخدم تستخدم للوصول إلى مورد Azure OpenAI. |
لمزيد من المعلومات، راجع العمل مع إعدادات التطبيق.