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

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

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

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

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

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

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

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

مهارت‌ها و ابزارهای عامل (agent) در کدام سرویس‌های فایربیس (Firebase) می‌توانند مفید باشند؟

این راهنما در درجه اول بر چگونگی همکاری مهارت‌های عامل، رابط خط فرمان Firebase و سرور MCP فایربیس برای کمک به شما در راه‌اندازی سریع این سرویس‌ها و ویژگی‌ها تمرکز دارد:

• Cloud Firestore : ارائه یک پایگاه داده NoSQL.
• Authentication : ورود امن کاربر را تنظیم کنید.
• Firebase Security Rules : ایجاد و اصلاح Security Rules برای برنامه شما.
• Firebase Hosting : پروژه خود را برای استقرار برنامه وب استاتیک تنظیم کنید.

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

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

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

مرحله 1 : نصب مهارت‌های عامل فایربیس

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

npx skills add firebase/agent-skills --agent=antigravity

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

npx skills add firebase/agent-skills --agent=codex

npx skills add firebase/agent-skills --agent=cursor

npx skills add firebase/agent-skills

مرحله 2 : به سرور Firebase MCP متصل شوید

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

روش مبتنی بر هوش مصنوعی

در بیشتر موارد، می‌توانید از کدنویس هوش مصنوعی خود بخواهید که سرور Firebase MCP را راه‌اندازی کند. با این حال، اگر با مشکل مواجه شد یا سرور Firebase MCP را در فهرست مشاهده نکردید، به روش دستی (Manual) بروید.

روش دستی

{
  "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. منابع را مقداردهی اولیه می‌کند : عامل شما کتابخانه‌ها و پیکربندی‌های مورد نیاز Firebase را به پایگاه کد شما اضافه می‌کند.
   4. به‌روزرسانی فایل‌ها : عامل شما فایل‌های لازم مانند firestore.rules (برای تعریف اینکه چه کسی می‌تواند داده‌ها را در پایگاه داده شما بخواند، بنویسد یا پرس‌وجو کند) یا firebase.json (برای اطلاع‌رسانی به Firebase CLI که کدام سرویس‌ها را مستقر کند و چگونه آنها را پیکربندی کند) را ایجاد و به‌روزرسانی می‌کند.
   5. اجرا می‌کند : نماینده شما، شما را در مراحل پیکربندی یا استقرار اضافی راهنمایی می‌کند.

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

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

خاص باشید و زمینه را فراهم کنید

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

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

تکرار و اصلاح

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

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

قبل از اجرا، تأیید کنید

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

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

از اتصال MCP استفاده کنید

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

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

مراحل بعدی

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