כוונו את Trae Agent אל endpoint אחד לכל מודל.

תשובה מהירה: בלוק ספק אחד, בלוק מודל אחד.

ההגדרה הנוכחית של Trae Agent היא YAML: trae_config.yaml בתיקיית הפרויקט, עם שלושה בלוקים רלוונטיים. model_providers מגדיר endpoints, וכל רשומה לוקחת api_key, provider, ו-base_url, כך ש-gateway תואם-OpenAI הוא פשוט רשומת ספק מסוג openai עם ה-base_url שלה מוחלף. models מגדיר הגדרות מודל בשם שמפנות אל ספק דרך model_provider. agents קושר את trae_agent לאחד משמות המודל האלה. ה-README ה-upstream מראה בדיוק את הצורה הזו עבור ניתוב דרך שירות רב-מודלים: רשומת ספק openai שה-base_url שלה מצביע על שורש ה-/v1 של השירות. עבור APIsRouter, זה https://api.apisrouter.com/v1, ואז שדה ה-model לוקח כל id מהקטלוג כמחרוזת פשוטה, כולל ids של Claude ו-Kimi, מכיוון שסוג הספק רק קובע את פורמט הבקשה, לא את הספק.

model_providers:
  apisrouter:
    api_key: your_apisrouter_api_key
    provider: openai
    base_url: https://api.apisrouter.com/v1

models:
  trae_agent_model:
    model_provider: apisrouter
    model: claude-sonnet-4-6
    max_tokens: 4096
    temperature: 0.5

איך Trae Agent מחווט מבפנים.

Trae Agent (bytedance ב-GitHub, כ-12K כוכבים) הוא ה-agent ההנדסי-תוכנתי הכוון-מחקר של ByteDance עבור שורת הפקודה: תנו ל-trae-cli משימה והוא עובד דרכה עם לולאת כלים שקופה, bash, עריכת קבצים, ונימוק רציף בין הכלים המובנים, עד max_steps ניתן-להגדרה. הוא מודולרי במכוון, וזו הסיבה שההגדרה מפרידה ספקים ממודלים מ-agents: אותו ספק יכול לתמוך בכמה הגדרות מודל, והחלפת מה ש-agent רץ עליו היא עריכת שורה אחת בהפניה לשם. שני סלוטי מודל חשובים בפועל. trae_agent_model הוא הלולאה הראשית, המודל שעושה את הנימוק, קריאות הכלים, והעריכות, שם max_steps של מאתיים אומר שמשימה בודדת יכולה להיות רצף ארוך של קריאות מחויבות. lakeview_model מפעיל את Lakeview, תכונת סיכום-הצעדים של Trae שמייצרת סיכומים קריאים וקצרים של מה שה-agent עשה בכל צעד. Lakeview יורה לעיתים קרובות והפלט שלו הוא פרוזה חטופה-במבט, מה שהופך אותו לסלוט ספר-הלימוד עבור id מהיר בעוד הלולאה הראשית שומרת על אחד מהחזית. ההגדרה נפתרת ממקום שהוא יותר מה-YAML: ה-CLI מקבל דגלי --provider ו---model לכל הרצה, ומשתני סביבה ספציפיים-לספק, OPENAI_API_KEY ו-OPENAI_BASE_URL מבין הסט המתועד, מזינים את אותן הגדרות. הדגלים הם איך שאתם עושים A/B למודל שני בלי לגעת בקובץ.

הגדרה מלאה: agent, Lakeview, והרצה.

ההגדרה המלאה קושרת את ה-agent למודל ראשי ואת Lakeview למהיר, שניהם דרך אותה רשומת ספק. שימו לב לעקיפה: agents.trae_agent.model נוקב בשם רשומה ב-models, וכל רשומת models נוקבת בשם ספק דרך model_provider. טעות הקלדה באחת מהן שוברת את השרשרת, אז שמרו את שלושת השמות עקביים. הערה היסטורית אחת שמסבירה את רוב המדריכים המבולבלים: ההגדרה של Trae Agent נהגה להיות trae_config.json, והמאגר עכשיו מתעד את הפורמט הזה כ-legacy כש-YAML הוא הצורה הנוכחית. מדריכים שמראים JSON מתארים פריסה ישנה יותר; המפתחות עברו מיגרציה, המושגים נשארו. אם יש לכם הגדרת JSON ישנה, מסמך ה-legacy-config של המאגר מכסה את המיפוי. הזווית של המפתח-האחד שווה פירוט עבור הכלי הזה במיוחד. רשימת הספקים הנטיביים של Trae Agent פרוסה על פני ספקים אמריקאים וסיניים, מה שבדרך כלל אומר חשבון ומפתח לכל ספק, וחלקם קשים להשגה תלוי איפה אתם יושבים. מאחורי רשומת gateway אחת, claude-sonnet-4-6, gpt-5.5, deepseek-v4-pro, glm-5.2, ו-kimi-k2.7-code כולם מרחק מחרוזת-מודל אחת, על מפתח אחד, עם יתרה אחת, לא משנה מאיזה צד של האוקיינוס השקט אתם מפתחים.

agents:
  trae_agent:
    enable_lakeview: true
    model: trae_agent_model
    max_steps: 200
    tools:
      - bash
      - str_replace_based_edit_tool
      - sequentialthinking
      - task_done

model_providers:
  apisrouter:
    api_key: your_apisrouter_api_key
    provider: openai
    base_url: https://api.apisrouter.com/v1

models:
  trae_agent_model:
    model_provider: apisrouter
    model: claude-sonnet-4-6
    max_tokens: 4096
    temperature: 0.5
  lakeview_model:
    model_provider: apisrouter
    model: claude-haiku-4-5-20251001
    max_tokens: 4096
    temperature: 0.5

בחירת מודלים ללולאת ה-agent.

הדגלים --provider ו---model הופכים את זרימת ההשוואה לקונקרטית: הריצו את אותה משימה פעמיים עם דגלים שונים, קראו צעדים-עד-סיום ואת השימוש המתומחר לכל מודל בקונסולה, וקדמו את המנצח לתוך trae_config.yaml.

• הלולאה הראשית היא עבודת כלים ארוכת-אופק: קריאת קבצים, עריכה, הרצת bash, שיפוט מתי המשימה הסתיימה. claude-sonnet-4-6 ו-gpt-5.5 מחזיקים ביחד תוכנית של מאתיים צעדים; זה הסלוט האחרון שבו כדאי לחסוך.
• Lakeview הוא סיכום בתדירות-גבוהה וסיכון-נמוך. claude-haiku-4-5-20251001 או deepseek-v4-flash שומר עליו זול-אפקטיבית לצד ההוצאה של הלולאה הראשית.
• kimi-k2.7-code ו-glm-5.2 הם מועמדים רציניים ללולאה הראשית על מאגרים עם הערות, היסטוריית commit, או תיעוד בסינית; מאגר דו-לשוני הוא המקום שבו הם מנצחים מודלים אנגלית-תחילה בהבנה, לא רק במחיר.
• deepseek-v4-pro הוא הבחירה בנפח להרצות אצווה, סריקת אותו תיקון על פני הרבה מאגרים או הרצת ה-agent ב-CI, שם עלות-לכל-משימה מוכפלת.
• max_steps הוא בקר העלות שלכם. מודל שנודד שורף צעדים; כשמשווים מועמדים, השוו צעדים-עד-סיום על אותה משימה, לא טוקנים לבקשה.

תשלום לפי שימוש · מתחת למחיר הרשמי

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

מצבי כשל ספציפיים ל-Trae Agent.

הבלבול JSON-מול-YAML מוביל את הכל. trae_config.json שהועתק ממדריך ישן יותר נקרא כ-legacy במקרה הטוב ומתעלם ממנו במקרה הגרוע, והתסמין הוא ש-CLI מתנהג כאילו אף פעם לא הגדרתם כלום. הגדרות נוכחיות שייכות ל-trae_config.yaml; העבירו קבצים ישנים באמצעות מסמך ה-legacy-config של המאגר במקום לנחש שמות מפתח. שרשרת שלושת השמות נשברת בשקט. agents.trae_agent.model חייב לנקוב בשם רשומת models, ו-model_provider של הרשומה הזו חייב לנקוב בשם רשומת model_providers. שינוי שם אחד ולא השאר גורם להרצה להיכשל בעת ההפעלה עם שגיאת פתרון, לא שגיאת בקשה, מה שמצביע עליכם אל ה-YAML, לא אל הרשת. base_url רוצה שה-/v1 יהיה כלול, בהתאמה לדוגמה ה-upstream שמצביעה על שורש /v1 של router. host גולמי מייצר 404 ברגע שה-client מוסיף את נתיב ה-chat-completions. כשל של Lakeview בעוד ה-agent עובד אומר ש-lakeview_model נוקב בשם id שה-endpoint לא משרת, קל לפספס מכיוון שבדקתם את המודל הראשי ושכחתם את הסלוט השני. ומשתני סביבה שתומכים בשקט בספק שחשבתם שמוגדר-קובץ, OPENAI_API_KEY במיוחד, שווים בדיקה כשאימות מתנהג באופן לא-עקבי בין shells.

מי מנתב את Trae Agent דרך gateway.

• מפתחים שרוצים ש-Claude או GPT ינהיגו את לולאת ה-agent ו-GLM, Kimi, או DeepSeek יהיו מרחק דגל אחד, בלי להחזיק חשבון אצל כל ספק.
• צוותים דו-לשוניים שעובדים על פני מאגרי קוד סיניים ואנגליים, שעבורם המודל החזק ביותר לכל מאגר עשוי להגיע מכל אחד מהאקוסיסטמים, ניתן לכתובת דרך מפתח אחד.
• מהנדסים שמריצים משימות agent באצווה או ב-CI, שם מעקב שימוש-לפי-מפתח הופך שיירת הרצות trae-cli לדוח עלות קריא.
• חוקרים שעורכים benchmark למודלי agent, מכיוון ש-Trae Agent בנוי להשוואה בסגנון ablation וה-gateway הופך כל מועמד לאותו שינוי דגל-אחד.
• מפתחים ללא גישה לחיוב של ספק נתון. גישה מבוססת-הטענה בלי דרישת כרטיס מסירה את התלות בהרשמה לכל ספק.

אמתו את ה-endpoint ובצעו דיבוג למשימה הראשונה.

אשרו שה-endpoint משרת את ה-ids שלכם לפני ההרצה הראשונה: רשימת ה-/v1/models עם המפתח שלכם היא האיות הסמכותי עבור כל שדה model ב-YAML, גם עבור הסלוט הראשי וגם עבור סלוט ה-Lakeview. כשלי הרצה ראשונה ממוינים בבירור. שגיאת פתרון-הגדרה לפני כל בקשה היא שרשרת שלושת השמות או קובץ JSON legacy. 401 הוא ה-api_key בבלוק הספק, או משתנה סביבה שדורס אותו. 404 על כל בקשה הוא base_url שחסר לו /v1. שגיאת model-not-found נוקבת בשם הסלוט השגוי, בדקו אם זה היה מודל ה-agent או מודל ה-Lakeview. והרצה שמתחילה אבל נתקעת באמצע-משימה היא בדרך כלל המודל שנודד ולא ה-endpoint שנכשל, וזו הסיבה ש-max_steps ולוג הצעדים קיימים. ברגע שמשימות רצות, קונסולת APIsRouter מציגה מודל לכל בקשה, ספירות טוקן, והוצאה. agent שלוקח מאה צעדים למשימה מכפיל הכל, ולוג השימוש הוא המקום שבו אתם לומדים כמה משימה באמת עולה על כל מודל מועמד.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

שאלות נפוצות