الاستعلام عن نموذج تم تقديمه باستخدام ai_query()
توضح هذه المقالة كيفية الاستعلام عن نقطة نهاية خدمة نموذج من SQL باستخدام ai_query()
.
ما المقصود بـ ai_query()
؟
ai_query()
الدالة هي دالة Azure Databricks SQL مضمنة، وهي جزء من وظائف الذكاء الاصطناعي. يسمح بوصول هذه الأنواع من النماذج من استعلامات SQL:
- نماذج مخصصة تستضيفها نقطة نهاية خدمة نموذج.
- النماذج التي تستضيفها واجهات برمجة تطبيقات نموذج Databricks Foundation.
- النماذج الخارجية (نماذج الجهات الخارجية المستضافة خارج Databricks).
للحصول على أنماط بناء الجملة والتصميم، راجع الدالة ai_query.
عند استخدام هذه الدالة للاستعلام عن نقطة نهاية خدمة نموذج، فإنها متوفرة فقط في مساحات العمل والمناطق التي تتوفر فيها خدمة النموذج وتمكينها.
المتطلبات
- هذه الدالة غير متوفرة على Azure Databricks SQL Classic.
- يتم تمكين الاستعلام عن واجهات برمجة التطبيقات لنموذج الأساس بشكل افتراضي.
- للاستعلام عن نقاط النهاية التي تخدم نماذج مخصصة أو نماذج خارجية:
- تمكين الذكاء الاصطناعي_Query للنماذج المخصصة والنماذج الخارجية في واجهة مستخدم معاينات Databricks.
- راجع الاستعلام عن نموذج خارجي باستخدام ai_query().
- نموذج موجود يخدم نقطة نهاية مع تحميل النموذج الخاص بك. راجع إنشاء نقاط نهاية خدمة نموذج مخصص.
- يجب تمكين Azure Private Link لاستخدام هذه الميزة على مستودعات SQL pro.
الاستعلام عن نقطة النهاية باستخدام ai_query()
يمكنك الاستعلام عن النموذج خلف نقطة النهاية باستخدام ai_query()
على مستودعات SQL بلا خادم أو المحترفين. للحصول على تنسيقات طلب التسجيل والاستجابة، راجع نماذج أساسيات الاستعلام والنماذج الخارجية.
إشعار
- بالنسبة إلى Databricks Runtime 14.2 والإصدارات الأحدث، يتم دعم هذه الدالة في بيئات دفتر الملاحظات بما في ذلك دفاتر ملاحظات Databricks والمهام.
- بالنسبة إلى Databricks Runtime 14.1 والإصدارات أدناه، هذه الدالة غير مدعومة في بيئات دفتر الملاحظات، بما في ذلك دفاتر ملاحظات Databricks.
مثال: الاستعلام عن نموذج لغة كبير
يستعلم المثال التالي عن النموذج خلف sentiment-analysis
نقطة النهاية مع text
مجموعة البيانات ويحدد نوع الإرجاع للطلب.
SELECT text, ai_query(
"sentiment-analysis",
text,
returnType => "STRUCT<label:STRING, score:DOUBLE>"
) AS predict
FROM
catalog.schema.customer_reviews
مثال: الاستعلام عن نموذج تنبؤي
يستعلم المثال التالي عن نموذج تصنيف خلف spam-classification
نقطة النهاية لتوقع الدفعة text
ما إذا كان البريد العشوائي في inbox_messages
الجدول. يأخذ النموذج 3 ميزات إدخال: الطابع الزمني والمرسل والنص. يقوم النموذج بإرجاع صفيف منطقي.
SELECT text, ai_query(
endpoint => "spam-classification",
request => named_struct(
"timestamp", timestamp,
"sender", from_number,
"text", text),
returnType => "BOOLEAN") AS is_spam
FROM catalog.schema.inbox_messages