وجّه Trae Agent إلى نقطة نهاية واحدة لكل نموذج.

إجابة سريعة: كتلة مزوّد واحدة، كتلة نموذج واحدة.

إعداد Trae Agent الحالي هو YAML: trae_config.yaml في مجلد المشروع، بثلاث كتل ذات صلة. model_providers يُعرِّف نقاط النهاية، ويأخذ كل مُدخَل api_key وprovider وbase_url، لذا بوابة متوافقة مع OpenAI هي مجرد مزوّد من نوع openai بـ base_url مُبدَّل. models يُعرِّف إعدادات نموذج مُسمَّاة تُشير إلى مزوّد عبر model_provider. agents يربط trae_agent بأحد أسماء تلك النماذج. يُظهِر README الأصلي بالضبط هذا الشكل للتوجيه عبر خدمة متعددة النماذج: مُدخَل مزوّد openai يُشير base_url الخاص به إلى جذر /v1 للخدمة. لـ APIsRouter، هذا هو https://api.apisrouter.com/v1، ويأخذ حقل model حينها أي معرّف كتالوج كسلسلة عادية، بما في ذلك معرّفات 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، بنحو 12 ألف نجمة) هو وكيل هندسة برمجيات موجَّه للبحث من ByteDance لسطر الأوامر: أعطِ trae-cli مهمة ويعمل عليها بحلقة أدوات شفافة، bash وتحرير الملفات والتفكير التسلسلي من بين الأدوات المدمجة، حتى max_steps قابل للإعداد. هو مُصمَّم عمداً بشكل معياري، ولهذا يفصل الإعداد المزوّدين عن النماذج عن الوكلاء: يمكن لنفس المزوّد دعم عدة إعدادات نموذج، وتبديل ما يعمل عليه الوكيل هو تعديل سطر واحد لمرجع اسم. فتحتا نموذج تهمّان عملياً. trae_agent_model هي الحلقة الرئيسية، النموذج الذي يقوم بالاستدلال واستدعاءات الأدوات والتعديلات، حيث max_steps البالغ مئتين يعني أن مهمة واحدة يمكن أن تكون تسلسلاً طويلاً من الاستدعاءات المُفوترة. lakeview_model يُشغِّل Lakeview، ميزة تلخيص الخطوات الخاصة بـ Trae التي تُنتِج ملخصات قصيرة مقروءة لما فعله الوكيل في كل خطوة. Lakeview يُطلَق كثيراً ومُخرَجه نثر سريع القراءة، ما يجعله الفتحة النموذجية لمعرّف سريع بينما تحتفظ الحلقة الرئيسية بمعرّف طليعي. يُحلَّل الإعداد من أكثر من YAML: يقبل CLI علمَي --provider وmodel-- لكل تشغيل، ومتغيّرات بيئة خاصة بالمزوّد، OPENAI_API_KEY وOPENAI_BASE_URL من بين المجموعة الموثَّقة، تُغذِّي نفس الإعدادات. الأعلام هي كيفية اختبار A/B لنموذج ثانٍ دون لمس الملف.

الإعداد الكامل: الوكيل، وLakeview، وتشغيل.

الإعداد الكامل يربط الوكيل بنموذج رئيسي وLakeview بنموذج سريع، كلاهما عبر نفس مُدخَل المزوّد. لاحظ التسلسل غير المباشر: agents.trae_agent.model يُسمّي مُدخَلاً في models، وكل مُدخَل في models يُسمّي مزوّداً عبر model_provider. خطأ إملائي في أي منهما يُفشِل السلسلة، لذا أبقِ الأسماء الثلاثة متسقة. ملاحظة تاريخية واحدة تُفسِّر معظم الدروس المُربِكة: إعداد Trae Agent كان يُسمّى trae_config.json، والمستودع الآن يوثّق ذلك الصيغة كموروثة مع YAML كالحالية. الأدلة التي تُظهِر JSON تصف التخطيط الأقدم؛ المفاتيح انتقلت، والمفاهيم انتقلت معها. إذا كان لديك إعداد JSON قديم، يُغطِّي مستند الإعداد الموروث الخاص بالمستودع التخطيط. الزاوية أحادية المفتاح تستحق التوضيح لهذه الأداة تحديداً. قائمة مزوّدي Trae Agent الأصليين تمتد عبر بائعين أمريكيين وصينيين، ما يعني عادة حساباً ومفتاحاً لكل بائع، بعضها صعب الحصول عليه اعتماداً على مكانك. خلف مُدخَل بوابة واحد، 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

اختيار نماذج لحلقة الوكيل.

علما --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 مرشّحان جادّان للحلقة الرئيسية على قواعد كود بتعليقات أو سجل التزام أو مستندات صينية؛ مستودع ثنائي اللغة هو حيث يتفوقان على النماذج الأولية بالإنجليزية في الفهم، لا السعر فقط.
• deepseek-v4-pro هو الاختيار الحجمي للتشغيلات الدفعية، بمسح نفس الإصلاح عبر مستودعات كثيرة أو تشغيل الوكيل في CI، حيث تتضاعف التكلفة لكل مهمة.
• max_steps هو مُنظِّم تكلفتك. نموذج يتيه يستهلك خطوات؛ عند مقارنة المرشحين، قارن عدد الخطوات حتى الإنجاز على نفس المهمة، لا tokens لكل طلب.

ادفع حسب الاستخدام · أقل من السعر الرسمي

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 مُنسوخ من دليل أقدم يُقرَأ كموروث في أفضل الأحوال ويُتجاهَل في أسوأها، والعَرَض هو أن CLI يتصرف وكأنك لم تُعِدّ شيئاً على الإطلاق. الإعدادات الحالية تنتمي إلى trae_config.yaml؛ رحّل الملفات القديمة باستخدام مستند الإعداد الموروث الخاص بالمستودع بدلاً من تخمين أسماء المفاتيح. سلسلة الأسماء الثلاثة تنكسر بصمت. agents.trae_agent.model يجب أن يُسمّي مُدخَلاً في models، ويجب أن يُسمّي model_provider الخاص بذلك المُدخَل مُدخَلاً في model_providers. إعادة تسمية واحد دون الآخرَين تُفشِل التشغيل عند البدء بخطأ حل بدلاً من خطأ طلب، ما يُوجِّهك إلى YAML، لا الشبكة. base_url يريد /v1 مُضمَّناً، مطابقاً لمثال المستودع الذي يُشير إلى جذر /v1 لمُوجِّه. مضيف عارٍ يُنتِج 404 بمجرد أن يُلحِق العميل مسار chat-completions. فشل Lakeview بينما يعمل الوكيل يعني أن lakeview_model يُشير إلى معرّف لا تخدمه نقطة النهاية، سهل الفوات لأنك اختبرت النموذج الرئيسي ونسيت الفتحة الثانية. ومتغيّرات البيئة التي تدعم بصمت مزوّداً كنت تظن أنه مُهيَّأ بملف، خصوصاً OPENAI_API_KEY، تستحق التحقق عندما تتصرف المصادقة بشكل غير متسق بين shells.

من يوجّه Trae Agent عبر بوابة.

• المطورون الذين يريدون Claude أو GPT يُحرِّكان حلقة الوكيل وGLM أو Kimi أو DeepSeek على بُعد علم واحد، دون حساب لدى كل بائع.
• الفرق ثنائية اللغة التي تعمل عبر قواعد كود صينية وإنجليزية، حيث قد يأتي أقوى نموذج لكل مستودع من أي من النظامين، قابل للعنونة عبر مفتاح واحد.
• المهندسون الذين يُشغِّلون مهام وكيل دفعية أو في CI، حيث تتبع الاستخدام لكل مفتاح يُحوِّل أسطولاً من تشغيلات trae-cli إلى تقرير تكلفة مقروء.
• الباحثون الذين يُقيِّمون نماذج الوكيل معيارياً، بما أن Trae Agent مبني لمقارنة على طراز الاستئصال والبوابة تجعل كل مرشّح نفس التغيير بعلم واحد.
• المطورون الذين لا يملكون وصولاً إلى فوترة بائع معيّن. الوصول القائم على تعبئة الرصيد بدون شرط بطاقة يزيل الاعتماد على التسجيل لكل مزوّد.

تحقق من نقطة النهاية وصحّح أخطاء أول مهمة.

تأكّد من أن نقطة النهاية تخدم معرّفاتك قبل أول تشغيل: سرد /v1/models بمفتاحك هو الإملاء الموثوق لكل حقل model في YAML، الفتحة الرئيسية وفتحة Lakeview معاً. أخطاء أول تشغيل تُصنَّف بوضوح. خطأ حل إعداد قبل أي طلب يعني سلسلة الأسماء الثلاثة أو ملف JSON موروث. 401 يعني api_key في كتلة المزوّد، أو متغيّر بيئة يتجاوزه. 404 على كل طلب يعني base_url يفتقد /v1. خطأ model-not-found يُسمّي الفتحة الخاطئة، تحقّق مما إذا كان نموذج الوكيل أو نموذج Lakeview. وتشغيل يبدأ لكن يتوقف منتصف المهمة عادة النموذج يتيه لا نقطة النهاية تفشل، وهذا ما يُوجَد من أجله max_steps وسجل الخطوات. بمجرد تشغيل المهام، تعرض لوحة APIsRouter النموذج لكل طلب، وعدد tokens، والإنفاق. وكيل يستغرق مئة خطوة لكل مهمة يُضاعِف كل شيء، وسجل الاستخدام هو حيث تتعلم ما تكلّفه مهمة فعلياً على كل نموذج مرشّح.

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

الأسئلة الشائعة