استيراد واجهة برمجة تطبيقات Azure OpenAI
ينطبق على: جميع مستويات إدارة واجهة برمجة التطبيقات
تعرض هذه المقالة خيارين لاستيراد واجهة برمجة تطبيقات خدمة Azure OpenAI إلى مثيل Azure API Management كواجهة برمجة تطبيقات REST:
- استيراد واجهة برمجة تطبيقات Azure OpenAI مباشرة من خدمة Azure OpenAI
- قم بتنزيل وإضافة مواصفات OpenAPI ل Azure OpenAI وإضافتها إلى APIM كواجهة برمجة تطبيقات OpenAPI.
المتطلبات الأساسية
مثيل APIM موجود. أنشئ واحد إذا لم تكن قد قمت بذلك بالفعل.
الوصول الممنوح إلى Azure OpenAI في اشتراك Azure المطلوب. يمكنك التقدم بطلب للوصول إلى Azure OpenAI عن طريق إكمال النموذج في https://aka.ms/oai/access. افتح مشكلة على هذا المستودع للاتصال بنا إذا كانت لديك مشكلة.
مورد Azure OpenAI مع نشر نموذج. لمزيد من المعلومات حول نشر النموذج، راجع دليل توزيع الموارد.
دون معرف (اسم) النشر. ستحتاج إليه عند اختبار واجهة برمجة التطبيقات المستوردة في APIM.
أذونات لمنح حق الوصول إلى مورد Azure OpenAI من مثيل APIM.
الخيار 1. استيراد واجهة برمجة التطبيقات من خدمة Azure OpenAI
يمكنك استيراد واجهة برمجة تطبيقات Azure OpenAI مباشرة إلى APIM من خدمة Azure OpenAI. عند استيراد واجهة برمجة التطبيقات، تقوم APIM تلقائيا بتكوين:
- عمليات لكل نقطة من نقاط نهاية Azure OpenAI REST API.
- هوية معينة من قبل النظام مع الأذونات اللازمة للوصول إلى مورد Azure OpenAI.
- مورد الواجهة الخلفية ونهج خدمة الواجهة الخلفية التي توجه طلبات واجهة برمجة التطبيقات إلى نقطة نهاية خدمة Azure OpenAI.
- نهج هوية مدارة بواسطة المصادقة يمكنه المصادقة على مورد Azure OpenAI باستخدام الهوية المعينة من قبل النظام للمثيل.
- (اختياريا) نهج لمساعدتك في مراقبة وإدارة استهلاك الرمز المميز بواسطة واجهة برمجة تطبيقات Azure OpenAI.
لاستيراد واجهة برمجة تطبيقات Azure OpenAI إلى APIM:
في مدخل Azure، انتقل إلى مثيل API Management الخاص بك.
في القائمة اليسرى، ضمن واجهات برمجة التطبيقات، حدد واجهات برمجة التطبيقات> + إضافة واجهة برمجة التطبيقات.
ضمن Create from Azure resource، حدد Azure OpenAI Service.
في علامة التبويب Basics:
حدد مورد Azure OpenAI الذي تريد استيراده.
اختياريا حدد إصدار Azure OpenAI API. إذا لم تحدد واحدا، فسيتم استخدام أحدث إصدار جاهز للإنتاج لواجهة برمجة تطبيقات REST بشكل افتراضي.
أدخل اسم العرض والوصف الاختياري لواجهة برمجة التطبيقات.
في Base URL، ألحق مسارا يستخدمه مثيل APIM للوصول إلى نقاط نهاية Azure OpenAI API. إذا قمت بتمكين التأكد من توافق OpenAI SDK (مستحسن)،
/openai
يتم إلحاقه تلقائيا بعنوان URL الأساسي.على سبيل المثال، إذا كانت نقطة نهاية بوابة API Management هي
https://contoso.azure-api.net
، فقم بتعيين عنوان URL أساسي مشابه لhttps://contoso.azure-api.net/my-openai-api/openai
.اختياريا حدد منتجا واحدا أو أكثر لإقرانه بواجهة برمجة التطبيقات. حدد التالي.
في علامة التبويب Policies ، قم بتمكين النهج اختياريا لمراقبة وإدارة استهلاك الرمز المميز لواجهة برمجة تطبيقات Azure OpenAI. إذا تم تحديدها، أدخل الإعدادات أو اقبل الإعدادات الافتراضية
azure-openai-token-limit
التي تحدد نهج وazure-openai-emit-token-metric
لواجهة برمجة التطبيقات الخاصة بك. يمكنك أيضا تعيين تكوين النهج أو تحديثه لاحقا. حدد "استعراض + إنشاء".بعد التحقق من صحة الإعدادات، حدد إنشاء.
الخيار 2. إضافة مواصفات OpenAPI إلى APIM
بدلا من ذلك، قم بتنزيل مواصفات OpenAPI يدويا لواجهة برمجة تطبيقات AZURE OpenAI REST وإضافتها إلى APIM كواجهة برمجة تطبيقات OpenAPI.
تنزيل مواصفات OpenAPI
قم بتنزيل مواصفات OpenAPI لواجهة برمجة تطبيقات AZURE OpenAI REST، مثل إصدار GA 2024-02-01.
في محرر نص، افتح ملف المواصفات الذي قمت بتنزيله.
servers
في العنصر في المواصفات، استبدل اسم نقطة نهاية خدمة Azure OpenAI في قيم العنصر النائب لurl
ونقطةdefault
النهاية في المواصفات. على سبيل المثال، إذا كانت نقطة نهاية خدمة Azure OpenAI هيcontoso.openai.azure.com
، فقم بتحديثservers
العنصر بالقيم التالية:- Url:
https://contoso.openai.azure.com/openai
- نقطة النهاية الافتراضية:
contoso.openai.azure.com
[...] "servers": [ { "url": "https://contoso.openai.azure.com/openai", "variables": { "endpoint": { "default": "contoso.openai.azure.com" } } } ], [...]
- Url:
دون قيمة واجهة برمجة التطبيقات
version
في المواصفات. ستحتاج إليه لاختبار واجهة برمجة التطبيقات. مثال:2024-02-01
.
إضافة مواصفات OpenAPI إلى APIM
- في مدخل Azure، انتقل إلى مثيل API Management الخاص بك.
- في القائمة اليسرى، حدد APIs>+ Add API.
- ضمن تعريف واجهة برمجة تطبيقات جديدة، حدد OpenAPI. أدخل اسم العرض والاسم لواجهة برمجة التطبيقات.
- أدخل لاحقة عنوان URL لواجهة برمجة التطبيقات تنتهي بالوصول
/openai
إلى نقاط نهاية Azure OpenAI API في مثيل API Management. مثال:my-openai-api/openai
. - حدد إنشاء.
يتم استيراد واجهة برمجة التطبيقات وعرض العمليات من مواصفات OpenAPI.
تكوين المصادقة إلى واجهة برمجة تطبيقات Azure OpenAI
للمصادقة على Azure OpenAI API، يمكنك توفير مفتاح API أو هوية مدارة. إذا قمت باستيراد واجهة برمجة تطبيقات Azure OpenAI مباشرة إلى مثيل APIM الخاص بك، يتم تكوين المصادقة باستخدام الهوية المدارة لمثيل APIM تلقائيا.
إذا أضفت واجهة برمجة تطبيقات Azure OpenAI من مواصفات OpenAPI الخاصة بها، فستحتاج إلى تكوين المصادقة. لمزيد من المعلومات حول تكوين المصادقة باستخدام نهج APIM، راجع المصادقة والتخويل لواجهة برمجة تطبيقات Azure OpenAI.
اختبار واجهة برمجة تطبيقات Azure OpenAI
للتأكد من أن واجهة برمجة تطبيقات Azure OpenAI تعمل كما هو متوقع، اختبرها في وحدة تحكم اختبار APIM. تحتاج إلى توفير معرف نشر نموذج (اسم) تم تكوينه في مورد Azure OpenAI لاختبار واجهة برمجة التطبيقات.
تحديد واجهة برمجة التطبيقات التي أنشأتها في الخطوة السابقة.
حدد علامة التبويب الاختبار.
حدد عملية متوافقة مع النموذج الذي قمت بنشره في مورد Azure OpenAI. تعرض الصفحة حقول المعلمات والرؤوس.
في معلمات القالب، أدخل القيم التالية:
أدخل معلمات وعناوين أخرى حسب الحاجة. اعتمادا على العملية، قد تحتاج إلى تكوين نص طلب أو تحديثه.
إشعار
في وحدة تحكم الاختبار، تقوم APIM تلقائيا بتعبئة عنوان Ocp-Apim-Subscription-Key، وتكوين مفتاح الاشتراك للاشتراك المضمن في الوصول بالكامل. يتيح هذا المفتاح الوصول إلى كل واجهة برمجة تطبيقات في مثيل APIM. عرض رأس Ocp-Apim-Subscription-Key اختياريا عن طريق تحديد أيقونة "العين" بجوار طلب HTTP.
حدد إرسال.
عند نجاح الاختبار، تستجيب الخلفية برمز استجابة HTTP ناجح وبعض البيانات. إلحاق الاستجابة هو بيانات استخدام الرمز المميز لمساعدتك في مراقبة وإدارة استهلاك واجهة برمجة تطبيقات Azure OpenAI.
نهج التخزين المؤقت لواجهات برمجة تطبيقات Azure OpenAI
بالإضافة إلى azure-openai-token-limit
النهج و azure-openai-emit-token-metric
التي يمكنك تكوينها عند استيراد واجهة برمجة تطبيقات خدمة Azure OpenAI، توفر APIM نهج التخزين المؤقت التالية لمساعدتك على تحسين الأداء وتقليل زمن الانتقال لواجهات برمجة تطبيقات Azure OpenAI:
azure-openai-semantic-cache-store
azure-openai-semantic-cache-lookup
المحتوى ذو الصلة
- مرجع نهج إدارة واجهة برمجة التطبيقات
- خدمة Azure OpenAI كقدرة مركزية مع Azure API Management
- Azure API Management - عينة Azure OpenAI
المواضيع ذات الصلة
- قيود استيراد API
- استيراد مواصفة OpenAPI
- استيراد واجهة برمجة تطبيقات SOAP
- استيراد واجهة برمجة تطبيقات SOAP وتحويلها إلى REST
- استيراد واجهة برمجة تطبيقات App Service
- استيراد واجهة برمجة تطبيقات تطبيق حاوية
- استيراد واجهة برمجة تطبيقات WebSocket
- استيراد واجهة برمجة تطبيقات GraphQL
- استيراد مخطط GraphQL وإعداد محللات الحقول
- تشغيل واجهة برمجة تطبيقات دالة Azure
- استيراد تطبيق Azure Logic
- استيراد خدمة Service Fabric
- استيراد واجهة برمجة تطبيقات Azure OpenAI
- استيراد واجهة برمجة تطبيقات OData
- استيراد بيانات التعريف لـ SAP OData
- استيراد واجهة برمجة تطبيقات gRPC
- تحرير واجهة برمجة تطبيقات
الملاحظات
https://aka.ms/ContentUserFeedback.
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجعإرسال الملاحظات وعرضها المتعلقة بـ