ادغام سرویس‌های 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، و سرور Firebase MCP با یکدیگر تمرکز دارد تا به شما کمک کند این سرویس‌ها و ویژگی‌ها را به‌سرعت راه‌اندازی کنید:

• 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 نسخه ۹ بازنویسی کن."
• درخواست توضیح: «توضیح دهید که چگونه این Firebase Security Rules از داده‌های کاربر محافظت می‌کند.»

پیش‌از اجرا کردن، درستی‌سنجی کنید

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

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

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

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

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

مراحل بعدی

• فهرست کاملی از همه مهارت‌های دردسترس عامل Firebase را مرور کنید.
• فهرست کامل همه پیام‌واره‌ها، ابزارها، و منابعی را که سرور MCP در Firebase ارائه می‌دهد مرور کنید.
• درباره ابزارهای ارائه‌شده توسط Firebase CLI بیشتر بدانید.