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

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

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

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

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

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

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

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

خدمات Firebase السارية

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

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

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

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

توضّح الخطوات التالية سير عمل عام لكيفية استخدام مهارات وكلاء Firebase لإعداد خدمات Firebase واستخدامها في تطبيق ويب. وراء الكواليس، تستخدم مهارات الوكلاء واجهة سطر أوامر Firebase وخادم Firebase MCP لإكمال هذه المهام.

الخطوة 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 لتنفيذ المهام، ننصحك أيضًا بربط وكيل الترميز المستنِد إلى الذكاء الاصطناعي بخادم MCP في Firebase. يعزّز هذا الربط قدرة وكيلك على التفاعل مع بيئة Firebase، ما يوفّر تكاملاً وإمكانية وصول أعمق.

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

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

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

{
  "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
    }
  }
}

"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 وFirebase Authentication وFirebase Hosting.

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

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

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

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

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

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

تحديد التفاصيل وتقديم سياق

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

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

التكرار والتحسين

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

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

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

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

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

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

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

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

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

• تصفُّح قائمة كاملة بجميع مهارات وكلاء Firebase المتاحة
• تصفُّح قائمة كاملة بجميع الطلبات والأدوات والمراجع المتوفّرة التي يوفّرها خادم Firebase MCP
• مزيد من المعلومات حول الأدوات التي توفّرها واجهة سطر أوامر Firebase