דף זה תורגם על ידי Cloud Translation API.

שימוש בסיוע מבוסס-AI ב-Data Connect

אתם יכולים להשתמש ב-Gemini ב-Firebase כדי ליצור סכימות, שאילתות ומוטציות לקוד בצד הלקוח.

אתם יכולים לתאר את האפליקציה, מודל הנתונים או שאילתה או מוטציה רצויות בשפה טבעית, ו-Gemini ב-Firebase ייצור את המקבילה ב-Data Connect.

הסיוע מבוסס-AI זמין בהקשרים הבאים של פיתוח:

במסוף Firebase, אפשר ליצור, לבדוק ולפרוס את הסכימות והפעולות.
בסביבה המקומית, אפשר להשתמש ב-Firebase CLI ובתוסף Data Connect ל-VS Code כדי ליצור, לבדוק ולפתח באפליקציה באמצעות האמולטור.
כלים לפיתוח מבוססי-AI יכולים להשתמש בשרת MCP של Firebase כדי ליצור, לבדוק ולפתח את האפליקציה שלכם.

במדריכים אפשר לקרוא מידע נוסף על התחביר של Data Connect סכימה, שאילתה ומוטציה.

איך AI assistance for Data Connect משתמש בנתונים שלכם

מידע נוסף זמין במאמר איך Gemini ב-Firebase משתמש בנתונים שלכם.

הגדר את AI assistance for Data Connect

כדי להשתמש בעזרה מ-AI עם Data Connect, צריך להפעיל את Gemini ב-Firebase כמו שמתואר במאמר הגדרת Gemini ב-Firebase.

יצירת סכימה, שאילתות ומוטציות באמצעות Gemini ב-Firebase

אתם יכולים להשתמש בעזרה מבוססת-AI לData Connect בהרבה מתהליכי העבודה שלכם.

חשוב: AI assistance for Data Connect היא טכנולוגיה בשלב מוקדם של פיתוח, ולכן יכול להיות שהיא תפיק פלט שנראה סביר אבל בפועל הוא שגוי. יכול להיות שהתשובות יכילו מידע לא מדויק שלא מייצג את ההשקפות של Google. מומלץ לאמת כל פלט של Gemini לפני שמשתמשים בו, ולא להשתמש בקוד שנוצר ולא נבדק לצורכי פיתוח. אל תזינו פרטים אישיים מזהים (PII) או נתוני משתמשים בהנחיה של עזרה בכתיבת GraphQL. אפשר לקרוא מידע נוסף בנושא במאמרים איך AI assistance for Data Connect משתמש בנתונים שלכם וGemini ב-Google Cloud ואתיקה של בינה מלאכותית.

במסוף Firebase

כשיוצרים שירות Data Connect, במסוף Firebase מוצגות הוראות להפעלת Gemini.

אתם יכולים לתאר רעיון לאפליקציה, ועזרה מבוססת-AI תיצור את הדברים הבאים:

סכימה מלאה שמבוססת על הרעיון לאפליקציה.
דוגמאות לפעולות ולשינויים בנתונים.

בדף הנתונים, אפשר להשתמש בלחצן עזרה בכתיבת GraphQLpen_spark כדי ליצור ולהפעיל פעולות על סמך שפה טבעית. כאן תמצאו כמה תרחישים לדוגמה.

תהליך העבודה הזה מתואר במדריך לתחילת העבודה. אתם יכולים להמשיך בסביבת הפיתוח המקומית עם הסכימה והפעולות שנפרסו.

בסביבה המקומית

אפשר גם לקבל עזרה מ-AI באמצעות Firebase CLI והתוסף Data Connect ל-VS Code.

אתם יכולים לספק את הרעיון לאפליקציה ל-firebase init dataconnect, והוא ייצור את הדברים הבאים:

סכימה מלאה שמבוססת על הרעיון לאפליקציה.
דוגמאות לפעולות ולשינוי של נתוני התחלה.

התוסף Data Connect ל-VS Code כולל את התכונות הבאות:

Generates/Refine Operations Code Lens כדי להמיר הערות GraphQL לפעולות Data Connect.
שילוב חלק עם Gemini Code Assist ועם שרת Firebase MCP.

הסבר על תהליך העבודה הזה מופיע במדריך לתחילת העבודה עם אבות טיפוס מקומיים.

שימוש בשרת Firebase MCP עם כלי פיתוח מבוססי-AI

שרת ה-MCP של Firebase פועל עם כל כלי עזר מבוסס-AI שיכול לשמש כלקוח MCP, כולל Gemini CLI,‏ Gemini Code Assist,‏ Cursor,‏ Visual Studio Code Copilot,‏ Claude Desktop ו-Windsurf Editor.

שרת ה-MCP של Firebase מספק הקשר ויכולות נוספים כדי לעזור לכלים לפיתוח שמבוססים על AI לפעול בצורה טובה יותר עם Data Connect. הוא יכול:

הגדרת ספריות פרויקט חדשות וערכות SDK שנוצרו.
בנייה של סכימות ופעולות וביצוע איטרציות על סמך שגיאות קומפילציה.
ליצור סכימות חדשות ופעולות על סמך דרישות.
ליצור פעולות ולהריץ אותן מול שירותי קצה עורפי או אמולטור מקומי.
אוספים מידע על שירותים קיימים.

כדי להשתמש בשרת ה-MCP של Firebase:

מגדירים את לקוח ה-MCP לפי המדריך הזה.
לשאול שאלה שקשורה ל-Data Connect. דוגמאות להנחיות:
1. "תגדיר פרויקט Data Connect לאפליקציה למשלוחי פיצה".
2. "תיקון שגיאות קומפילציה של Data Connect".
3. "בדף הבית, אני רוצה להציג את חדרי הצ'אט הפעילים ואת רשימת החברים. תצור שאילתת Data Connect".
4. ‫"What users are in my local Data Connect emulator?" (אילו משתמשים נמצאים באמולטור המקומי שלי של Data Connect?)
5. "באילו אזורים ב-Google Cloud נמצאים שירותי Data Connect שלי?"

תרחישים לדוגמה ליצירת פעולות

בקטעים הבאים מתוארים תרחישים לדוגמה:

תחזיר את חמשת הסרטים המובילים בסדר יורד לפי סיווג
יצירת מוטציה שמוסיפה סרט למסד הנתונים על סמך קלט של משתמש
יצירת שאילתה שמציגה רשימה של ביקורות על סמך ז'אנר ודירוגים שסופקו על ידי משתמשים

החזרת חמשת הסרטים המובילים בסדר יורד לפי דירוג

כדי להשתמש ב-AI assistance for Data Connect כדי ליצור GraphQL שמבוסס על שפה טבעית:

פותחים את הקובץ Data Connect בפרויקט, ובקטע Services בוחרים את מקור הנתונים.
לוחצים על נתונים.
לוחצים על הסמל עזרה בכתיבה ב-GraphQLpen_spark. מתארים בשפה טבעית את השאילתה או את המוטציה שרוצים ליצור, ולוחצים על יצירה.

לדוגמה, אם אתם משתמשים במקור הנתונים Movies שמוזכר ב-codelab "Build with Data Connect (web)", אתם יכולים לשאול "Return the top five movies of 2022, in descending order by rating" (הצגת חמשת הסרטים המובילים משנת 2022, בסדר יורד לפי דירוג), ואולי תקבלו תוצאה כמו זו:
```
query TopMovies2022 {
  movies(where: {releaseYear: {eq: 2022}}, orderBy: [{rating: DESC}], limit: 5) {
    id
    title
    rating
    releaseYear
  }
}
```
בודקים את התשובה:
- אם התשובה נראית נכונה, לוחצים על הוספה כדי להוסיף את התשובה לעורך הקוד.
- אם אפשר לשפר את התשובה, לוחצים על עריכה, מעדכנים את ההנחיה ולוחצים על יצירה מחדש.
אחרי שמאשרים את התשובה, מגדירים את הפרמטרים הבאים בקטע Parameters, אם רלוונטי:
- משתנים: אם השאילתה או המוטציה מכילות משתנים, צריך להגדיר אותם כאן. אפשר להשתמש ב-JSON כדי להגדיר אותם, למשל, {"title":"The Matrix", "releaseYear":"1999"}.
- הרשאה: בוחרים את הקשר של ההרשאה (אדמין, מאומת או לא מאומת) שדרכו רוצים להריץ את השאילתה או את השינוי.
אזהרה: אם אתם מריצים מוטציה, כדאי לבדוק אותה בקפידה לפני שמריצים אותה. הפעלת מוטציה בכלי לעריכת נתונים תבצע את הבקשה.
לוחצים על Run (הפעלה) בכלי לעריכת קוד ובודקים את התוצאות.

כדי לבדוק כמה שאילתות או מוטציות בכלי לעריכת קוד, צריך לוודא שיש להן שמות. לדוגמה, השאילתה הבאה נקראת GetMovie. מזיזים את הסמן לשורה הראשונה של השאילתה או השינוי כדי להפעיל את הלחצן Run.

query GetMovie($myKey: Movie_Key!) {
  movie(key: $myKey) { title }
}

יצירת מוטציה שמוסיפה סרט למסד הנתונים על סמך קלט משתמש

בדוגמה הזו אפשר לראות איך להשתמש בשפה טבעית כדי ליצור מוטציה של GraphQL שממלאת את מסד הנתונים. בדוגמה הזו ההנחה היא שאתם משתמשים בסכימת מסד הנתונים של הסרט שמופיעה במסמכי Firebase Data Connect וב-codelab "Build with Data Connect (web)".

במסוף Firebase, פותחים את Data Connect.
בוחרים את השירות ואת מקור הנתונים ופותחים את הכרטיסייה נתונים.
לוחצים על הסמל עזרה בכתיבה של GraphQLpen_spark ומתארים את המוטציה:
```
Create a movie based on user input.
```

לוחצים על יצירה. המוטציה מוחזרת. לדוגמה, Gemini עשוי להחזיר מוטציה כזו:

mutation CreateMovie($title: String!, $releaseYear: Int!, $genre: String!, $rating: Float!, $description: String!, $imageUrl: String!, $tags: [String!] = []) @auth(level: USER) {
  movie_insert(data: {
    title: $title,
    releaseYear: $releaseYear,
    genre: $genre,
    rating: $rating,
    description: $description,
    imageUrl: $imageUrl,
    tags: $tags
  })
}

בודקים את הפלט. אם צריך, לוחצים על עריכה כדי לשפר את ההנחיה ואז לוחצים על יצירה מחדש.
לאחר מכן לוחצים על הוספה כדי להוסיף את השינוי לכלי לעריכת נתונים.

כדי להריץ את המוטציה, צריך להוסיף משתנים. בקטע Parameters, פותחים את Variables ומוסיפים כמה משתני בדיקה:

{"title":"My amazing movie", "releaseYear":2024, "genre": "Comedy",
"rating": 8, "description": "A new movie to test mutations",
"imageUrl": "", "tags": ["comedy","space travel"]}

לוחצים על Run.

כדאי לדעת: אפשר גם לבקש מ-Gemini להרחיב את התוצאה. לדוגמה, כדי לכלול בתפוקה הערות והנחיה למקור, אפשר להשתמש בהנחיה 'צור סרט על סמך קלט של משתמש. חשוב לתעד את השינוי ולכלול את ההנחיה הזו בתשובה".

בשלב הבא, יוצרים שאילתה שמאמתת שהסרט נוסף. לוחצים על עזרה בכתיבת GraphQL pen_spark ובתיבה שמופיעה מקלידים את ההנחיה:

List all movies from 2024 that include all of these tags: 'space travel', 'comedy'.

יכול להיות ש-Gemini יחזיר תשובה כמו זו:

query ComedySpaceTravelMovies2024 @auth(level: PUBLIC) {
  movies(
    where: {
    releaseYear: { eq: 2024 },
    tags: { includesAll: ["space travel", "comedy"] }
    }
  ) {
      id
      title
      imageUrl
      releaseYear
      genre
      rating
      description
      tags
    }
}

מוסיפים את השאילתה ומריצים אותה. הסרט שהוספתם אמור להופיע בשדה היסטוריה.

יצירת שאילתה שמציגה רשימה של ביקורות על סמך ז'אנר ודירוגים שסופקו על ידי משתמשים

בדוגמה הזו מוצג איך להשתמש בשפה טבעית כדי ליצור שאילתת GraphQL. בדוגמה הזו אנחנו מניחים שאתם משתמשים במסד הנתונים של הסרטים שמופיע במאמרי העזרה של Firebase Data Connect וב-codelab‏ Data Connect (אינטרנט).

במסוף Firebase, פותחים את Data Connect.
בוחרים את השירות ואת מקור הנתונים ופותחים את הכרטיסייה נתונים.
לוחצים על הסמל עזרה בכתיבה של GraphQLpen_spark ומתארים את השאילתה:
```
List all movie reviews, based on user-configurable genre and ratings.
```

לוחצים על יצירה. השאילתה מוחזרת. לדוגמה, יכול להיות ש-Gemini יחזיר שאילתה כזו:

query ListReviewsByGenreAndRating($genre: String, $minRating: Int, $maxRating: Int) @auth(level: PUBLIC) {
  reviews(where: {
    movie: {
      genre: {eq: $genre}
    },
    rating: {ge: $minRating, le: $maxRating}
  }) {
    id
    user {
      username
    }
    movie {
      title
      genre
    }
    rating
    reviewText
    reviewDate
  }
}

בודקים את הפלט. אם צריך, לוחצים על עריכה כדי לשפר את ההנחיה ואז לוחצים על יצירה מחדש.
לאחר מכן לוחצים על הוספה כדי להוסיף את השינוי לכלי לעריכת נתונים.
כדי לבדוק את השאילתה הזו, צריך להוסיף משתנים. בקטע פרמטרים, פותחים את משתנים וכוללים משתנים לשימוש בבדיקה:
```
{"genre":"sci-fi", "minRating":4, "maxRating":9}
```
לוחצים על Run.

הנחיות עיצוב לכלים מבוססי-AI של צד שלישי

כמו בכל כלי עזר מבוסס-AI, ככל שההנחיות טובות יותר, כך התוצאות שימושיות יותר.

כשנותנים ל-Gemini ב-Firebaseהנחיות בשפה טבעית, העוזר הדיגיטלי מתרגם את הקלט להנחיה מפורטת יותר.

אם אתם עובדים עם כלים של AI מצד שלישי כמו Cursor או Windsurf, תוכלו לקבל Data Connectהמלצות טובות יותר באמצעות הנחיות דומות ומפורטות יותר.

פרסמנו תבניות של הנחיות שתוכלו להוריד, להתאים ולהעתיק אל סביבת הפיתוח המשולבת (IDE):

הנחיית תבנית ליצירת סכימה
הנחיית תבנית ליצירת פעולות

אחרי שמורידים ומשנים, יוצרים הנחיה בכלי מוכר (לדוגמה, Cursor או Windsurf) באופן הבא:

ב-Cursor (חשוב לעיין בהוראות העדכניות של Cursor):
1. לוחצים על סמל ההגדרות בפינה השמאלית העליונה.
2. לוחצים על הכרטיסייה כללים.
3. בקטע Project Rules, לוחצים על הלחצן Add a new rule.
4. מעתיקים ומדביקים את הכלל.
ב-Windsurf (חשוב לעיין בהוראות העדכניות של Windsurf):
1. לוחצים על הלחצן Cascade בפינה השמאלית העליונה כדי לפתוח את החלון Cascade.
2. ב-Cascade, לוחצים על סמל ההתאמות האישיות בתפריט הנפתח שבפינה השמאלית העליונה ואז עוברים לחלונית כללים.
3. לוחצים על הלחצן + כללי או על הלחצן + Workspace כדי ליצור כללים חדשים ברמה הכללית או ברמת ה-Workspace, בהתאמה.
4. מעתיקים ומדביקים את הכלל.

פתרון בעיות AI assistance for Data Connect

אפשר לעיין במאמר בנושא פתרון בעיות ב-Gemini ב-Firebase.

תמחור

‫AI assistance for Data Connect זמין כחלק מ-Gemini ב-Firebase והוא כלול עבור משתמשים פרטיים.

מידע נוסף זמין במאמר תמחור של Gemini ב-Firebase.