Integrowanie usług Firebase przy użyciu pomocy AI

Uprość konfigurację Firebase w przypadku aplikacji internetowych, korzystając z narzędzi deweloperskich opartych na AI, takich jak Antigravity, Cloud Code, Codex i Cursor. Korzystając z umiejętności agenta Firebase w połączeniu z Firebase CLI i serwerem Firebase MCP, możesz przekształcić agenta AI do kodowania w specjalistę od Firebase, który potrafi pisać kod, konfigurować Firebase Security Rules i zarządzać zasobami na żywo.

W tym przewodniku znajdziesz informacje o tym, jak za pomocą agenta do kodowania opartego na AI skonfigurować Cloud Firestore, Firebase Authentication i Firebase Hosting w aplikacji internetowej. Wkrótce opublikujemy informacje o aplikacjach na iOS, Androida i Fluttera.

Dlaczego warto korzystać z umiejętności i narzędzi agenta Firebase?

Agenci do kodowania AI często mają problemy z określonymi konfiguracjami projektów lub nieaktualnymi informacjami. Ten zestaw narzędzi wypełnia tę lukę, łącząc specjalistyczne instrukcje (umiejętności agenta) z 2 uzupełniającymi się typami narzędzi do wykonywania działań przez agenta (interfejsem wiersza poleceń i serwerem MCP):

• Umiejętności agenta Firebase: zapewniają agentowi kodującemu wiedzę specjalistyczną i przepływy pracy. Umiejętności stanowią warstwę instrukcji, która podpowiada agentowi sprawdzone metody pracy z Firebase, w tym pisania kodu. Umiejętności uczą też agenta, kiedy i jak korzystać z interfejsu wiersza poleceń Firebase i serwera MCP Firebase.
• Narzędzia wykonywania działań przez agenta:
  • Firebase CLI (narzędzia wiersza poleceń): zawiera narzędzia do zadań związanych z cyklem życia projektu i środowiskiem. Agent może uruchamiać polecenia CLI w środowisku terminala, aby konfigurować usługi w projekcie w Firebase, wdrażać pełne witryny lub zasoby backendu, uruchamiać lokalne emulatory i wykonywać inne czynności.
  • Serwer MCP Firebase (narzędzia i zasoby programowe): udostępnia narzędzia do inspekcji i operacji na danych w czasie rzeczywistym. Dzięki strukturalnym wywołaniom narzędzi agent może programowo wysyłać zapytania i aktualizować Cloud Firestore dokumenty, zarządzać Firebase Authentication użytkownikami, weryfikować Security Rules, pobierać na żywo logi lub dokumentację bezpośrednio do kontekstu i wykonywać inne czynności.

Korzystanie z umiejętności agenta Firebase wraz z Firebase CLI i serwerem Firebase MCP daje agentowi AI do kodowania dodatkowe możliwości:

• Podejmij działanie: nie ograniczaj się do pisania kodu. Agent może inicjować usługi, zarządzać Firebase Authentication użytkownikami, wdrażać nowe Firebase Security Rules i pracować bezpośrednio z Twoimi Cloud Firestore danymi.
• Bądź na bieżąco: korzystaj z oficjalnych promptów uwzględniających wersję, aby przeprowadzić agenta przez zadania konfiguracyjne.
• Zwiększanie dokładności: dostęp do środowiska i schematów projektu, aby uzyskiwać bardziej trafne i dokładne informacje.
• Obniżanie kosztów tokenów: umiejętności agenta wczytują szczegółową dokumentację tylko wtedy, gdy wymaga tego konkretne zadanie, co minimalizuje koszty sesji.

Obowiązujące usługi Firebase

Ten przewodnik koncentruje się głównie na tym, jak umiejętności agenta, interfejs Firebase CLI i serwer MCP Firebase współpracują ze sobą, aby pomóc Ci szybko skonfigurować te usługi i funkcje:

• Cloud Firestore: udostępnianie bazy danych NoSQL.
• Firebase Authentication Skonfiguruj bezpieczne logowanie użytkowników.
• Firebase Security Rules: generowanie i udoskonalanie Security Rules dla aplikacji.
• Firebase Hosting: skonfiguruj projekt pod kątem wdrażania statycznej aplikacji internetowej.

Pełną listę dostępnych funkcji znajdziesz tutaj.

Ogólny przepływ pracy

Poniższe kroki opisują ogólny proces korzystania z umiejętności agenta Firebase do konfigurowania i używania usług Firebase w aplikacji internetowej. W  tle umiejętności agenta używają Firebaseinterfejsu CLI i serwera Firebase MCP do wykonywania tych zadań.

Krok 1. Zainstaluj umiejętności agenta Firebase

W większości przypadków możesz zainstalować umiejętności agenta Firebase w wybranym edytorze za pomocą jednego prompta:

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

npx skills add firebase/agent-skills

Krok 2. Połącz się z serwerem MCP Firebase

Wiele umiejętności agenta Firebase korzysta z Firebaseinterfejsu CLI do wykonywania zadań, ale zalecane jest też połączenie agenta AI do kodowania z serwerem Firebase MCP. To połączenie zwiększa możliwości agenta w zakresie interakcji ze środowiskiem Firebase, zapewniając głębszą integrację i dostęp.

Metoda wspomagana przez AI

W większości przypadków możesz poprosić agenta AI do kodowania o skonfigurowanie serwera Firebase MCP. Jeśli jednak ma z tym problemy lub nie widzisz na liście serwera MCP Firebase, przejdź na metodę ręczną.

Metoda ręczna

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

Krok 3. Zainicjuj usługi Firebase

Po skonfigurowaniu umiejętności agenta i narzędzi możesz używać języka naturalnego, aby agent AI do kodowania skonfigurował Cloud Firestore, Firebase Authentication i Firebase Hosting.

1. Poproś agenta o skonfigurowanie usługi. Możesz na przykład używać takich promptów:

   • Skonfiguruj Cloud Firestore jako bazę danych tej aplikacji.
   • Utwórz stronę logowania za pomocą Authentication i zaktualizuj Security Rules, aby zapewnić, że tylko autoryzowani użytkownicy mogą odczytywać i zapisywać własne dane.
   • Skonfiguruj Firebase Hosting i wdroż aplikację w wersji produkcyjnej.

2. Zapoznaj się z informacjami i wykonaj wszystkie czynności, które może Ci zaproponować agent, np.:

   1. Plany: agent proponuje strategię na podstawie istniejącej bazy kodu.
   2. Łączy: agent łączy Twój kod lokalny z istniejącym projektem w Firebase lub pomaga Ci utworzyć nowy projekt w Firebase.
   3. Inicjuje zasoby: agent dodaje do bazy kodu wymagane biblioteki i konfigurację Firebase.
   4. Aktualizuje pliki: agent tworzy i aktualizuje wszystkie niezbędne pliki, takie jak firestore.rules (aby określić, kto może odczytywać, zapisywać lub wysyłać zapytania dotyczące danych w bazie danych) lub firebase.json (aby poinformować Firebase CLI, które usługi wdrożyć i jak je skonfigurować).
   5. Wykonuje: pracownik przeprowadzi Cię przez dodatkowe czynności konfiguracyjne lub wdrożeniowe.

Ogólne wskazówki dotyczące promptów dla asystenta kodowania AI

Aby w pełni wykorzystać możliwości agenta AI do kodowania, zwłaszcza podczas pracy z wielopłaszczyznowymi integracjami, takimi jak Firebase, traktuj interakcję jako współpracę, a nie jednorazowe polecenie.

Podawaj konkretne informacje i kontekst

Serwer MCP Firebase zapewnia agentowi istotny kontekst dotyczący Twojego projektu, ale najlepsze wyniki uzyskasz, stosując jasne i konkretne prompty w języku naturalnym. Unikaj niejasnych próśb.

• Niejasne: „Napraw błąd bazy danych”.
• Szczegółowe: „Podczas próby zapisu w kolekcji „users” w Cloud Firestore pojawia się błąd „permission denied”. Sprawdź mój firestore.rules i zaproponuj rozwiązanie, które umożliwi uwierzytelnionym użytkownikom zapisywanie zmian w ich własnym dokumencie”.

Iteruj i doprecyzuj

Agenty AI do kodowania rzadko generują idealny kod za pierwszym razem w przypadku złożonych zadań. Jeśli odpowiedź nie jest do końca trafna, kontynuuj rozmowę:

• Podaj komunikaty o błędach: wklej do czatu wszelkie błędy terminala lub dzienniki konsoli.
• Poproś o wprowadzenie zmian: „Ten kod korzysta ze starszego pakietu SDK w wersji 8. Przepisz go za pomocą modułowego pakietu SDK Firebase w wersji 9."
• Poproś o wyjaśnienia: „Wyjaśnij, jak te Firebase Security Rules chronią dane użytkowników”.

Sprawdź przed wykonaniem

Agenty AI do kodowania są potężne, ale mogą popełniać błędy lub „halucynować” (wymyślać nieprawidłowo nazwane funkcje lub usługi).

• Sprawdź kod: przed wdrożeniem w środowisku produkcyjnym zawsze przeczytaj wygenerowany kod, zwłaszcza Firebase Security Rulesi pliki konfiguracyjne (np. firebase.json).
• Testuj lokalnie: w miarę możliwości poproś agenta o pomoc w lokalnym testowaniu zmian przed ich wprowadzeniem.

Korzystanie z połączenia MCP

Serwer MCP Firebase zapewnia agentowi bezpośredni wgląd w strukturę projektu, dzięki czemu możesz odwoływać się do konkretnych plików, aby uzyskać dostosowane porady dotyczące implementacji.

• Przykład: „Spójrz na mój plik src/web/index.html i pokaż mi, gdzie dodać standardowy skrypt inicjowania Firebase”.

Dalsze kroki

• Przejrzyj pełną listę wszystkich dostępnych umiejętności agenta Firebase
• Przejrzyj pełną listę wszystkich dostępnych promptów, narzędzi i zasobów, które udostępnia serwer MCP Firebase
• Więcej informacji o narzędziach udostępnianych przez interfejs wiersza poleceń Firebase