תהליכי עבודה מתקדמים לתבניות


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

בתהליכי העבודה המתקדמים שמתוארים בדף הזה נעשה שימוש ב-Firebase AI Logic API בארכיטקטורת REST.

מידע חשוב על שימוש ב-API בארכיטקטורת REST

  • אם תבנית לא נעולה, אפשר להחליף אותה באמצעות אותו מזהה תבנית בקריאה ל-API בארכיטקטורת REST. אי אפשר לשכתב תבנית נעולה.

  • כשיוצרים תבנית לפרומפט של שרת באמצעות API בארכיטקטורת REST ו מגדירים את המיקום שלה ל-global, תבנית לפרומפט של השרת מוקצה אוטומטית בכל המיקומים (כולל global), והיא זמינה לשימוש עם שני פלאגינים שמתממשקים עם שירותים חיצוניים של Gemini API. עם זאת, אם מגדירים מיקום אחר כשיוצרים את התבנית באמצעות API בארכיטקטורת REST, התבנית תהיה זמינה רק ל-Agent Platform Gemini API (formerly Vertex AI). בהמשך הדף מופיע מידע נוסף על הגדרת מיקום ספציפי לתבנית.

    שימו לב: כשמשתמשים בממשק המשתמש המודרך במסוף Firebase, התבנית מוקצה אוטומטית גם בכל המיקומים (כולל global), והיא זמינה לשימוש עם שני ספקי Gemini API.

  • כדי לגשת לתבנית של הנחיה לשרת בבקשת templateGenerateContent או templateStreamGenerateContent באמצעות REST API, צריך להשתמש בנקודת הקצה שספציפית לספק Gemini API (Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI)).

(Agent Platform Gemini API (formerly Vertex AI) בלבד) הגדרת מיקום ספציפי לתבנית

הקטע הזה רלוונטי למצבים הבאים:

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

  • הבקשות של האפליקציה משתמשות ב-Agent Platform Gemini API (formerly Vertex AI) ואתם מציינים מיקום לגישה למודל.

כמו שמתואר בחלק העליון של הדף הזה, תבנית לפרומפט של שרת מוקצה אוטומטית לכל האזורים הזמינים ל-Firebase AI Logic (כולל global) אם מבצעים את אחת מהפעולות הבאות:

  • יוצרים את התבנית באמצעות ממשק המשתמש המודרך במסוף Firebase.
  • יוצרים את התבנית באמצעות API בארכיטקטורת REST‏ ו מגדירים את המיקום שלה ל-global.

כלומר, אפשר להגדיר בבקשה של האפליקציה את המיקום לאחד מהאזורים הזמינים של Firebase AI Logic, והתבנית תהיה זמינה. אתם לא נדרשים להגדיר את המיקום בבקשה של האפליקציה אל global.

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

  1. כדי ליצור את התבנית, קוראים לנקודת הקצה projects.locations.templates.create. מציינים את location של התבנית (לדוגמה, europe-west4) במסגרת יצירת PromptTemplate.

  2. בבקשה של האפליקציה, מוודאים שהמיקום שבו ניגשים למודל זהה למיקום של התבנית (europe-west4).

חשוב לשים לב לנקודות הבאות:

  • ברשימת התבניות במסוף Firebase מוצגות רק תבניות שהוקצו (לפחות) במיקום global.

  • אם משתמשים ב-API בארכיטקטורת REST כדי להקצות תבנית במיקום ספציפי (שלא global), המיקום שבו ניגשים למודל בבקשה של האפליקציה חייב להיות זהה למיקום שהוגדר לתבנית. אם המיקומים לא תואמים, הבקשה תיכשל (בגלל מדיניות הבידוד האזורי).

שליחת התבנית כקובץ

אפשר לספק את התוכן של קובץ תבנית לפרומפט של שרת על ידי קריאה לנקודת הקצה projects.locations.templates.create.