تُعدّ مراقبة التكاليف والاستخدام والمقاييس الأخرى للميزات التي تستخدم الذكاء الاصطناعي جزءًا مهمًا من تشغيل تطبيق إنتاجي. عليك معرفة أنماط الاستخدام العادية لتطبيقك والتأكّد من عدم تجاوز الحدود التي تهمّك.
توضّح هذه الصفحة بعض الخيارات المقترَحة لمراقبة التكاليف والاستخدام والمقاييس الأخرى في كلّ من وحدة تحكّم Firebase ووحدة تحكّم Google Cloud.
مراقبة التكاليف
في لوحة بيانات الاستخدام والفوترة ضمن وحدة تحكّم Firebase، يمكنك الاطّلاع على تكاليف مشروعك لاستدعاء Agent Platform Gemini API (formerly Vertex AI) وGemini Developer API (عند استخدام خطة Blaze المَرِنة).
التكاليف المعروضة في لوحة البيانات ليست بالضرورة خاصة بالمكالمات التي تستخدم حِزم تطوير البرامج (SDK) لعميل Firebase AI Logic. ترتبط التكاليف المعروضة بأي طلبات إلى "واجهات برمجة تطبيقات Gemini"، سواء كانت تستخدم حِزم تطوير البرامج (SDK) لعميل Firebase AI Logic أو حِزم تطوير البرامج (SDK) لخادم Google GenAI أو Genkit أو Firebase Extensions لـ Gemini API أو طلبات REST أو أحد إصدارات AI Studio أو عملاء واجهة برمجة التطبيقات الآخرين.
مزيد من المعلومات حول الأسعار للمنتجات المرتبطة باستخدامك لـ "Firebase AI Logic"
إعداد تنبيهات الميزانية والحدود القصوى للإنفاق
عند استخدام خطة Blaze المَرِنة، يمكنك تجنُّب الفواتير المفاجئة من خلال إعداد تنبيهات بشأن الميزانية والحدود القصوى للإنفاق.
يُرجى العِلم أنّ تنبيهات الميزانية ليست حدودًا قصوى للإنفاق في الميزانية. سيتم إرسال رسائل إلكترونية تحذيرية إليك عندما يصل إنفاقك إلى حدود معيّنة من ميزانيتك، لكي تتمكّن من اتّخاذ الإجراءات في تطبيقك أو مشروعك. يجب ضبط ميزانية حدّ الإنفاق الأقصى إذا أردت إيقاف الخدمة مؤقتًا عند الوصول إلى ميزانيتك.
مراقبة استخدام ميزات الذكاء الاصطناعي في وحدة تحكّم "Firebase"
يمكنك تفعيل ميزة تتبُّع استخدام الذكاء الاصطناعي في صفحة Firebase AI Logic ضمن وحدة تحكّم Firebase لتتمكّن من تتبُّع مختلف المقاييس والاستخدام على مستوى التطبيق والحصول على رؤية شاملة لطلباتك من حِزم تطوير البرامج (SDK) لبرنامج عميل Firebase AI Logic. توفّر لوحات البيانات هذه معلومات أكثر تفصيلاً من عدد الرموز المميّزة الأساسية التي تحصل عليها من طلب إلى Count Tokens API.
تشمل الإمكانات الرئيسية لميزة تتبُّع استخدام الذكاء الاصطناعي في وحدة تحكّم Firebase ما يلي:
الاطّلاع على المقاييس الكمية، مثل حجم الطلبات ووقت الاستجابة والأخطاء واستخدام الرموز المميّزة لكل طريقة في كل تطبيق من تطبيقاتك
فحص عمليات التتبُّع للاطّلاع على سمات طلباتك ومدخلاتها ومخرجاتها، ما يساعد في تصحيح الأخطاء وتحسين الجودة
تقسيم البيانات حسب سمات مثل حالة الطلب والحد الأدنى لوقت الاستجابة واسم النموذج وغير ذلك
تم إنشاء كل هذه الميزات باستخدام Google Cloud Observability Suite (يمكنك الاطّلاع على معلومات المنتج التفصيلية أدناه).
تفعيل ميزة "تتبّع استخدام الذكاء الاصطناعي"
في ما يلي الطرق التي يمكنك من خلالها تفعيل ميزة تتبُّع استخدام الذكاء الاصطناعي في وحدة تحكّم Firebase:
عند اتّباع خطوات سير العمل الإرشادية الأولية للإعداد من صفحة خدمات الذكاء الاصطناعي > Firebase AI Logic
في أي وقت من خلال الانتقال إلى خدمات الذكاء الاصطناعي > منطق الذكاء الاصطناعي > علامة التبويب الإعدادات
متطلبات تفعيل ميزة "تتبُّع استخدام الذكاء الاصطناعي" واستخدامها:
يجب أن تكون مالك المشروع أو محرِّرًا أو مشرفًا في Firebase Vertex AI.
يجب أن يستخدم تطبيقك على الأقل إصدارات مكتبة Firebase التالية:
iOS+: الإصدار 11.13.0 أو إصدار أحدث | Android: الإصدار 16.0.0 أو إصدار أحدث (قائمة المواد: الإصدار 33.14.0 أو إصدار أحدث) | الويب: الإصدار 11.8.0 أو إصدار أحدث | Flutter: الإصدار 2.0.0 أو إصدار أحدث (قائمة المواد: الإصدار 3.11.0 أو إصدار أحدث) | Unity: الإصدار 12.9.0 أو إصدار أحدثيجب أن يكون خيار الموافقة على جمع البيانات مفعَّلاً في تطبيقك (يتم تفعيله تلقائيًا).
بعد استيفاء تطبيقك لهذه المتطلبات وتفعيل ميزة تتبُّع استخدام الذكاء الاصطناعي في وحدة التحكّم، لن تحتاج إلى اتّخاذ أي إجراء آخر في تطبيقك أو في وحدة التحكّم لبدء الاطّلاع على البيانات التي تملأ لوحات البيانات في علامة التبويب خدمات الذكاء الاصطناعي > منطق الذكاء الاصطناعي > تتبُّع استخدام الذكاء الاصطناعي. قد يحدث تأخير بسيط (يصل أحيانًا إلى 5 دقائق) قبل أن تصبح بيانات القياس عن بُعد من طلب معيّن متاحة في وحدة تحكّم Firebase.
الاستخدام المتقدّم
يصف هذا القسم إعداد معدّل البيانات في الملف الصوتي، بالإضافة إلى الخيارات المختلفة لعرض بياناتك والتعامل معها.
معدّل البيانات في الملف الصوتي
إذا كنت تُجري عددًا كبيرًا من الطلبات، ننصحك بالاستفادة من إعدادات معدّل البيانات في الملف الصوتي. يشير معدّل تحليل العينات إلى نسبة الطلبات التي يتم جمع تفاصيل التتبُّع لها فعليًا.
في علامة التبويب خدمات الذكاء الاصطناعي > AI Logic > الإعدادات ضمن وحدة تحكّم Firebase، يمكنك ضبط معدّل البيانات في الملف الصوتي لمشروعك على قيمة تتراوح بين %1 و%100، حيث تعني القيمة %100 أنّ ميزة "تتبّع استخدام الذكاء الاصطناعي" ستجمع بيانات التتبّع من كل زياراتك. القيمة التلقائية هي %100. سيؤدي جمع عدد أقل من عمليات التتبُّع إلى تقليل التكاليف، ولكنه سيؤدي أيضًا إلى تقليل عدد عمليات التتبُّع التي يمكنك مراقبتها. يُرجى العِلم أنّه بغض النظر عن معدّل البيانات في الملف الصوتي، ستعكس الرسوم البيانية المعروضة في لوحة بيانات المراقبة دائمًا الحجم الفعلي لعدد الزيارات.
خيارات إضافية خارج وحدة تحكّم Firebase
بالإضافة إلى ميزة تتبُّع استخدام الذكاء الاصطناعي المتاحة في وحدة تحكّم Firebase، يمكنك استخدام الخيارات التالية:
استكشِف Model Garden في Vertex AI.
توفّر لوحات البيانات هذه مزيدًا من الإحصاءات حول مؤشرات وقت الاستجابة ومعدّل النقل للنماذج المُدارة، ما يكمّل الإحصاءات التي تحصل عليها من ميزة تتبُّع استخدام الذكاء الاصطناعي في وحدة تحكّم Firebase.استكشاف بياناتك واستخدامها من خلال Google Cloud Observability Suite
بما أنّ بيانات القياس عن بُعد لتتبُّع استخدام الذكاء الاصطناعي يتم تخزينها في Google Cloud Observability Suite المرتبط بمشروعك، يمكنك استكشاف بياناتك في لوحات البيانات، بما في ذلك Trace Explorer وLogs Explorer، اللذان يتم ربطهما عند فحص عمليات التتبُّع الفردية في وحدة تحكّم Firebase. يمكنك أيضًا استخدام بياناتك لإنشاء لوحات بيانات مخصّصة وإعداد التنبيهات والمزيد.
معلومات تفصيلية عن المنتجات المستخدَمة لتتبُّع استخدام الذكاء الاصطناعي
تخزّن ميزة "تتبّع استخدام الذكاء الاصطناعي" بيانات القياس عن بُعد في منتجات مختلفة متاحة في Google Cloud Observability Suite، بما في ذلك Cloud Monitoring وCloud Trace وCloud Logging.
Cloud Monitoring: يخزّن المقاييس، بما في ذلك عدد الطلبات ومعدّل النجاح ووقت استجابة الطلب.
Cloud Trace: يخزّن آثار كل طلب من طلباتك حتى تتمكّن من عرض التفاصيل بشكل فردي بدلاً من عرضها بشكل مجمّع. عادةً ما يرتبط التتبُّع بالسجلات لتتمكّن من فحص محتوى كل تفاعل وتوقيته.
Cloud Logging: تلتقط البيانات الوصفية للإدخال والإخراج والإعدادات لتقديم تفاصيل غنية حول كل جزء من طلب الذكاء الاصطناعي.
بما أنّ بيانات القياس عن بُعد يتم تخزينها في هذه المنتجات، يمكنك تحديد إعدادات الاحتفاظ بالبيانات والوصول إليها مباشرةً في كل منتج (يمكنك الاطّلاع على مزيد من المعلومات في مستندات Cloud Monitoring وCloud Trace وCloud Logging).
يُرجى العِلم أنّ ميزة تتبّع استخدام الذكاء الاصطناعي تخزّن الطلبات الفعلية والنتائج التي تم إنشاؤها من كل طلب تم اختياره كعيّنة في Cloud Logging لكي تكون هذه البيانات متاحة في وحدة تحكّم Firebase. يمكنك اختياريًا إيقاف تخزين الطلبات والردود.
الأسعار
المشاريع التي تستخدم خطة Spark الأساسية (متاحة فقط عند استخدام Gemini Developer API): يكون استخدام الخدمات الأساسية لتتبُّع استخدام الذكاء الاصطناعي بدون أي تكلفة.
المشاريع التي تستخدم خطة Blaze المَرِنة: سيتم تحصيل رسوم منك مقابل استخدام منتجات Google Cloud Observability Suite الأساسية التي تستخدمها ميزة تتبُّع استخدام الذكاء الاصطناعي (بغض النظر عن مقدّم خدمة Gemini API الذي اخترته). ومع ذلك، يتضمّن كل منتج من منتجات "Google Cloud Observability Suite" مستويات مجانية سخية. يمكنك الاطّلاع على مزيد من المعلومات في مستندات أسعار Google Cloud Observability Suite.
(اختياري) إيقاف تخزين الطلبات والردود
بشكل تلقائي، تسجّل ميزة "تتبّع استخدام الذكاء الاصطناعي" الطلبات الفعلية المُرسَلة إلى النموذج والردود التي ينشئها، بما في ذلك أي معلومات حساسة (مثل معلومات تكشف الهوية الشخصية) في هذه الطلبات والردود. يتم تخزين كل هذه البيانات في Cloud Logging لتكون متاحة في وحدة تحكّم Firebase.
لإيقاف تخزين الطلبات والردود، أضِف فلتر الاستبعاد التالي إلى مستودع Cloud Logging (عادةً مستودع _Default): resource.type="firebasevertexai.googleapis.com/Model"
عرض مقاييس واجهة برمجة التطبيقات على مستوى المشروع في وحدة تحكّم "Google Cloud"
لكل واجهة برمجة تطبيقات، يمكنك الاطّلاع على المقاييس على مستوى المشروع، مثل الاستخدام، في وحدة تحكّم Google Cloud.
يُرجى العِلم أنّ صفحات وحدة تحكّم Google Cloud الموضّحة في هذا القسم لا تتضمّن معلومات مثل محتوى الطلب والاستجابة وعدد الرموز المميّزة. لتتبُّع هذا النوع من المعلومات، ننصحك باستخدام ميزة تتبُّع استخدام الذكاء الاصطناعي في وحدة تحكّم Firebase (يُرجى الاطّلاع على القسم السابق).
في وحدة تحكّم Google Cloud، انتقِل إلى صفحة المقاييس لواجهة برمجة التطبيقات التي تريد الاطّلاع عليها:
واجهة برمجة التطبيقات Agent Platform: يمكنك الاطّلاع على الاستخدام المرتبط بأي طلب إلى Agent Platform Gemini API (formerly Vertex AI).
- تشمل الطلبات التي تستخدم حِزم تطوير البرامج (SDK) لبرامج عملاء Firebase AI Logic، وحِزم تطوير البرامج (SDK) لخوادم Google GenAI، وGenkit، وFirebase Extensions لـ Gemini API، وREST API، وAgent Studio، وما إلى ذلك.
Gemini Developer API: يمكنك الاطّلاع على الاستخدام المرتبط بأي طلب إلى Gemini Developer API.
- ويشمل ذلك الطلبات التي تستخدم حِزم تطوير البرامج (SDK) لبرامج Firebase AI Logic، وحِزم تطوير البرامج (SDK) لخادم Google GenAI، وGenkit، وFirebase Extensions لـ Gemini API، وREST API، وGoogle AI Studio، وما إلى ذلك.
- الاسم المعروض لواجهة برمجة التطبيقات هذه في وحدة تحكّم Google Cloud هو "Generative Language API".
إذا كنت في "صفحة النظرة العامة" لواجهة برمجة التطبيقات، انقر على إدارة، ثم انقر على علامة التبويب المقاييس.
استخدِم القوائم المنسدلة لعرض المقاييس التي تهمّك، مثل عدد الزيارات حسب رمز الاستجابة والأخطاء حسب طريقة واجهة برمجة التطبيقات ووقت الاستجابة الإجمالي ووقت الاستجابة حسب طريقة واجهة برمجة التطبيقات.