הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.
לעיון במסמכי התיעוד של Apigee Edge.
בדף הזה מוסבר איך להגדיר שרת proxy ל-API כתבנית תכונה של Apigee ב-YAML, ולפרוס אותו באמצעות Google Cloud CLI. קודם יוצרים שרת proxy פשוט, ואז יוצרים דוגמה מלאה יותר שמופיעה לפני מודל Gemini.
למידע נוסף, קראו את המאמר הגדרת שרת proxy באמצעות YAML. הסכימה המלאה מופיעה במאמר הפניית הגדרות YAML של שרת proxy ל-API.
לפני שמתחילים
רק לחלק 2: מפעילים את Agent Platform API בפרויקט ב-Google Cloud שמארח את המודל:
gcloud services enable aiplatform.googleapis.com \ --project=PROJECT_IDמחליפים את PROJECT_ID במזהה הפרויקט שמארח את המודל, לדוגמה
my-apigee-project. במדריך הזה משתמשים בפרויקט של הארגון שלכם ב-Apigee. בחלק 1 לא צריך את ה-API הזה. לא צריך לבחור אזור, כי התבנית משתמשת בנקודת הקצה הגלובלית. יכול להיות שיעבור קצת זמן עד שה-API יהיה פעיל אחרי שתפעילו אותו.- מתקינים ומפעילים את Google Cloud CLI.
- ארגון ב-Apigee וסביבה אחת לפחות. שימו לב לשמות הארגון והסביבה. בדוגמאות נעשה שימוש ב-ORG וב-ENV כפלייסהולדרים (ראו פלייסהולדרים שנעשה בהם שימוש בדף הזה). שער ה-AI בחלק 2 דורש גם סביבה בינונית או מקיפה (לא סביבה בסיסית). ראו סוגי סביבות ב-Apigee.
- מוודאים שיש לכם את ההרשאות הנדרשות:
- כדי לייבא (ליצור) שרת proxy ל-API: התפקיד אדמין API (
roles/apigee.apiAdmin) או תפקיד מקביל שמעניק את ההרשאהapigee.proxies.create. - כדי לפרוס שרת proxy ל-API: אדמין סביבה (
roles/apigee.environmentAdmin) בסביבת היעד, וקורא API (roles/apigee.apiReaderV2) ברמת הפרויקט. - כדי ליצור את מוצר ה-API, המפתח והאפליקציה שמפיקים את מפתח ה-API בחלק 2, שלב 6: אדמין של API (
roles/apigee.apiAdmin) ואדמין של מפתחים (roles/apigee.developerAdmin). לרשימה המלאה של התפקידים, ראו התפקידים ב-Apigee.
- כדי לייבא (ליצור) שרת proxy ל-API: התפקיד אדמין API (
פלייסהולדרים שמופיעים בדף הזה
מחליפים כל פלייסהולדר בפקודות בערך משלכם. רוב הערכים כבר קיימים ואתם מחפשים אותם. אתם בוחרים את SA_NAME בעצמכם, וחלק מהערכים נוצרים תוך כדי ביצוע השלבים.
| Placeholder | מקור | תיאור |
|---|---|---|
| ORG | חיפוש | שם הארגון שלכם ב-Apigee. בדרך כלל זה אותו ערך כמו PROJECT_ID. כדי להציג את רשימת הארגונים שיש לכם גישה אליהם, מריצים את הפקודה gcloud apigee organizations list. |
| ENV | חיפוש | סביבה בארגון, לדוגמה test.
בשלב 4 של חלק 1 מוסבר איך להציג אותם. |
| PROJECT_ID | חיפוש | המזהה של הפרויקט בענן ב-Google Cloud שבו נמצא הארגון ב-Apigee, לדוגמה my-apigee-project. כדי להדפיס את הפרויקט הפעיל, מריצים את gcloud config get project. |
| HOSTNAME | חיפוש | שם מארח של קבוצת סביבות שמכילה את ENV, לדוגמה api.example.com. חלק 1, שלב 5
מראה איפה למצוא אותו. |
| SA_NAME | אתם בוחרים | שם לחשבון השירות שיוצרים בחלק 2, שלב 3, לדוגמה apigee-ai-gateway. |
| PROJECT_NUMBER | חיפוש | מספר הפרויקט של PROJECT_ID, לדוגמה 123456789012.
בשלב 3 בחלק 2 מוצגת הפקודה שמדפיסה אותו. |
| REGION | אתם בוחרים | זה שינוי אופציונלי. האזור שבו המודל פועל, לדוגמה us-central1. צריך להשתמש בו רק אם מעבירים את התכונה gemini-target לנקודת קצה אזורית. |
| REVISION | נוצר | מספר הגרסה של שרת ה-proxy שמוצג בפלט של פקודת הייבוא בחלק 2, שלב 4, לדוגמה 1. |
| API_KEY | נוצר | מפתח ה-API שנוצר על ידי Apigee כשרושמים אפליקציית מפתח בחלק 2, שלב 6. |
חלק 1: יצירת proxy ל-API
בקטע הזה יוצרים שרת proxy שמעביר בקשות לשירות היעד המדומה של Apigee ואוכף הגבלת קצב של יצירת בקשות.
שלב 1: יוצרים את התבנית
תבנית היא הקובץ שאתם פורסים. הוא מגדיר את נתיב הבסיס, את המסלולים ואת יעד הקצה העורפי של שרת ה-Proxy, ומפרט את התכונות שצריך לכלול.
יוצרים ספריית פרויקט לתבניות, עם תת-ספרייה features לתכונות שבהן משתמשים:
mkdir -p proxy-templates/features cd proxy-templates
כשמסיימים את החלק הזה, ספריית הפרויקט נראית כך:
proxy-templates/ hello-proxy.yaml features/ spike-arrest.yaml
בספרייה proxy-templates, יוצרים קובץ בשם hello-proxy.yaml:
gateway: apigee schemaVersion: 1.0.0 name: hello-proxy type: template description: A simple proxy to the Apigee mock target, protected by a rate limit. features: - ./features/spike-arrest.yaml endpoints: - name: default basePath: /hello routes: - name: default target: default targets: - name: default url: https://mocktarget.apigee.net
התבנית הזו מגדירה:
- נקודת קצה עם נתיב הבסיס
/hello. לקוחות קוראים לשרת ה-proxy בנתיב הזה. - נתיב ששולח בקשות ליעד בשם
default. - יעד שמפנה לכתובת ה-URL של הקצה העורפי.
- תכונה,
spike-arrest.yaml, שתיצרו בשלב הבא.
שלב 2: יצירת התכונה
תכונה היא יחידת הגדרה שאפשר להשתמש בה שוב ושוב, והיא מכילה כללי מדיניות. תבנית לא יכולה להכיל כללי מדיניות באופן ישיר, ולכן מדיניות הגבלת הקצב של יצירת הבקשות נמצאת בתכונה.
בספרייה features, יוצרים קובץ בשם spike-arrest.yaml:
gateway: apigee schemaVersion: 1.0.0 name: spike-arrest displayName: Spike Arrest type: feature description: Protects the backend by smoothing traffic spikes. categories: - traffic parameters: - name: RATE displayName: RATE description: Maximum request rate, for example 30ps (per second) or 100pm (per minute). default: 30ps examples: - 30ps - 100pm defaultEndpoint: name: default flows: - name: PreFlow mode: Request steps: - name: SA-SpikeArrest policies: - name: SA-SpikeArrest type: SpikeArrest content: SpikeArrest: metadata: name: SA-SpikeArrest enabled: "true" continueOnError: "false" DisplayName: SA-SpikeArrest Rate: "{RATE}"
פרטים לגבי התכונה:
- מגדירה מדיניות SpikeArrest שמגבילה את קצב הבקשות.
- משתמש ב-
defaultEndpoint.flowsכדי להוסיף את המדיניות ל-PreFlow של הבקשה, כך שהיא תפעל בכל בקשה. - מצהירה על פרמטר,
RATE, שערך ברירת המחדל שלו (30ps) מוחלף ב-{RATE}כשהשרת proxy עובר הידור.
שלב 3: מייבאים את ה-proxy
מייבאים את התבנית כדי ליצור גרסה של שרת proxy ל-API. מריצים את הפקודה הזו מהספרייה proxy-templates, שמכילה את התבנית:
gcloud apigee apis import hello-proxy \
--from-template=hello-proxy.yaml \
--organization=ORGה-CLI מקמפל את התבנית והתכונה שלה לחבילת proxy ל-API, מעלה אותה ומדפיס את גרסת ה-proxy החדשה. הייבוא יוצר גרסה אבל לא פורס אותה.
שלב 4: פריסת שרת ה-proxy
מציגים את הסביבות בארגון:
gcloud apigee environments list --organization=ORG
הפקודה מדפיסה את שמות הסביבות. בוחרים אחת מהן שתשמש כ-ENV, ופורסים בה את הגרסה:
gcloud apigee apis deploy \
--api=hello-proxy \
--environment=ENV \
--organization=ORGכברירת מחדל, הפקודה הזו פורסת את הגרסה האחרונה. כדי לפרוס גרסה ספציפית, מעבירים את המספר שלה כארגומנט הראשון, לדוגמה gcloud apigee apis deploy 1 --api=hello-proxy --environment=ENV.
אם כבר נפרס שרת proxy אחר באותו נתיב בסיס, מוסיפים את --override כדי להחליף אותו בלי זמן השבתה.
שלב 5: קריאה לשרת ה-proxy
כדי לקרוא לשרת ה-proxy שנפרס ברשת, הסביבה צריכה להיות מצורפת לקבוצת סביבות שיש לה שם מארח שניתן לניתוב. אם רק יצרתם את הארגון, ודאו שההגדרה הזו הושלמה לפני שאתם קוראים לשרת proxy. תוכלו לקרוא מידע נוסף במאמר מידע על סביבות וקבוצות סביבה.
מאתרים את שם המארח של קבוצת הסביבות שמכילה את הסביבה שלכם:
- במסוף Google Cloud , נכנסים לדף Apigee > Management > Environments.
- לוחצים על הכרטיסייה Environment groups.
- מוצאים את קבוצת הסביבות שמכילה את הסביבה שלכם ומעתיקים ערך מהעמודה Hostnames.
קוראים לשרת ה-Proxy בשם המארח הזה, באמצעות נתיב הבסיס מהתבנית:
curl https://HOSTNAME/hello
מחליפים את HOSTNAME בשם המארח שהעתקתם. תגובה מוצלחת מגיעה משירות היעד המדומה.
חלק 2: יצירת שער AI ל-Gemini
בקטע הזה נבנה שרת proxy שלם יותר: שער AI שמעביר בקשות למודל Gemini ב-Gemini Enterprise Agent Platform, אוכף מגבלת קצב של יצירת בקשות ודורש מפתח API. הוא משתמש בתבנית אחת, בשלוש תכונות ובחשבון שירות.
בניגוד לשרת ה-proxy הפשוט בחלק 1, שרת ה-proxy הזה קורא לשירות של Google Cloud (Agent Platform).
התכונה gemini-target משתמשת ב-auth: GoogleAccessToken, ולכן Apigee מצרפת אסימון Google OAuth לכל בקשה ל-Agent Platform. האסימון הזה מונפק לחשבון שירות שאתם יוצרים ומספקים כשאתם פורסים את שרת ה-proxy, ולכן החלק הזה מוסיף שלב ליצירת חשבון השירות (שלב 3).
לפני שמתחילים, ודאו ש-Agent Platform API מופעל בפרויקט שבו נמצא המודל, כמו שמתואר בקטע לפני שמתחילים. לא צריך ניסיון קודם בשימוש ב-Agent Platform.
בחלק השני, PROJECT_ID הוא המזהה של הפרויקט של הארגון ב-Apigee, לדוגמה my-apigee-project. בחלק 2 משתמשים בפרויקט הזה לאורך כל התהליך: מפעילים בו את ה-API, יוצרים בו את חשבון השירות ומגדירים אותו כערך של MODEL_PROJECT_ID בתבנית.
שלב 1: יוצרים את התבנית
בספרייה proxy-templates מחלק 1, יוצרים קובץ בשם ai-gateway.yaml:
gateway: apigee schemaVersion: 1.0.0 name: ai-gateway type: template description: AI gateway that fronts a Gemini model with throttling and API key enforcement. features: - ./features/spike-arrest.yaml - ./features/verify-api-key.yaml - ./features/gemini-target.yaml parameters: - name: MODEL_PROJECT_ID default: PROJECT_ID - name: MODEL default: gemini-3.8-flash endpoints: - name: gemini basePath: /v1/gemini routes: - name: default target: gemini
הרשימה parameters מגדירה ערכים לפרמטרים שהפונקציה gemini-target מצהירה עליהם, אותם יוצרים בשלב הבא.
מחליפים את PROJECT_ID במזהה הפרויקט שבו השתמשתם כדי להפעיל את ה-API, לדוגמה my-apigee-project.
שלב 2: יוצרים את התכונות
התבנית משתמשת בשלוש תכונות. משתמשים שוב בתכונה spike-arrest.yaml מחלק 1, ויוצרים את שתי התכונות האחרות בספרייה features. בסיום השלב הזה, ספריית הפרויקט נראית כך:
proxy-templates/ hello-proxy.yaml ai-gateway.yaml features/ spike-arrest.yaml verify-api-key.yaml gemini-target.yaml
יוצרים את features/verify-api-key.yaml כדי לדרוש מפתח API בכותרת x-api-key:
gateway: apigee schemaVersion: 1.0.0 name: verify-api-key displayName: Verify API Key type: feature description: Requires a valid API key in the x-api-key request header. categories: - security defaultEndpoint: name: default flows: - name: PreFlow mode: Request steps: - name: VA-VerifyAPIKey policies: - name: VA-VerifyAPIKey type: VerifyAPIKey content: VerifyAPIKey: metadata: name: VA-VerifyAPIKey enabled: "true" continueOnError: "false" DisplayName: VA-VerifyAPIKey APIKey: metadata: ref: request.header.x-api-key
יוצרים את features/gemini-target.yaml כדי לנתב למודל Gemini, עם אימות באמצעות אסימון גישה של Google:
gateway: apigee schemaVersion: 1.0.0 name: gemini-target displayName: Gemini Target type: feature description: Routes requests to a Gemini model on the Gemini Enterprise Agent Platform, authenticated with a Google access token. categories: - llm parameters: - name: MODEL_PROJECT_ID displayName: Model Project ID description: Google Cloud project that hosts the Gemini model. Supplied by the template; no default. - name: MODEL displayName: Model description: The Gemini model to route to. default: gemini-3.8-flash examples: - gemini-3.8-flash - gemini-4-argon targets: - name: gemini url: https://aiplatform.googleapis.com/v1/projects/{MODEL_PROJECT_ID}/locations/global/publishers/google/models/{MODEL}:generateContent auth: GoogleAccessToken scopes: - https://www.googleapis.com/auth/cloud-platform
התכונה gemini-target מצהירה על שני פרמטרים ומחליפה אותם בכתובת ה-URL של היעד:
-
MODEL_PROJECT_ID: הפרויקט ב- Google Cloud שבו נמצא המודל. אין לו ערך ברירת מחדל, ולכן צריך להגדיר אותו בתבנית למזהה הפרויקט שלכם. -
MODEL: מודל Gemini שרוצים להפעיל. ברירת המחדל של התכונה היאgemini-3.8-flash.
כשה-CLI מקמפל את התבנית, הוא פותר כל פרמטר באופן הבא:
- אם ברשימה
parametersשל התבנית יש רשומה עם אותו שם וערךdefaultלא ריק, ה-CLI משתמש בערך הזה. - אחרת, ה-CLI משתמש ב-
defaultשל התכונה. - אם לא מוגדר ערך באף אחד מהם, ה-CLI מחליף את
{name}במחרוזת ריקה. הייבוא לא מדווח על שגיאה, כך שאם חסרMODEL_PROJECT_ID, נוצרת כתובת URL לטירגוט בלי מזהה פרויקט.
אין דגל בשורת הפקודה להגדרת ערכי פרמטרים בזמן הייבוא. כדי להשתמש בפרויקט או במודל אחר, עורכים את הערך שלו ברשימה parameters של התבנית ומייבאים את התבנית שוב.
התכונה gemini-target משתמשת ב-auth: GoogleAccessToken כדי ש-Apigee יצרף טוקן גישה של Google לכל בקשה ל-Agent Platform.
כתובת ה-URL משתמשת בנקודת הקצה (endpoint) הגלובלית (המארח aiplatform.googleapis.com ו-locations/global), שמשרתת את gemini-3.8-flash ומנתבת בקשות לקיבולת זמינה באזורים שונים. כשמשתמשים בנקודת הקצה הגלובלית, לא צריך לבחור אזור.
כדי להפעיל מודל אחר, מגדירים את MODEL ברשימה parameters של התבנית למזהה של המודל. כדי להציג את רשימת מודלי Gemini שאפשר להפעיל, מריצים את הפקודה:
gcloud ai model-garden models list --model-filter=gemini
כל ערך בעמודה MODEL_ID נראה כמו google/gemini-3.8-flash@default. מגדירים את MODEL לחלק שבין google/ ל-@, למשל gemini-4-argon. המזהה הזה מופיע גם בכרטיס של המודל ב-Model Garden במסוףGoogle Cloud . כדי לבדוק אם מודל תומך בנקודת הקצה הגלובלית, עיינו בכרטיסייה Global במאמר מיקומי נקודות הקצה של מודלים של Google.
אם אתם צריכים לשלוט באזור שבו הבקשות מעובדות, החליפו את השורה url בקובץ features/gemini-target.yaml בפורמט האזורי, שבו האזור מופיע גם במארח וגם בנתיב:
url: https://REGION-aiplatform.googleapis.com/v1/projects/{MODEL_PROJECT_ID}/locations/REGION/publishers/google/models/{MODEL}:generateContent
מחליפים את REGION באזור שבו המודל פועל, כמו שמופיע בטבלאות של מיקומי נקודות הקצה של המודלים של Google. בקטע נקודת קצה גלובלית מוסבר מתי כדאי להימנע משימוש בנקודת הקצה הגלובלית.
שלב 3: יצירת חשבון שירות לשרת ה-proxy
התכונה gemini-target משתמשת ב-auth: GoogleAccessToken, ולכן שרת ה-proxy שנפרס קורא ל-Agent Platform כחשבון שירות.
יוצרים את חשבון השירות הזה, נותנים לו גישה ל-Agent Platform ומאפשרים לסוכן השירות של Apigee להשתמש בו. אתם מספקים את חשבון השירות הזה כשאתם פורסים את שרת ה-proxy בשלב 5. למידע נוסף, ראו שימוש באימות של Google.
- יוצרים חשבון שירות שמנוהל על ידי משתמש באותו פרויקט ב- Google Cloud שבו נמצא הארגון ב-Apigee. (חשבון השירות שמוגדר כברירת מחדל ב-Compute Engine לא מתקבל). במאמר יצירה וניהול של חשבונות שירות מוסבר איך יוצרים חשבון שירות בדרכים אחרות.
gcloud iam service-accounts create SA_NAME \ --project=PROJECT_ID \ --display-name="Apigee AI gateway"בוחרים שם תיאורי ל-SA_NAME, לדוגמה
apigee-ai-gateway. הפקודה יוצרת את חשבון השירותSA_NAME@PROJECT_ID.iam.gserviceaccount.com, לדוגמהapigee-ai-gateway@my-apigee-project.iam.gserviceaccount.com. - נותנים לחשבון השירות גישה לקצה העורפי שהוא קורא לו. כדי להגדיר יעד ב-Agent Platform, צריך להקצות את התפקיד משתמש ב-Agent Platform (
roles/aiplatform.user):gcloud projects add-iam-policy-binding PROJECT_ID \ --member="serviceAccount:SA_NAME@PROJECT_ID.iam.gserviceaccount.com" \ --role="roles/aiplatform.user"אם מדיניות ה-IAM של הפרויקט כבר מכילה קישורי תפקידים מותנים, צריך להוסיף את
--condition=Noneלפקודה הזו. - כדי לאפשר לסוכן השירות של Apigee להנפיק אסימונים לחשבון השירות, מקצים לו את התפקיד יצירת אסימונים בחשבון שירות (
roles/iam.serviceAccountTokenCreator) בחשבון השירות:gcloud iam service-accounts add-iam-policy-binding \ SA_NAME@PROJECT_ID.iam.gserviceaccount.com \ --project=PROJECT_ID \ --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-apigee.iam.gserviceaccount.com" \ --role="roles/iam.serviceAccountTokenCreator"כדי למצוא את PROJECT_NUMBER, מריצים את
gcloud projects describe PROJECT_ID --format='value(projectNumber)'.
שלב 4: מייבאים את שרת ה-proxy
מייבאים את התבנית כדי ליצור גרסה של שרת proxy ל-API. מריצים את הפקודה הזו מהספרייה proxy-templates, שמכילה את התבנית:
gcloud apigee apis import ai-gateway \
--from-template=ai-gateway.yaml \
--organization=ORGשימו לב למספר הגרסה בפלט הפקודה. תצטרכו אותו בשלב 5. כדי להדפיס רק את מספר הגרסה, מוסיפים את --format="value(revision)" לפקודת הייבוא.
שלב 5: פריסת שרת ה-proxy עם חשבון השירות
פריסת שער ה-AI שונה מהפרוקסי הפשוט בחלק 1 בשתי דרכים:
- אתם צריכים לספק את חשבון השירות שיצרתם בשלב 3. אם תפרסו בלי להגדיר, הפריסה תיכשל ותוצג השגיאה
MISSING_SERVICE_ACCOUNT. - צריך לפרוס בסביבה בינונית או מקיפה.
הפרוקסי הזה משתמש במדיניות שניתנת להרחבה, שלא נתמכת בסביבת Base. פריסה בסביבה כזו נכשלת עם השגיאה
Extensible proxy can not be deployed to a base environment
. הפקודהgcloud apigee environments listלא מדפיסה את סוג הסביבה. כדי לבדוק את זה, במסוף Google Cloud , נכנסים אל Apigee > Management > Environments. סוגי הסביבות של Apigee
בממשק המשתמש של Apigee: פורסים את שרת ה-proxy, וכשמופיעה בקשה להזין חשבון שירות, מזינים את SA_NAME@PROJECT_ID.iam.gserviceaccount.com.
במאמר פריסת שרת proxy ל-API מוסבר איך לעשות זאת.
Deployment API: קוראים ל-deployments API ומעבירים את חשבון השירות בתור הפרמטר serviceAccount של השאילתה. מחליפים את REVISION במספר הגרסה משלב 4:
curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -X POST \ "https://apigee.googleapis.com/v1/organizations/ORG/environments/ENV/apis/ai-gateway/revisions/REVISION/deployments?serviceAccount=SA_NAME@PROJECT_ID.iam.gserviceaccount.com"
בקשת הפריסה מוחזרת באופן מיידי, הפריסה היא אסינכרונית. בודקים את סטטוס הפריסה של הגרסה, שמופיע כ-PROGRESSING עד שהוא משתנה ל-READY:
curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://apigee.googleapis.com/v1/organizations/ORG/environments/ENV/apis/ai-gateway/revisions/REVISION/deployments"
כשהשרת proxy עובר קומפילציה, התכונות spike-arrest ו-verify-api-key מוסיפות את כללי המדיניות שלהן ל-PreFlow של הבקשה (קודם הגבלת קצב של יצירת בקשות, ואז בדיקת מפתח ה-API), והתכונה gemini-target מוסיפה את הקצה העורפי של Agent Platform. אחרי שהפריסה מסתיימת, שרת ה-proxy מאמת את Agent Platform בתור חשבון השירות שלכם.
שלב 6: קבלת מפתח API
התכונה verify-api-key דוחה כל בקשה שלא כוללת מפתח API תקין, ולכן צריך מפתח לפני שאפשר לשלוח קריאה לשרת ה-proxy. מפתח API הוא פרטי כניסה של אפליקציית מפתחים שמשויכת למוצר API שמכיל את שרת ה-proxy הזה. מבצעים את המשימות הבאות, שמתוארות במאמר סיכום השינויים לפרסום:
- יוצרים מוצר API שכולל את שרת ה-proxy של
ai-gateway. בטופס המוצר, מזינים את הפרטים הבאים ולוחצים על Save:- שם ושם לתצוגה: כל ערך, לדוגמה
ai-gateway-product. - Environment: הסביבה שבה פרסתם את שרת ה-proxy (ENV).
- גישה: ציבורי. משאירים את האפשרות Automatically approve access requests מסומנת כדי שמפתח ה-API יאושר כשתרשמו את האפליקציה.
- בקטע Operations, לוחצים על + ADD AN OPERATION ומגדירים את השדות הבאים:
- proxy ל-API:
ai-gateway. - נתיב:
/. הבקשות מגיעות לנתיב הבסיס של שרת ה-proxy,/v1/gemini, בלי שום דבר אחריו. הנתיב/תואם לנתיב הבסיס,/**תואם רק לנתיבים שמתחתיו, ולכן בקשה ל-/v1/geminiנכשלת עם השגיאהoauth.v2.InvalidApiKeyForGivenResource. הגדרת נתיבי משאבים - Methods:
POST.
- proxy ל-API:
- משאירים ריקים את השדות API quota limit, LLM token quota limit, Quota של הפעולה ואת הקטע LLM Operations.
התכונה
spike-arrestבשרת ה-proxy אוכפת את הגבלת קצב של יצירת בקשות.
- שם ושם לתצוגה: כל ערך, לדוגמה
- רישום מפתח אפליקציות.
- רושמים אפליקציית מפתח ובוחרים את מוצר ה-API כשיוצרים את האפליקציה, כדי שהמפתח החדש ישויך למוצר מההתחלה.
רישום האפליקציה יוצר את המפתח. כדי לאחזר אותו, קראו את המאמר הצגת מפתח API וסוד.
שלב 7: קריאה לשרת ה-proxy
מוצאים את שם המארח של קבוצת הסביבות, כמו שמתואר בחלק 1, שלב 5, ואז קוראים לשרת ה-proxy בנתיב הבסיס /v1/gemini. מעבירים את מפתח ה-API בכותרת x-api-key ושולחים את גוף הבקשה generateContent של Gemini:
curl -X POST https://HOSTNAME/v1/gemini \
-H "x-api-key: API_KEY" \
-H "Content-Type: application/json" \
-d '{"contents":[{"role":"user","parts":[{"text":"Say hello in one sentence."}]}]}'מחליפים את HOSTNAME בשם המארח של קבוצת הסביבות, ואת API_KEY במפתח משלב 6. תגובה מוצלחת היא פלט ה-JSON של המודל. אם לא תשלחו את המפתח, תקבלו הודעה על כשל באימות ממדיניות VerifyAPIKey, מה שמאשר שהתכונה verify-api-key פועלת. במאמר שליחת בקשה עם מפתח API תקין מוסבר איך להעביר מפתח בדרכים אחרות.
השלבים הבאים
- הפניה להגדרת YAML של שרת proxy ל-API
- הגדרת שרת proxy באמצעות YAML
- פריסת שרתי proxy ל-API
- סיכום השינויים לפרסום