استيراد واجهة برمجة تطبيقات Microsoft Foundry

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

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

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

خيارات توافق العميل

تدعم إدارة واجهات برمجة التطبيقات خيارات توافق العملاء التالية لواجهات برمجة التطبيقات الذكية من Microsoft Foundry. عند استيراد واجهة برمجة التطبيقات باستخدام المعالج، اختر الخيار المناسب لنشر النموذج الخاص بك. يحدد الخيار كيف يستدعي العملاء الواجهة وكيف يوجه مثيل إدارة واجهة برمجة التطبيقات الطلبات إلى أداة Foundry.

  • Azure OpenAI: إدارة Azure OpenAI في نشر نماذج Microsoft Foundry.

    يتصل العملاء بالنشر عند /openai نقطة نهاية مثل /openai/deployments/my-deployment/chat/completions. يتضمن مسار الطلب اسم النشر. استخدم هذا الخيار إذا كانت أداة Foundry الخاصة بك تتضمن فقط نشر نماذج Azure OpenAI.

  • Azure AI: إدارة نقاط نهاية النماذج في Microsoft Foundry التي يتم عرضها من خلال واجهة Azure AI Model Inference API.

    يتصل العملاء بالنشر عند /models نقطة نهاية مثل /my-model/models/chat/completions. يتضمن جسم الطلب اسم النشر. استخدم هذا الخيار إذا كنت تريد مرونة للتبديل بين النماذج المعروضة عبر واجهة برمجة تطبيقات Azure AI Model Inference وتلك المنشورة في Azure OpenAI في نماذج Foundry.

  • Azure OpenAI v1 - إدارة Azure OpenAI في نشر نماذج Microsoft Foundry، باستخدام واجهة API Azure OpenAI الإصدار 1.

    يقوم العملاء باستدعاء النشر عند نقطة نهاية نموذج Azure OpenAI v1 مثل openai/v1/my-model/chat/completions. يتضمن جسم الطلب اسم النشر.

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

استيراد واجهة برمجة تطبيقات Microsoft Foundry باستخدام البوابة

استخدم الخطوات التالية لاستيراد واجهة برمجة تطبيقات الذكاء الاصطناعي إلى APIM.

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

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

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

  1. في بوابة Azure، اذهب إلى مثيل إدارة واجهة برمجة التطبيقات الخاصة بك.

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

  3. تحت Create from Azure resource، اختر Microsoft Foundry.

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

  4. في تبويب اختيار خدمة الذكاء الاصطناعي :

    1. اختر الاشتراك الذي تبحث فيه عن أدوات المسبك. للحصول على معلومات حول عمليات نشر النموذج في خدمة، حدد ارتباط عمليات التوزيع بجوار اسم الخدمة. لقطة شاشة لعمليات نشر لخدمة ذكاء اصطناعي في البوابة.
    2. اختر أداة Foundry.
    3. حدد التالي.

  5. في علامة التبويب تكوين واجهة برمجة التطبيقات :

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

    2. في المسار الأساسي، أدخل مسارا يستخدمه مثيل APIM للوصول إلى نقطة نهاية النشر.

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

    4. في توافق العميل، اختر أحد الخيارات التالية بناء على أنواع العملاء الذين تنوي دعمهم. راجع خيارات توافق العميل للحصول على مزيد من المعلومات.

      • Azure OpenAI - اختر هذا الخيار إذا كان عملاؤك بحاجة فقط للوصول إلى Azure OpenAI في نشر نماذج Microsoft Foundry.
      • Azure AI - اختر هذا الخيار إذا كان عملاؤك بحاجة للوصول إلى نماذج أخرى في Microsoft Foundry.
      • Azure OpenAI v1 - اختر هذا الخيار إذا كنت ترغب في استخدام واجهة برمجة تطبيقات Azure OpenAI الإصدار 1 مع نشر نماذج Foundry الخاصة بك.

    5. حدد التالي.

      لقطة شاشة لتكوين واجهة برمجة تطبيقات Microsoft Foundry في البوابة.

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

  7. في تبويب تطبيق التخزين المؤقت الدلالي ، يمكنك إدخال الإعدادات أو قبول الإعدادات الافتراضية التي تحدد السياسات لتحسين الأداء وتقليل زمن الاستجابة لواجهة برمجة التطبيقات:

  8. في تبويب سلامة المحتوى الخاص بالذكاء الاصطناعي ، يمكنك إدخال الإعدادات أو قبول الإعدادات الافتراضية لتكوين خدمة Azure AI Content Safety لحجب الإشعارات التي تحتوي على محتوى غير آمن:

  9. حدد "Review".

  10. بعد أن تحقق البوابة من الإعدادات، اختر الإنشاء.

اختبار واجهة برمجة تطبيقات الذكاء الاصطناعي

للتأكد من أن واجهة برمجة تطبيقات الذكاء الاصطناعي تعمل كما هو متوقع، اختبرها في وحدة اختبار إدارة واجهات البرمجة (API).

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

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

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

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

    {
  "model": "any",
  "messages": [
    {
      "role": "user",
      "content": "Help me plan a trip to Paris",
      "max_tokens": 100
    }
  ]
}

    ‏‫ملاحظة

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

  5. حدد إرسال.

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

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

  • Last updated on