دمج خدمات Firebase باستخدام ميزة "المساعدة المستنِدة إلى الذكاء الاصطناعي"

يمكنك تبسيط عملية إعداد Firebase لتطبيقات الويب باستخدام أدوات تطوير مستنِدة إلى الذكاء الاصطناعي ، مثل Antigravity وClaude Code وCodex وCursor. من خلال استخدام مهارات وكلاء Firebase جنبًا إلى جنب مع Firebase واجهة سطر الأوامر (CLI) وخادم بروتوكول سياق النموذج (MCP) لمنصة Firebase، يمكنك تحويل وكيل الترميز المستنِد إلى الذكاء الاصطناعي إلى خبير متخصّص في Firebase يمكنه كتابة الرموز البرمجية، وضبط Firebase Security Rules، وإدارة الموارد المباشرة.

يغطّي هذا الدليل كيفية استخدام وكيل ترميز مستنِد إلى الذكاء الاصطناعي للمساعدة في إعداد Cloud Firestore, Authentication, وFirebase Hosting لتطبيق ويب. يُرجى مراجعة هذه الصفحة قريبًا للحصول على معلومات حول تطبيقات iOS وAndroid وFlutter.

لماذا يجب استخدام مهارات وأدوات وكلاء Firebase؟

تواجه نماذج الذكاء الاصطناعي العامة غالبًا صعوبة في التعامل مع إعدادات مشاريع معيّنة أو معلومات قديمة. وتسدّ مجموعة الأدوات هذه هذه الفجوة:

• مهارات وكلاء Firebase: تزوّد المهارات وكيل الترميز بـ الخبرة في المجال. وتوفّر له مستندات حديثة وسير عمل مثاليًا لكي يعرف الطريقة الصحيحة التي توصي بها Firebase لتنظيم بنيتك.
• خادم بروتوكول سياق النموذج (MCP) لمنصة Firebase: يمنح خادم MCP وكيل الترميز السياق وإمكانية الوصول. ويضع بروتوكولاً موحّدًا لكي يتمكّن الوكيل من فحص موارد مشروعك النشطة والملفات المحلية والإعدادات بشكل آلي.
• Firebase واجهة سطر الأوامر: تمنح واجهة سطر الأوامر وكيل الترميز إمكانية اتّخاذ إجراءات. وهي أداة التنفيذ التي يستخدمها الوكيل لإجراء المهام الصعبة، مثل بدء قواعد البيانات وإدارة إعدادات مصادقة المستخدمين ونشر الرموز البرمجية نيابةً عنك.

يمنح استخدام مهارات وكلاء Firebase جنبًا إلى جنب مع واجهة سطر الأوامر (CLI) Firebase وخادم بروتوكول سياق النموذج (MCP) لمنصة Firebase وكيل الترميز المستنِد إلى الذكاء الاصطناعي قدرات إضافية:

• اتّخاذ الإجراءات: يمكنك إجراء أكثر من مجرد كتابة الرموز البرمجية. يمكن لوكيلك بدء الخدمات وإدارة مستخدمي Authentication ونشر Firebase Security Rules والعمل مباشرةً مع بيانات Cloud Firestore.
• البقاء على اطّلاع دائم: يمكنك استخدام طلبات رسمية تتضمّن معلومات عن الإصدار لإرشاد وكيلك خلال مهام الإعداد.
• تحسين الدقة: يمكنك الوصول إلى بيئة مشروعك ومخططاته لتقديم مساعدة أكثر صلة ودقة.
• تقليل تكاليف الرموز المميّزة: لا تحمّل مهارات الوكلاء مستندات تفصيلية إلا عندما تتطلّب مهمة معيّنة ذلك، ما يقلّل من النفقات العامة للجلسة.

ما هي خدمات Firebase التي يمكن أن تساعد فيها مهارات وأدوات الوكلاء؟

يركّز هذا الدليل بشكل أساسي على كيفية عمل مهارات الوكلاء وواجهة سطر الأوامر (Firebase) وخادم بروتوكول سياق النموذج ( ) لمنصة Firebase معًا لمساعدتك في إعداد هذه الخدمات والميزات ( ) بسرعة:

• Cloud Firestore: يمكنك توفير قاعدة بيانات NoSQL.
• Authentication: يمكنك إعداد تسجيل دخول آمن للمستخدمين.
• Firebase Security Rules: يمكنك إنشاء Security Rules لتطبيقك وتحسينها.
• Firebase Hosting: يمكنك إعداد مشروعك لنشر تطبيق ويب ثابت.

للاطّلاع على قائمة كاملة بالخيارات المتاحة، يمكنك تصفُّح الـ قائمة الكاملة لمهارات وكلاء Firebase.

سير العمل العام

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

الخطوة 1: تثبيت مهارات وكلاء Firebase

في معظم الحالات، يمكنك تثبيت مهارات وكلاء Firebase في المحرّر المفضّل لديك باستخدام طلب واحد:

claude plugin marketplace add firebase/agent-skills
claude plugin install firebase@firebase

npx skills add firebase/agent-skills

الخطوة 2: الربط بخادم بروتوكول سياق النموذج (MCP) لمنصة Firebase

على الرغم من أنّ العديد من مهارات وكلاء Firebase تستخدم واجهة سطر الأوامر Firebase (CLI) لمنصة Firebase لإجراء المهام، ننصح بربط وكيل الترميز المستنِد إلى الذكاء الاصطناعي بخادم بروتوكول سياق النموذج (MCP) لمنصة Firebase. يعزّز هذا الربط قدرة وكيلك على التفاعل مع بيئة Firebase، ما يوفّر تكاملاً أعمق وإمكانية وصول أكبر.

الطريقة بمساعدة الذكاء الاصطناعي

في معظم الحالات، يمكنك أن تطلب من وكيل الترميز المستنِد إلى الذكاء الاصطناعي إعداد خادم بروتوكول سياق النموذج (MCP) لمنصة Firebase. ومع ذلك، إذا واجهت صعوبة أو لم يظهر لك خادم بروتوكول سياق النموذج (MCP) لمنصة Firebase المدرج، يمكنك التبديل إلى الطريقة اليدوية.

الطريقة اليدوية

{
  "mcpServers": {
    "firebase-mcp-server": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"],
      "disabled": false
    }
  }
}

"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

"servers": {
  "firebase": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

"mcp": {
  "servers": {
    "firebase": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

الخطوة 3: بدء خدمات Firebase

بعد إعداد مهارات وأدوات الوكلاء، يمكنك الآن استخدام لغة طبيعية لكي يقوم وكيل الترميز المستنِد إلى الذكاء الاصطناعي بإعداد Cloud Firestore وAuthentication و Firebase Hosting.

1. اطلب من وكيلك إعداد خدمة. على سبيل المثال، يمكنك استخدام طلبات كالتالية:

   • إعداد Cloud Firestore كقاعدة بيانات لهذا التطبيق.
   • إنشاء صفحة تسجيل دخول باستخدام Authentication وتعديل Security Rules لـ ضمان عدم تمكُّن المستخدمين غير المصرّح لهم من قراءة بياناتهم وكتابتها.
   • إعداد Firebase Hosting ونشر التطبيق في قناة الإصدار العلني

2. راجِع أي معلومات واتّبِع أي خطوات إرشادية قد يقدّمها وكيلك، مثل:

   1. الخطط: يقترح وكيلك استراتيجية استنادًا إلى قاعدة الرموز البرمجية الحالية.
   2. عمليات الربط: يربط وكيلك الرموز البرمجية المحلية بمشروع حالي على Firebase أو يساعدك في إنشاء مشروع جديد على Firebase.
   3. بدء الم1وارد: يضيف وكيلك مكتبات Firebase والإعدادات المطلوبة إلى قاعدة الرموز البرمجية.
   4. تعديل الملفات: ينشئ وكيلك أي ملفات ضرورية ويعدّلها، مثل firestore.rules (لتحديد المستخدمين الذين يمكنهم قراءة البيانات أو كتابتها أو طلبها في قاعدة بياناتك) أو firebase.json (لإعلام Firebase CLI بالخدمات التي يجب نشرها وكيفية إعدادها).
   5. التنفيذ: يقدّم وكيلك إرشادات حول خطوات الإعداد أو النشر الإضافية.

نصائح عامة لتقديم طلب إلى وكيل ترميز مستنِد إلى الذكاء الاصطناعي

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

توجيه طلبات محددة وتقديم السياق

على الرغم من أنّ خادم بروتوكول سياق النموذج (MCP) لمنصة Firebase يزوّد الوكيل بسياق كبير حول مشروعك، فإنّ الطلبات الواضحة والمحددة باللغة الطبيعية تحقق أفضل النتائج. تجنَّب الطلبات الغامضة.

• غامض: "أصلِح خطأ قاعدة البيانات".
• محدّد: "تظهر لي رسالة الخطأ "تم رفض الإذن" عند محاولة الكتابة في مجموعة "المستخدمون" (users) في Cloud Firestore. راجِع ملف firestore.rules واقتَرح حلاً يسمح للمستخدمين الذين تم التحقّق من هويتهم بالكتابة في مستنداتهم الخاصة".

كرِّر الأسئلة وحسِّنها

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

• تقديم رسائل الخطأ: يمكنك لصق أي أخطاء في الوحدة الطرفية أو سجلات وحدة التحكّم في المحادثة.
• طلب إجراء تعديلات: "يستخدم هذا الرمز حزمة تطوير البرامج (SDK) القديمة v8. أعِد كتابته باستخدام حزمة تطوير البرامج (SDK) المعيارية v9 من Firebase".
• طلب تفسيرات: "اشرح كيف تحمي Firebase Security Rules بيانات المستخدمين."

التحقّق من ذلك قبل التنفيذ

وكلاء الترميز المستنِد إلى الذكاء الاصطناعي فعّالون، ولكن يمكن أن يرتكبوا أخطاء أو "يهلوسوا" (يؤلفوا دوال أو خدمات بأسماء غير صحيحة).

• مراجعة الرموز البرمجية: احرص دائمًا على قراءة الرموز البرمجية التي تم إنشاؤها، خاصةً Firebase Security Rules وملفات الإعداد (مثل firebase.json)، قبل النشر في قناة الإصدار العلني.
• الاختبار محليًا: اطلب من الوكيل مساعدتك في اختبار التغييرات محليًا قبل نشرها على الإنترنت كلما أمكن ذلك.

استخدام اتصال MCP

بما أنّ خادم بروتوكول سياق النموذج (MCP) لمنصة Firebase يمنح وكيلك إمكانية الاطّلاع المباشر على بنية مشروعك، يمكنك الإشارة إلى ملفات معيّنة للحصول على نصائح مخصّصة حول التنفيذ.

• مثال: "اطّلِع على ملف src/web/index.html وأرِني مكان إضافة النص البرمجي العادي لبدء Firebase."

الخطوات التالية

• يمكنك تصفُّح قائمة كاملة بجميع مهارات وكلاء Firebase المتاحة.
• يمكنك تصفُّح قائمة كاملة بجميع الطلبات والأدوات والموارد المتاحة التي يوفّرها خادم بروتوكول سياق النموذج (MCP) لمنصة Firebase.
• يمكنك التعرّف أكثر على الأدوات التي توفّرها واجهة سطر الأوامر (CLI)Firebase.