ניהול מתאמים ומודלים
מדריך זה מראה כיצד לחבר ספקי מודלים ולבחור על מה סוכן רץ.
הכול נמצא בעמוד אחד: הגדרות ← שרת ← ספקי מודלים. הערך בסרגל הצד המשני נקרא “ספקי מודלים”; כותרת העמוד נקראת “מתאמים”.
מהו מתאם
קטע בשם “מהו מתאם”מתאם הוא ה_מריץ_ שמבצע תור של סוכן. יש שניים והרשימה קבועה — אי אפשר להוסיף שלישי.
| מתאם | CLI | תעבורה |
|---|---|---|
| Control Center (מובנה) | אין | לולאת סוכן בתוך התהליך, שמדברת עם ספקים ב-HTTP |
| Claude Code | claude |
claude -p --output-format stream-json |
Cursor, Codex, Anthropic, OpenAI והשאר הם ספקים על המתאם המובנה, ולא CLI נפרדים. מה שכן אפשר להוסיף הוא ספק נוסף — כל נקודת קצה תואמת OpenAI או Anthropic. על כך בקטע הבא.
חיבור ספק מודלים
קטע בשם “חיבור ספק מודלים”המתאם המובנה זקוק לפחות לספק אחד מחובר לפני שהוא יכול לרוץ. בקטלוג יש ארבעה עשר ספקים.
- עברו אל הגדרות ← שרת ← ספקי מודלים
- גללו אל ספקים ומודלים
- אתרו את הספק שלכם וחברו אותו:
| ספק | איך לחבר |
|---|---|
| Anthropic | מפתח API. מינוי Claude Pro/Max אינו התחברות ל-API של Anthropic — השתמשו במתאם Claude Code בשביל התוכנית הזו |
| OpenAI, Codex, Cursor | התחברות OAuth בדפדפן, או מפתח API. Codex הוא ChatGPT Plus/Pro דרך ה-backend של Codex Responses, ולא הרצת CLI |
| Kimi Code | OAuth בדפדפן בלבד — זרימת קוד מכשיר. זו תוכנית בתעריף קבוע, ולכן אין לה מחיר לפי טוקן |
| OpenRouter, Google Gemini, DeepSeek, Mistral, xAI, z.ai, z.ai GLM Coding Plan, Moonshot (Kimi API) | מפתח API |
נקודת בקרה: התג בשורה משתנה ל“מחובר”, והרחבתה מפרטת את המודלים שאותו ספק מגיש, כל אחד עם מחירו למיליון טוקנים וחלון ההקשר שלו.
טוקני OAuth נשמרים במאגר פרטי הגישה של השרת עצמו ומתחדשים לפני שפג תוקפם. פרטי הגישה של הספקים הם גלובליים למארח — הם משותפים לכל סביבת עבודה בהתקנה, ולא מוגבלים לאחת.
הוספת ספק מותאם אישית
קטע בשם “הוספת ספק מותאם אישית”השתמשו בכך עבור Ollama, LM Studio, vLLM או פריסה פרטית.
- בספקים ומודלים, תחת ספקים מותאמים אישית, לחצו על הוספת ספק
- מלאו שם, בחרו את סוג API (תואם OpenAI או תואם Anthropic) ותנו
כתובת בסיס (למשל
http://localhost:11434/v1) - הוסיפו מפתח API אם נקודת הקצה זקוקה לאחד, ואז לחצו על הוספת ספק
ספק מותאם אישית מופיע באותה רשימה, עם כפתור מחיקה שלאחיו המובנים אין.
בחירת מודל לסוכן
קטע בשם “בחירת מודל לסוכן”- עברו אל הגדרות ← סביבת עבודה ← סוכנים ובחרו את הסוכן
- בלשונית הגדרות, בחרו את המתאם
- בחרו את המודל מהרשימה הנפתחת שלצדו
עבור המתאם המובנה הרשימה הנפתחת נבנית בזמן אמת מהקטלוג של כל ספק מחובר. ספק בלי פרטי גישה שמורים אינו תורם אף מודל, ולכן רשימה נפתחת ריקה כמעט תמיד משמעה “עדיין לא חובר דבר” ולא “אין דבר זמין”.
מזהי המודלים של המתאם המובנה הם בפורמט מוסמך provider/model ועשויים לשאת
שרשרת גיבוי מופרדת ב-|. בשרשרת גיבוי, העלות מחושבת לפי המודל ששירת את התור
בפועל, ולא לפי זה שביקשתם.
התקנת CLI של מריץ
קטע בשם “התקנת CLI של מריץ”המתאם המובנה אינו זקוק להתקנה. עבור Claude Code, התקינו את ה-CLI שלו במארח השרת עם מנהל החבילות של אותו כלי, למשל:
npm install -g @anthropic-ai/claude-codeלאחר מכן לחצו על רענן בראש העמוד. כל שורה שזוהתה מציגה את הגרסה והנתיב שנפתרו, וכן תגים המציינים אם היא תומכת במצב JSON ובבחירת מודל.
CLI חיצוני שומר על פרטי הגישה שלו, בתצורה משלו, במארח השרת. Control Center אינו מנהל אותם.
הגבלת הספקים שסביבת עבודה רשאית להשתמש בהם
קטע בשם “הגבלת הספקים שסביבת עבודה רשאית להשתמש בהם”השליטה בספקים היא לפי סביבת עבודה ונבחנת לפי העיקרון שההתאמה האחרונה מכריעה.
- בספקים ומודלים, כבו את מתג האפשר בשורת ספק
פעולה זו כותבת הצהרת deny עבור אותו ספק בסביבת העבודה הפעילה, והמודלים שלו
יוצאים מהקטלוג של אותה סביבת עבודה. החזרת המתג למצב פועל מסירה את ההצהרה.
פתרון בעיות
קטע בשם “פתרון בעיות”מריץ מוצג כלא נמצא
קטע בשם “מריץ מוצג כלא נמצא”- בדקו שה-CLI נמצא ב-
PATHשל מארח השרת, ולא רק בשלכם - אפליקציית שולחן עבודה המופעלת מהממשק הגרפי מפעילה את השרת שלה עם
PATHמינימלי; CLI שהותקן בנתיב הזמין למעטפת בלבד עלול להיות בלתי נראה עבורה - לחצו על רענן לאחר ההתקנה
הרשימה הנפתחת של המודלים ריקה
קטע בשם “הרשימה הנפתחת של המודלים ריקה”- המתאם הוא המובנה ואף ספק אינו מחובר — חברו אחד בספקים ומודלים
- או שהספק מחובר אך נדחה בידי מתג השליטה של סביבת העבודה הזו
מודל רץ אך המחיר מוצג כלא ידוע
קטע בשם “מודל רץ אך המחיר מוצג כלא ידוע”הרשימה החיה של המודלים נושאת את המזהה; המחיר וההקשר מגיעים מ-models.dev. למודל חדש לגמרי, או כזה של ספק מותאם אישית, אין עדיין רשומה בקטלוג.