مشاركة عبر

ملحق Azure OpenAI ل Azure Functions

هام

ملحق Azure OpenAI ل Azure Functions قيد المعاينة حاليا.

ينفذ ملحق Azure OpenAI ل Azure Functions مجموعة من المشغلات والروابط التي تمكنك من دمج ميزات وسلوكيات Azure OpenAI بسهولة في نماذج Foundry في عمليات تنفيذ التعليمات البرمجية للدالة.

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 هذه:

تثبيت الحزمة

لكي تتمكن من استخدام ملحق ربط المعاينة هذا في تطبيقك، يجب عليك الرجوع إلى حزمة ملحق المعاينة التي تتضمنه.

أضف التعليمات البرمجية التالية أو استبدلها في ملفك host.json ، والتي تستهدف على وجه التحديد أحدث إصدار معاينة من حزمة 4.x:

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
    "version": "[4.0.0, 5.0.0)"
  }
}

حدد الارتباط السابق للتحقق من أن أحدث إصدار حزمة معاينة يحتوي على ملحق المعاينة.

الاتصال ب OpenAI

لاستخدام ملحق ربط Azure OpenAI، تحتاج إلى تحديد اتصال ب OpenAI. يتم تعريف هذا الاتصال باستخدام إعدادات التطبيق وخاصية AIConnectionName المشغل أو الربط. يمكنك أيضا استخدام متغيرات البيئة لتعريف الاتصالات المستندة إلى المفتاح.

نوصي باستخدام الاتصالات المدارة المستندة إلى الهوية والخاصية AIConnectionName .

تحتوي روابط OpenAI على AIConnectionName خاصية يمكنك استخدامها لتحديد <ConnectionNamePrefix> لهذه المجموعة من إعدادات التطبيق التي تحدد الاتصال ب Azure OpenAI:

اسم الإعداد ‏‏الوصف
<CONNECTION_NAME_PREFIX>__endpoint تعيين نقطة نهاية URI ل Azure OpenAI في Foundry Models. هذا الإعداد مطلوب دائما.
<CONNECTION_NAME_PREFIX>__clientId تعيين الهوية المعينة من قبل المستخدم لاستخدامها عند الحصول على رمز مميز للوصول. يتطلب تعيين <CONNECTION_NAME_PREFIX>__credential إلى managedidentity. وتقبل هذه الخاصية معرف عميل يطابق إحدى الهويات المعينة من قبل المستخدم والمحددة للتطبيق. من غير الصالح تحديد كل من معرف المورد ومعرف العميل. إذا لم يتم تحديدها، يتم استخدام الهوية المعينة من قبل النظام. يتم استخدام هذه الخاصية بشكل مختلف في سيناريوهات التطوير المحلي، عندما credential لا ينبغي تعيينها.
<CONNECTION_NAME_PREFIX>__credential يحدد كيفية الحصول على رمز مميز للوصول للاتصال. يستخدم managedidentity لمصادقة الهوية المدارة. هذه القيمة صالحة فقط عندما تتوفر هوية مدارة في بيئة الاستضافة.
<CONNECTION_NAME_PREFIX>__managedIdentityResourceId عند credential تعيين إلى managedidentity، يمكن تعيين هذه الخاصية لتحديد معرف المورد الذي سيتم استخدامه عند الحصول على رمز مميز. تقبل الخاصية معرف مورد يتوافق مع معرف المورد للهوية المدارة المعرفة من قبل المستخدم. من غير الصالح تحديد كل من معرف المورد ومعرف العميل. إذا لم يتم تحديد أي منهما، يتم استخدام الهوية المعينة من قبل النظام. يتم استخدام هذه الخاصية بشكل مختلف في سيناريوهات التطوير المحلي، عندما credential لا ينبغي تعيينها.
<CONNECTION_NAME_PREFIX>__key تعيين المفتاح السري المشترك المطلوب للوصول إلى نقطة نهاية Azure OpenAI باستخدام المصادقة المستندة إلى المفتاح. كأفضل ممارسة أمان، يجب عليك دائما استخدام معرف Microsoft Entra مع الهويات المدارة للمصادقة.

ضع في اعتبارك إعدادات اتصال الهوية المدارة هذه عند AIConnectionName تعيين الخاصية إلى myAzureOpenAI:

  • myAzureOpenAI__endpoint=https://contoso.openai.azure.com/
  • myAzureOpenAI__credential=managedidentity
  • myAzureOpenAI__clientId=aaaaaaaa-bbbb-cccc-1111-222222222222

في وقت التشغيل، يتم تفسير هذه الإعدادات بشكل جماعي من قبل المضيف على أنها إعداد واحد myAzureOpenAI مثل هذا:

"myAzureOpenAI":
{
    "endpoint": "https://contoso.openai.azure.com/",
    "credential": "managedidentity",
    "clientId": "aaaaaaaa-bbbb-cccc-1111-222222222222"
}

عند استخدام الهويات المدارة، تأكد من إضافة هويتك إلى دور مستخدم OpenAI للخدمات المعرفية .

عند التشغيل محليا، يجب إضافة هذه الإعدادات إلى ملف مشروع local.settings.json . لمزيد من المعلومات، راجع التطوير المحلي مع الاتصالات المستندة إلى الهوية.

لمزيد من المعلومات، راجع العمل مع إعدادات التطبيق.

المحتوى ذو الصلة

  • Last updated on