ב-Firebase AI Logic, מסוף Firebase מספק ממשק משתמש מודרך שמאפשר לציין את התוכן של התבנית. עם זאת, יש כמה תרחישים שבהם תצטרכו להשתמש בדרכים מתקדמות יותר כדי להגדיר תבנית, כולל:
תהליכי העבודה המתקדמים שמתוארים בדף הזה משתמשים ב-API בארכיטקטורת REST של Firebase AI Logic.
מידע חשוב על השימוש ב-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.