ב-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דרך API בארכיטקטורת REST, צריך להשתמש בנקודת הקצה שספציפית לפלאגין שמתממשק עם שירותים חיצוניים 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.
כדי ליצור את התבנית, קוראים לנקודת הקצה
projects.locations.templates.create. מציינים אתlocationשל התבנית (לדוגמה,europe-west4) במסגרת יצירתPromptTemplate.בבקשה של האפליקציה, מוודאים שהמיקום שבו ניגשים למודל זהה למיקום של התבנית (
eu).
חשוב לשים לב לנקודות הבאות:
ברשימת התבניות במסוף Firebase מוצגות רק תבניות שהוקצו (לפחות) במיקום
global.אם משתמשים ב-API בארכיטקטורת REST כדי להקצות תבנית במיקום ספציפי (שלא
global), אז המיקום שבו ניגשים למודל בבקשה של האפליקציה חייב להיות זהה למיקום שהוגדר לתבנית. אם המיקומים לא תואמים, הבקשה תיכשל (בגלל מדיניות בידוד אזורי).
העברת התבנית כקובץ
אפשר לספק את התוכן של קובץ תבנית פרומפט לשרת על ידי קריאה לנקודת הקצה projects.locations.templates.create.