مشاركة عبر

استيراد واجهة برمجة تطبيقات Azure OpenAI

ينطبق على: جميع مستويات إدارة واجهة برمجة التطبيقات

يمكنك استيراد نقاط نهاية نموذج الذكاء الاصطناعي المنشورة في خدمة Azure OpenAI إلى مثيل APIM كواجهة برمجة تطبيقات REST. استخدم نهج البوابة الذكاء الاصطناعي والقدرات الأخرى في APIM لتبسيط التكامل وتحسين إمكانية الملاحظة وتعزيز التحكم في نقاط نهاية النموذج.

توضح هذه المقالة خيارين لاستيراد واجهة برمجة تطبيقات Azure OpenAI إلى مثيل Azure API Management كواجهة برمجة تطبيقات REST:

تعرف على المزيد حول إدارة واجهات برمجة التطبيقات الذكاء الاصطناعي في APIM:

المتطلبات الأساسية

الخيار 1. استيراد واجهة برمجة التطبيقات من خدمة Azure OpenAI

يمكنك استيراد واجهة برمجة تطبيقات Azure OpenAI مباشرة من خدمة Azure OpenAI إلى APIM.

إشعار

حاليا، هذه الميزة غير متوفرة في مساحات العمل.

عند استيراد واجهة برمجة التطبيقات، تقوم APIM تلقائيا بتكوين:

  • عمليات لكل نقطة من نقاط نهاية Azure OpenAI REST API
  • هوية معينة من قبل النظام مع الأذونات اللازمة للوصول إلى مورد Azure OpenAI.
  • مورد الواجهة الخلفية ونهج خدمة الواجهة الخلفية التي توجه طلبات واجهة برمجة التطبيقات إلى نقطة نهاية خدمة Azure OpenAI.
  • المصادقة على خلفية Azure OpenAI باستخدام الهوية المدارة المعينة من قبل النظام للمثيل.
  • (اختياريا) نهج لمساعدتك في مراقبة وإدارة واجهة برمجة تطبيقات Azure OpenAI.

لاستيراد واجهة برمجة تطبيقات Azure OpenAI إلى APIM:

  1. في مدخل Azure، انتقل إلى مثيل API Management الخاص بك.

  2. في القائمة اليسرى، ضمن واجهات برمجة التطبيقات، حدد واجهات برمجة التطبيقات> + إضافة واجهة برمجة التطبيقات.

  3. ضمن Create from Azure resource، حدد Azure OpenAI Service.

    لقطة شاشة لإنشاء واجهة برمجة تطبيقات من خدمة Azure OpenAI في المدخل.

  4. في علامة التبويب Basics:

    1. حدد مورد Azure OpenAI الذي تريد استيراده.

    2. اختياريا حدد إصدار Azure OpenAI API. إذا لم تحدد واحدا، استخدام أحدث إصدار جاهز للإنتاج لواجهة برمجة تطبيقات REST بشكل افتراضي. دون ملاحظة عن الإصدار الذي حددته. ستحتاج إليه لاختبار واجهة برمجة التطبيقات.

    3. أدخل اسم العرض والوصف الاختياري لواجهة برمجة التطبيقات.

    4. في 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.

    5. اختياريا حدد منتجا واحدا أو أكثر لإقرانه بواجهة برمجة التطبيقات. حدد التالي.

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

    إذا تم تحديدها، أدخل الإعدادات أو اقبل الإعدادات الافتراضية التي تحدد النهج التالية (راجع المقالات المرتبطة للحصول على المتطلبات الأساسية وتفاصيل التكوين):

    حدد "استعراض + إنشاء".

  6. بعد التحقق من صحة الإعدادات، حدد إنشاء.

الخيار 2. إضافة مواصفات OpenAPI إلى APIM

بدلا من ذلك، قم بتنزيل مواصفات OpenAPI يدويا لواجهة برمجة تطبيقات AZURE OpenAI REST وإضافتها إلى APIM كواجهة برمجة تطبيقات OpenAPI.

تنزيل مواصفات OpenAPI

قم بتنزيل مواصفات OpenAPI لواجهة برمجة تطبيقات AZURE OpenAI REST، مثل إصدار GA 2024-10-21.

  1. في محرر نص، افتح ملف المواصفات الذي قمت بتنزيله.

  2. 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"
        }
      }
    }
  ],
[...]

  3. دون قيمة واجهة برمجة التطبيقات version في المواصفات. ستحتاج إليه لاختبار واجهة برمجة التطبيقات. مثال:2024-10-21.

إضافة مواصفات OpenAPI إلى APIM

  1. في مدخل Azure، انتقل إلى مثيل API Management الخاص بك.
  2. في القائمة اليسرى، حدد APIs>+ Add API.
  3. ضمن تعريف واجهة برمجة تطبيقات جديدة، حدد OpenAPI. أدخل اسم العرض والاسم لواجهة برمجة التطبيقات.
  4. أدخل لاحقة عنوان URL لواجهة برمجة التطبيقات تنتهي بالوصول /openai إلى نقاط نهاية Azure OpenAI API في مثيل API Management. مثال:my-openai-api/openai.
  5. حدد إنشاء.

يتم استيراد واجهة برمجة التطبيقات وعرض العمليات من مواصفات OpenAPI.

تكوين المصادقة إلى واجهة برمجة تطبيقات Azure OpenAI

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

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

اختبار واجهة برمجة تطبيقات Azure OpenAI

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

  1. تحديد واجهة برمجة التطبيقات التي أنشأتها في الخطوة السابقة.

  2. حدد علامة التبويب الاختبار.

  3. حدد عملية متوافقة مع النموذج الذي قمت بنشره في مورد Azure OpenAI. تعرض الصفحة حقول المعلمات والرؤوس.

  4. في معلمات القالب، أدخل القيم التالية:

    • deployment-id - معرف التوزيع في خدمة Azure OpenAI
    • api-version - إصدار Azure OpenAI API صالح، مثل إصدار واجهة برمجة التطبيقات الذي حددته عند استيراد واجهة برمجة التطبيقات. لقطة شاشة لاختبار واجهة برمجة تطبيقات خدمة Azure OpenAI في المدخل.

  5. أدخل معلمات وعناوين أخرى حسب الحاجة. اعتمادا على العملية، قد تحتاج إلى تكوين نص طلب أو تحديثه.

    إشعار

    في وحدة تحكم الاختبار، تقوم APIM تلقائيا بتعبئة عنوان Ocp-Apim-Subscription-Key، وتكوين مفتاح الاشتراك للاشتراك المضمن في الوصول بالكامل. يتيح هذا المفتاح الوصول إلى كل واجهة برمجة تطبيقات في مثيل APIM. عرض رأس Ocp-Apim-Subscription-Key اختياريا عن طريق تحديد أيقونة "العين" بجوار طلب HTTP.

  6. حدد إرسال.

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

    لقطة شاشة لبيانات استخدام الرمز المميز في استجابة واجهة برمجة التطبيقات في المدخل.

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