ב-Firebase AI Logic, מסוף Firebase מספק ממשק משתמש מודרך שבו אפשר לציין את התוכן של תבנית. עם זאת, יש כמה תרחישי שימוש שבהם יכול להיות שתצטרכו דרכים מתקדמות יותר להגדרת תבנית, כולל:
בתהליכי העבודה המתקדמים שמתוארים בדף הזה נעשה שימוש ב-Firebase AI Logic API בארכיטקטורת REST.
מידע חשוב על שימוש ב-API בארכיטקטורת REST
אם התבנית לא נעולה, אפשר לדרוס אותה באמצעות אותו מזהה תבנית בקריאה ל-API בארכיטקטורת REST. אי אפשר לשכתב תבנית נעולה.
כשיוצרים תבנית הנחיה לשרת באמצעות REST API ו מגדירים את המיקום שלה ל-
global, תבנית ההנחיה לשרת מוקצה אוטומטית בכל המיקומים (כוללglobal), ואפשר להשתמש בה עם שני ספקי Gemini API. עם זאת, אם מגדירים מיקום אחר כלשהו כשיוצרים את התבנית באמצעות API בארכיטקטורת REST, התבנית תהיה זמינה רק ל-Vertex AI Gemini API. בהמשך הדף מופיע מידע נוסף על הגדרת מיקום ספציפי לתבנית.שימו לב: כשמשתמשים בממשק המשתמש המודרך במסוף Firebase, התבנית מוקצה אוטומטית גם בכל המיקומים (כולל
global), והיא זמינה לשימוש עם שני ספקי Gemini API.כדי לגשת לתבנית של הנחיה לשרת בבקשת
templateGenerateContentאוtemplateStreamGenerateContentבאמצעות API בארכיטקטורת REST, צריך להשתמש בנקודת הקצה שספציפית לספק Gemini API שלכם (Gemini Developer API | Vertex AI Gemini API).
(Vertex AI Gemini API בלבד) הגדרת מיקום ספציפי לתבנית
הקטע הזה רלוונטי למצבים הבאים:
תרחיש השימוש באפליקציה שלך כולל דרישות שמבוססות על מיקום.
הבקשות של האפליקציה משתמשות ב-Vertex AI Gemini API ואתם מציינים מיקום לגישה למודל.
כמו שמתואר בהמשך הדף, תבנית של הנחיה לשרת מוקצה אוטומטית לכל
האזורים הזמינים ל-Firebase AI Logic (כולל global) אם מבצעים את אחת מהפעולות הבאות:
- יוצרים את התבנית באמצעות ממשק המשתמש המודרך במסוף Firebase.
- יוצרים את התבנית באמצעות API בארכיטקטורת REST ו מגדירים את המיקום שלה ל-
global.
המשמעות היא שאפשר להגדיר בבקשה של האפליקציה את המיקום לאחד מהאזורים הזמינים של Firebase AI Logic, והתבנית תהיה זמינה.
אתם לא נדרשים להגדיר את המיקום בבקשה של האפליקציה אל global.
עם זאת, אם רוצים שהתבנית תהיה זמינה רק במיקום ספציפי, צריך ליצור את התבנית באמצעות API בארכיטקטורת REST ולהגדיר את המיקום הספציפי הזה באופן מפורש. לא להגדיר את המיקום כ-global.
כדי ליצור את התבנית, קוראים לנקודת הקצה
projects.locations.templates.create. מציינים אתlocationשל התבנית (לדוגמה,europe-west4) כחלק מיצירתPromptTemplate.בבקשה של האפליקציה, מוודאים שהמיקום שבו ניגשים למודל זהה למיקום של התבנית (
europe-west4).
חשוב לשים לב לנקודות הבאות:
ברשימת התבניות במסוף Firebase מוצגות רק תבניות שהוקצו (לפחות) במיקום
global.אם משתמשים ב-API בארכיטקטורת REST כדי להקצות תבנית במיקום ספציפי (שלא
global), המיקום שבו ניגשים למודל בבקשה של האפליקציה חייב להיות זהה למיקום שהוגדר לתבנית. אם המיקומים לא תואמים, הבקשה תיכשל (בגלל מדיניות הבידוד האזורי).
שליחת התבנית כקובץ
אפשר לספק את התוכן של קובץ תבנית של הנחיה לשרת על ידי קריאה לנקודת הקצה projects.locations.templates.create.