ادغام سرویس‌های Firebase بااستفاده از کمک هوشواره‌ای

بااستفاده از ابزارهای توسعه هوش مصنوعی مانند Antigravity،‏ Claude Code،‏ Codex، و Cursor، راه‌اندازی Firebase را برای برنامه‌های وب ساده کنید. بااستفاده از مهارت‌های عامل Firebase همراه با Firebase CLI و سرور Firebase MCP، می‌توانید عامل کدنویسی هوش مصنوعی خود را به یک متخصص تخصصی Firebase تبدیل کنید که می‌تواند کد بنویسد، Firebase Security Rules را پیکربندی کند و منابع زنده را مدیریت کند.

این راهنما نحوه استفاده از عامل کدنویسی هوش مصنوعی را برای کمک به راه‌اندازی Cloud Firestore، Firebase Authentication، و Firebase Hosting برای برنامه وب پوشش می‌دهد. به‌زودی برای اطلاعات درباره برنامه‌های iOS،‏ Android، و Flutter دوباره سر بزنید!

چرا باید از مهارت‌ها و ابزارهای عامل Firebase استفاده کرد؟

عامل‌های کدنویسی هوش مصنوعی اغلب با پیکربندی‌های خاص پروژه یا اطلاعات قدیمی مشکل دارند. این جعبه‌ابزار با ترکیب دستورالعمل‌های تخصصی (مهارت‌های عامل) با دو نوع ابزار مکمل اجرای عامل (CLI و سرور MCP) این شکاف را پر می‌کند:

• مهارت‌های عامل Firebase: تخصص دامنه و گردش کار را برای عامل کدنویسی فراهم می‌کند. مهارت‌ها به‌عنوان لایه دستورالعمل، عامل را در روال‌های مطلوب برای کار با Firebase، ازجمله نوشتن کد، راهنمایی می‌کنند. مهارت‌ها همچنین به عامل آموزش می‌دهند که چه زمانی و چگونه از Firebase CLI و سرور Firebase MCP استفاده کند.
• ابزارهای اجرای عامل:
  • Firebase CLI (ابزارهای خط فرمان): ابزارهایی برای تکالیف محیطی و چرخه حیات پروژه ارائه می‌دهد. این نماینده می‌تواند فرمان‌های CLI را در محیط پایانه اجرا کند تا سرویس‌ها را در پروژه Firebase راه‌اندازی کند، سایت‌های کامل یا منابع پس‌بک را مستقر کند، شبیه‌سازهای محلی را راه‌اندازی کند، و کارهای دیگری انجام دهد.
  • سرور Firebase MCP (ابزارها و منابع برنامه‌ای): ابزارهایی برای بازرسی هم‌زمان و عملیات داده ارائه می‌دهد. ازطریق فراخوانی‌های ابزار ساختاریافته، نماینده می‌تواند به‌صورت برنامه‌نویسی‌شده Cloud Firestore اسناد را جستجو و به‌روزرسانی کند، Firebase Authentication کاربران را مدیریت کند، Security Rules را اعتبارسنجی کند، گزارش‌های زنده یا مستندات را مستقیماً به زمینه بکشد، و کارهای بیشتری انجام دهد.

استفاده از مهارت‌های عامل Firebase در کنار Firebase CLI و سرور Firebase MCP به عامل کدنویسی هوش مصنوعی شما توانایی‌های بیشتری می‌دهد:

• اقدام کردن: کارهایی فراتر از نوشتن کد انجام دهید. عامل شما می‌تواند سرویس‌ها را مقداردهی اولیه کند، کاربران Firebase Authentication را مدیریت کند، Firebase Security Rules جدید را مستقر کند، و مستقیماً با داده‌های Cloud Firestore شما کار کند.
• به‌روز بمانید: از پیام‌واره‌های رسمی و آگاه از نسخه برای راهنمایی عاملتان در کارهای راه‌اندازی استفاده کنید.
• بهبود دقت: به محیط و طرح‌واره‌های پروژه‌تان دسترسی پیدا می‌کند تا راهنمایی‌های دقیق‌تر و مرتبط‌تری ارائه دهد.
• کاهش هزینه‌های کد: مهارت‌های نماینده اسناد دقیق را فقط زمانی بار می‌کند که تکلیف خاصی به آن نیاز داشته باشد، که این امر سربار جلسه را به حداقل می‌رساند.

سرویس‌های Firebase ذی‌ربط

این راهنما عمدتاً بر نحوه همکاری مهارت‌های عامل، Firebase CLI، و سرور MCP‏ Firebase برای کمک به شما در راه‌اندازی سریع این سرویس‌ها و ویژگی‌ها تمرکز دارد:

• Cloud Firestore: پایگاه داده NoSQL را آماده کنید.
• Firebase Authentication: ورود به سیستم ایمن کاربر را راه‌اندازی کنید.
• Firebase Security Rules: Security Rules را برای برنامه‌تان تولید و پالایش کنید.
• Firebase Hosting: پروژه‌تان را برای استقرار برنامه وب ایستا راه‌اندازی کنید.

برای مشاهده فهرست کامل موارد دردسترس، فهرست کامل مهارت‌های عامل Firebase را مرور کنید.

گردش کار عمومی

مراحل زیر گردش کار تعمیم‌یافته‌ای را برای نحوه استفاده از مهارت‌های عامل Firebase برای راه‌اندازی و استفاده از سرویس‌های Firebase در یک برنامه وب توصیف می‌کند. در پشت صحنه، مهارت‌های عامل از Firebase CLI و سرور Firebase MCP برای تکمیل این وظایف استفاده می‌کنند.

مرحله ۱: نصب کردن مهارت‌های عامل Firebase

در بیشتر موارد، می‌توانید مهارت‌های عامل Firebase را در ویرایشگر دلخواهتان با یک پیام‌واره نصب کنید:

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

npx skills add firebase/agent-skills

مرحله ۲: متصل شدن به سرور Firebase MCP

درحالی‌که بسیاری از مهارت‌های عامل Firebase از Firebase CLI برای انجام تکالیف استفاده می‌کنند، توصیه می‌شود عامل کدنویسی هوش مصنوعی خود را به سرور Firebase MCP نیز متصل کنید. این اتصال توانایی عاملتان را برای تعامل با محیط 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"]
  }
}

عاملتان را در اسناد رسمی Firebase زمینه‌سازی کنید

سرور Firebase MCP شامل ابزارهایی است که به کارگزار شما اجازه می‌دهد قبل‌از نوشتن کد، در اسناد رسمی و زنده توسعه‌دهنده Google، ازجمله firebase.google.com، جستجو کند. به این ترتیب، به‌جای اینکه فقط به داده‌های آموزشی خود متکی باشد، از میاناهای برنامه‌سازی کاربردی کیت توسعه نرم‌افزار و نحو Security Rules استفاده می‌کند. این ابزارها از سرور MCP دانش توسعه‌دهنده می‌آیند.

مرحله ۳: مقداردهی اولیه سرویس‌های Firebase

با راه‌اندازی مهارت‌ها و ابزارهای عامل، اکنون می‌توانید از زبان طبیعی استفاده کنید تا عامل کدنویسی هوش مصنوعی شما Cloud Firestore، Firebase Authentication، و Firebase Hosting را راه‌اندازی کند.

1. از نماینده‌تان بخواهید سرویسی را راه‌اندازی کند. برای مثال، می‌توانید از پیام‌واره‌هایی مثل این‌ها استفاده کنید:

   • Cloud Firestore را به‌عنوان پایگاه داده این برنامه تنظیم کنید.
   • صفحه ورود به سیستم را بااستفاده از Authentication بسازید و Security Rules را به‌روز کنید تا مطمئن شوید فقط کاربران مجاز می‌توانند داده‌های خودشان را بخوانند و بنویسند.
   • برنامه را راه‌اندازی کنیدFirebase Hosting و آن را در تولید مستقر کنید.
   • برای صفحه‌بندی نتایج پُرسمان، به مستندات فعلی Cloud Firestore مراجعه کنید، سپس بارگیری صفحه‌بندی‌شده را به فهرست پست‌ها اضافه کنید.

2. هرگونه اطلاعات را بازبینی کنید و هرگونه مراحل راهنمایی‌شده‌ای را که ممکن است عامل شما ارائه دهد دنبال کنید، مانند:

   1. برنامه‌ریزی می‌کند: نماینده شما براساس پایگاه کد موجود شما استراتژی‌ای را پیشنهاد می‌کند.
   2. اتصال: نماینده شما کد محلی‌تان را به پروژه Firebase موجود پیوند می‌دهد یا به شما کمک می‌کند پروژه Firebase جدیدی ایجاد کنید.
   3. مقداردهی اولیه منابع: نماینده شما کتابخانه‌ها و پیکربندی Firebase موردنیاز را به پایگاه کد شما اضافه می‌کند.
   4. به‌روزرسانی فایل‌ها: نماینده شما هر فایل ضروری را ایجاد و به‌روزرسانی می‌کند، مثل firestore.rules (برای تعریف اینکه چه کسی می‌تواند داده‌ها را در پایگاه داده شما بخواند، بنویسد، یا پرسمان کند) یا firebase.json (برای اطلاع دادن به Firebase CLI درباره اینکه کدام سرویس‌ها را مستقر کند و چگونه آن‌ها را پیکربندی کند).
   5. اجرا می‌کند: نماینده شما را در مراحل پیکربندی یا استقرار بیشتر راهنمایی می‌کند.

نکات کلی برای پیام‌واره دادن به عامل کدنویسی هوش مصنوعی

برای اینکه بیشترین بهره را از عامل کدنویسی با هوش مصنوعی ببرید، به‌ویژه هنگام کار با ادغام‌های چندوجهی مانند Firebase، تعامل را به‌عنوان یک همکاری درنظر بگیرید نه یک فرمان تک‌باره.

دقیق باشید و بافت ارائه دهید

هرچند سرور Firebase MCP بافت قابل‌توجهی درباره پروژه‌تان به نماینده ارائه می‌دهد، پیام‌واره‌های زبان طبیعی واضح و مشخص بهترین نتایج را به‌همراه دارند. از درخواست‌های مبهم اجتناب کنید.

• مبهم: «خطای پایگاه داده را برطرف کنید.»
• خاص: «هنگام نوشتن در مجموعه «کاربران» در Cloud Firestore، خطای «اجازه رد شد» دریافت می‌کنم. firestore.rules من را بازبینی کن و اصلاحیه‌ای پیشنهاد بده که به کاربران اصالت‌سنجی‌شده اجازه دهد در سند خودشان بنویسند.»

تکرار و پالایش کردن

مأموران کدنویسی هوش مصنوعی به‌ندرت در اولین تلاش برای کارهای پیچیده کد بی‌نقصی تولید می‌کنند. اگر پاسخی کاملاً درست نیست، مکالمه را ادامه دهید:

• ارائه پیام‌های خطا: هرگونه خطای پایانه یا گزارش کنسول را در گپ جای‌گذاری کنید.
• درخواست اصلاحات: «آن کد از کیت توسعه نرم‌افزار قدیمی‌تر v8 استفاده می‌کند. آن را بااستفاده از کیت توسعه نرم‌افزار واحدی Firebase v9 بازنویسی کن.»
• درخواست توضیح: «توضیح دهید که چگونه این Firebase Security Rules از داده‌های کاربر محافظت می‌کند.»

قبل‌از اجرا درستی‌سنجی کنید

عوامل کدنویسی هوش مصنوعی قدرتمند هستند، اما ممکن است اشتباه کنند یا «توهم بزنند» (تابع‌ها یا سرویس‌هایی با نام نادرست اختراع کنند).

• مرور کد: همیشه قبل‌از استقرار در محیط تولید، کد تولیدشده، به‌ویژه Firebase Security Rules و فایل‌های پیکربندی (مانند firebase.json) را به‌طور کامل بخوانید.
• آزمایش محلی: هر زمان که ممکن بود، از نماینده بخواهید به شما کمک کند تا تغییرات را به‌صورت محلی آزمایش کنید و سپس آن‌ها را منتشر کنید.

استفاده از اتصال MCP

چون سرور Firebase MCP به نماینده شما امکان می‌دهد ساختار پروژه‌تان را مستقیماً ببیند، می‌توانید به فایل‌های خاصی ارجاع دهید تا توصیه‌های پیاده‌سازی سفارشی دریافت کنید.

• مثال: «به فایل src/web/index.html من نگاه کن و به من نشان بده کجا باید اسکریپت مقداردهی اولیه استاندارد Firebase را اضافه کنم.»

مراحل بعدی

• فهرست کامل همه مهارت‌های عامل Firebase دردسترس را مرور کنید.
• فهرست کامل همه پیام‌واره‌ها، ابزارها، و منابعی را که سرور MCP‏ Firebase ارائه می‌دهد مرور کنید.
• درباره ابزارهای ارائه‌شده توسط Firebase CLI بیشتر بدانید.
• با نحوه متصل کردن هر دستیار کدنویسی هوش مصنوعی به مستندات رسمی توسعه‌دهنده Google با سرور MCP «دانش توسعه‌دهنده» آشنا شوید.