Prompt API

Thomas Steiner
Alexandra Klepper

تاريخ النشر: 20 أيار (مايو) 2025

فيديو الشرح الويب الإضافات حالة Chrome النيّة بالشراء
Github تجريبية في EPP الإصدار التجريبي من Chrome الإصدار التجريبي من Chrome 137 العرض الرغبة في إجراء تجربة

باستخدام Prompt API، يمكنك إرسال طلبات بلغة طبيعية إلى Gemini Nano في المتصفّح.

تتوفّر واجهة برمجة التطبيقات Prompt API لإضافات Chrome. يمكن لمطوّري الويب استخدام واجهة برمجة التطبيقات الاستكشافية في Chrome Canary من خلال الانضمام إلى برنامج معاينة الإصدارات المبكرة. ستصبح واجهة برمجة التطبيقات هذه متوفرة قريبًا في مرحلة تجريبية.

هناك العديد من الطرق لاستخدام Prompt API. في تطبيق ويب أو موقع إلكتروني، يمكنك إنشاء ما يلي:

  • البحث المستنِد إلى الذكاء الاصطناعي: الإجابة عن الأسئلة استنادًا إلى محتوى صفحة ويب
  • خلاصات الأخبار المخصّصة: يمكنك إنشاء خلاصة لفهرسة المقالات ديناميكيًا حسب الفئات والسماح للمستخدمين بفلترة هذا المحتوى.

في "إضافات Chrome"، يمكنك إنشاء ما يلي:

  • أحداث التقويم: يمكنك تطوير إضافة Chrome تُستخرج تلقائيًا تفاصيل الأحداث من صفحات الويب، ما يتيح للمستخدمين إنشاء إدخالات تقويم ببضع خطوات فقط.
  • استخراج جهات الاتصال أنشئ إضافة تستخرج معلومات العميل من المواقع الإلكترونية، ما يسهّل على المستخدمين التواصل مع نشاط تجاري أو إضافة تفاصيل إلى قائمة جهات الاتصال.

هذه ليست سوى بعض الأفكار، ولكننا متحمّسون لرؤية ابتكاراتك.

استخدام Prompt API

تتوفّر لك وظيفتان رئيسيتان في مساحة الاسم LanguageModel:

  • availability() للاطّلاع على ميزات النموذج ومعرفة ما إذا كان متاحًا
  • create() لبدء جلسة نموذج لغوي

تنزيل النموذج

تستخدِم واجهة برمجة التطبيقات Prompt API نموذج Gemini Nano في Chrome. على الرغم من أنّ واجهة برمجة التطبيقات مدمجة في Chrome، يتم تنزيل النموذج بشكل منفصل في المرة الأولى التي تستخدم فيها إحدى الإضافات واجهة برمجة التطبيقات.

لتحديد ما إذا كان النموذج جاهزًا للاستخدام، استخدِم الدالة غير المتزامنة LanguageModel.availability(). من المفترض أن يعرض هذا الإجراء أحد الرسائل التالية:

  • يشير الرمز "unavailable" إلى أنّ المتصفّح لا يتيح الخيارات المطلوبة أو لا يتيح طلب نموذج لغوي على الإطلاق.
  • يشير الرمز "downloadable" إلى أنّ المتصفّح متوافق مع الخيارات المطلوبة، ولكنّه سيحتاج إلى تنزيل محتوى (مثل النموذج اللغوي نفسه أو تحسين) قبل أن يتمكّن من إنشاء جلسة باستخدام هذه الخيارات.
  • يشير الرمز "downloading" إلى أنّ المتصفّح يتيح الخيارات المطلوبة، ولكنّه سيحتاج إلى إنهاء عملية تنزيل جارية قبل أن يتمكّن من إنشاء جلسة باستخدام هذه الخيارات.
  • يشير الرمز "available" إلى أنّ المتصفّح يتيح الخيارات المطلوبة بدون الحاجة إلى تنزيل أي محتوى جديد.

إذا كان الردّ على availability() هو 'downloadable'، انتظِر اكتمال عملية التنزيل وأعلِم المستخدم في حال استغراق عملية التنزيل بعض الوقت.

const session = await LanguageModel.create({
  monitor(m) {
    m.addEventListener("downloadprogress", (e) => {
      console.log(`Downloaded ${e.loaded} of ${e.total} bytes.`);
    });
  },
});

الإمكانات المتعددة الوسائط

تتيح واجهة برمجة التطبيقات Prompt API إدخال الصوت والصور من الإصدار 138 من Chrome Canary لإجراء التجارب على الجهاز فقط. تعرض واجهة برمجة التطبيقات ناتجًا نصيًا.

باستخدام هذه الإمكانات، يمكنك إجراء ما يلي:

  • السماح للمستخدمين بتحويل الرسائل الصوتية المُرسَلة في تطبيق محادثة إلى نص
  • يُستخدَم هذا الحقل لوصف صورة تم تحميلها إلى موقعك الإلكتروني لاستخدامها في الترجمة أو النص البديل.

تساعدنا ملاحظاتك في تحديد مستقبل واجهة برمجة التطبيقات هذه و تحسينات Gemini Nano. وقد يؤدي ذلك أيضًا إلى توفير واجهات برمجة تطبيقات مخصّصة للمهام (مثل واجهات برمجة التطبيقات لتحويل الصوت إلى نص أو وصف الصور)، ما يضمن تلبية احتياجاتك واحتياجات المستخدمين.

المشاركة وتقديم الملاحظات

يمكن أن تؤثّر ملاحظاتك بشكل مباشر في كيفية إنشاء الإصدارات المستقبلية من واجهة برمجة التطبيقات هذه وجميع واجهات برمجة تطبيقات الذكاء الاصطناعي المضمّنة وتنفيذها.