مشاركة عبر

الاستعلام عن نموذج تم تقديمه باستخدام ai_query()

  • مقالة

هام

هذه الميزة في المعاينة العامة.

توضح هذه المقالة كيفية الاستعلام عن نقطة نهاية خدمة نموذج من SQL باستخدام ai_query().

ما المقصود بـ ai_query()؟

ai_query() الدالة هي دالة Azure Databricks SQL مضمنة، وهي جزء من وظائف الذكاء الاصطناعي. يسمح بوصول هذه الأنواع من النماذج من استعلامات SQL:

  • نماذج مخصصة تستضيفها نقطة نهاية خدمة نموذج.
  • النماذج التي تستضيفها واجهات برمجة تطبيقات نموذج Databricks Foundation.
  • النماذج الخارجية (نماذج الجهات الخارجية المستضافة خارج Databricks).

للحصول على أنماط بناء الجملة والتصميم، راجع الدالة ai_query.

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

المتطلبات

الاستعلام عن نقطة النهاية باستخدام 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