ادغام سرویس‌های 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 استفاده کند.
• ابزارهای اجرای Agent:
  • 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

با راه‌اندازی مهارت‌ها و ابزارهای عامل، اکنون می‌توانید از زبان طبیعی استفاده کنید تا عامل کدنویسی هوش مصنوعی شما 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 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 بیشتر بدانید.