תחילת העבודה
בדף זה
המדריך הזה לוקח מתקן מאפס לבקשה ראשונה שעובדת בשלושה שלבים, ואז מראה איך לבדוק שהיא הצליחה.
לפני שמתחילים
- אתם צריכים להיות Organisation Administrator. Model Router זמין ל-Organisation Administrators בלבד, במתקני Technology Stack.
- בחרו את המתקן שאתם רוצים להגדיר באמצעות בורר המתקנים בסרגל הכלים הראשי של Performance Hub.
- ודאו שיש כרטיס חיוב שמור עבור המתקן, או היו מוכנים להוסיף אחד. טעינות מחייבות את כרטיס החיוב השמור שלכם; אם אין כרטיס שמור, הדף Balance & Top-up מציג "No card on file." עם קישור Add payment details.
שלב 1 — הפעלת Model Router
פתחו את Model Router מהתפריט הראשי (בקבוצה AI Modules & Agents). אם המודול עדיין לא הופעל עבור המתקן הזה, יוצג הדף Welcome to Model Router:
"תנו לעסק שלכם גישה בתשלום מראש לקטלוג של מודדי AI מובילים דרך קצה צינור (endpoint) יחיד התואם ל-OpenAI. סוכני ה-AI של Performance Hub מתחברים באופן אוטומטי, ותוכלו ליצור מפתחות API כדי לחבר את אותם מודלים לתוכנה שלכם — עם מגבלות הוצאה ונראות שימוש מלאה."
איור 1: הדף Welcome to Model Router שמתקן רואה לפני שהמודול מופעל
בדף יש שלושה לחצנים: Enable Model Router, Read the documentation (שפותח את התיעוד הזה) ו-Explore first without enabling. מתחתם, שלושה שלבים מתארים את ההגדרה:
| שלב | מה כתוב בו | לחצן |
|---|---|---|
| 1. Enable & add a billing card | "Turn on prepaid AI inference for this facility and store a billing card if you have not already — nothing is charged until you top up." | Enable module |
| 2. Top up your balance | "Add prepaid credit with your stored billing card (minimum $10). Turn on auto top-up so inference never stops because the balance ran out." | Top up |
| 3. Connect an agent or create an API key | "Paired AI Agent devices connect automatically. For your own software, create an API key and point any OpenAI-compatible SDK at our endpoint." | Create an API key |
לכל שלב יש גם קישור Learn more.
לחצו על Enable Model Router (או Enable module) כדי להפעיל את המודול.
רשימת המשימות להגדרה
לאחר שתפעילו את המודול, באנר עם רשימת משימות להגדרה מוצג בראש Model Router עד שההגדרה הושלמה. הכותרת שלו היא Finish setting up Model Router, והוא מציג הערכת זמן (לדוגמה ~3 min left), כמה שלבים הושלמו (לדוגמה 2 of 3 complete) ולחצן Resume שמרחיב את רשימת המשימות המלאה. לכל שלב יש Review (או Review again) ו-Learn more; Collapse מקפל אותה שוב. כשנותר שלב אחד, כותרת המשנה המורחבת היא "Just one step to go before AI requests start flowing. Steps can be done in any order."
איור 2: באנר רשימת המשימות להגדרה שמוצג עד שההגדרה הושלמה
שלבי החובה הם Add a billing card, Top up your balance ו-Connect an agent or create an API key. את השלבים האופציונליים — Set spend limits, Turn on auto top-up ו-Verify your first request — אפשר לדחות באמצעות Skip for now.
שלב 2 — ביצוע הטעינה הראשונה
עברו אל Budgets & Limits ← Balance & Top-up.
איור 3: הכרטיס Top up balance (סכומים קבועים מראש, סכום, כרטיס שמור) והכרטיס Auto top-up
- בכרטיס Top up balance, בחרו סכום קבוע מראש ($25, $50, $100, $250, $500, $1000) או הקלידו סכום. "Minimum top-up is $10."
- בדקו את הכרטיס השמור שמוצג מתחת לסכום (לדוגמה "Amex ending 0005 · exp 06/29"). השתמשו ב-Edit payment details אם צריך לעדכן אותו.
- לחצו על Top up $–.––. בהצלחה יוצג "Top-up successful. Your balance has been credited." הטעינות מופיעות ביתרה מיד.
מומלץ: בכרטיס Auto top-up, הפעילו את Enable auto top-up, הגדירו את When balance is below ואת Top up by (גם כן לפחות $10), ולחצו על Save changes. מעכשיו הכרטיס שלכם יחויב אוטומטית בכל פעם שהיתרה יורדת מתחת לסף, כך שההסקה לעולם לא תיעצר באופן בלתי צפוי. לפרטים, ראו תקציבים וטעינות.
שלב 3 — שליחת הבקשה הראשונה
בחרו את המסלול שמתאים לכם:
אם יש לכם AI Agents או Workflows
אין מה להגדיר — מכשירי סוכן בינה מלאכותית שמצומדים למתקן הזה מתחברים אוטומטית, וגם Workflows יכולים להתחבר. פתחו את Settings (גלגל השיניים) ← Service Access & API Keys וודאו שהסוכן שלכם מופיע תחת Connected Services בסטטוס באינטרנט. ראו Connected Services.
אם אתם מחברים את התוכנה שלכם
- פתחו את Settings (גלגל השיניים) ← Service Access & API Keys ולחצו על Create key. העתיקו את הסוד מתיבת הדו-שיח "Copy your API key" — "This is the only time the full key is shown. Store it somewhere safe."
- השתמשו ב-Base URL ובבקשת הדוגמה שמוצגים בכרטיס Connecting to the API באותו דף. בדיקה מינימלית:
curl https://app.performancehub.co/ai/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "auto", "messages": [{"role": "user", "content": "Hello"}]}'
ראו חיבור האפליקציה שלכם לדוגמאות ב-Python וב-TypeScript.
שלב 4 — אימות
פתחו את הכרטיסייה Logs. בקשת הבדיקה שלכם אמורה להופיע תוך רגעים, עם המודל, מספרי הטוקנים, העלות, המהירות וסטטוס success. אם היא לא מופיעה, ראו פתרון בעיות.
השלבים הבאים המומלצים
- הגדירו מגבלות הוצאה — Budgets & Limits ← Spend Limits. תקרה חודשית היא רשת ביטחון הגיונית; ראו תקציבים וטעינות.
- עברו על קטלוג המודלים — Settings ← Models. כל המודלים מופעלים כברירת מחדל; השתמשו בהגדרות הקבועות מראש המהירות כדי לצמצם את הבחירה אם יש לכם העדפות לגבי ספקים או תקציב. ראו Models.
- שקלו להפעיל Guardrails — Settings ← Guardrails למיסוך PII, הסתרת סודות והגנה מפני הזרקת הנחיות. אף אחת מהן אינה מופעלת כברירת מחדל. ראו Guardrails.