Wskaż Trae Agent na jeden endpoint dla każdego modelu.
Updated 2026-07-30
trae_config.yaml w Trae Agent daje każdemu providerowi własny base_url i api_key. Ustaw base_url providera openai na https://api.apisrouter.com/v1, a agent, i jego streszczacz Lakeview, mogą działać na identyfikatorach Claude, GPT, DeepSeek, GLM albo Kimi przez jeden klucz.
Szybka odpowiedź: jeden blok providera, jeden blok modelu.
Obecna konfiguracja Trae Agent to YAML: trae_config.yaml w katalogu projektu, z trzema istotnymi blokami. model_providers definiuje endpointy, a każdy wpis przyjmuje api_key, provider i base_url, więc bramka kompatybilna z OpenAI to po prostu provider typu openai z podmienionym base_url. models definiuje nazwane konfiguracje modeli, które odwołują się do providera przez model_provider. agents wiąże trae_agent z jedną z tych nazw modeli. README upstream pokazuje dokładnie ten kształt do routingu przez usługę wielomodelową: wpis providera openai, którego base_url wskazuje na korzeń /v1 usługi. Dla APIsRouter to https://api.apisrouter.com/v1, a pole model przyjmuje wtedy dowolny identyfikator z katalogu jako zwykły string, łącznie z identyfikatorami Claude i Kimi, ponieważ typ providera decyduje tylko o formacie żądania, nie o dostawcy.
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.5Jak Trae Agent jest okablowany w środku.
Trae Agent (bytedance na GitHubie, około 12 tys. gwiazdek) to zorientowany na badania agent inżynierii oprogramowania ByteDance dla wiersza poleceń: daj trae-cli zadanie, a przepracuje je przez przezroczystą pętlę narzędzi, z bash, edycją plików i sequential thinking wśród wbudowanych narzędzi, aż do konfigurowalnego max_steps. Jest celowo modularny, dlatego konfiguracja oddziela providerów od modeli od agentów: ten sam provider może wspierać kilka konfiguracji modeli, a zamiana tego, na czym działa agent, to jednoliniowa edycja odwołania do nazwy. W praktyce liczą się dwa sloty modeli. trae_agent_model to główna pętla, model wykonujący rozumowanie, wywołania narzędzi i edycje, gdzie max_steps równe dwustu oznacza, że pojedyncze zadanie może być długim ciągiem rozliczanych wywołań. lakeview_model napędza Lakeview, funkcję Trae streszczającą kroki, która produkuje krótkie, czytelne podsumowania tego, co agent zrobił na każdym kroku. Lakeview strzela często, a jego output to proza do przelotnego spojrzenia, co czyni go podręcznikowym slotem dla szybkiego identyfikatora, podczas gdy główna pętla trzyma identyfikator z czołówki. Konfiguracja rozwiązuje się z czegoś więcej niż YAML: CLI przyjmuje flagi --provider i --model per uruchomienie, a zmienne środowiskowe specyficzne dla providera, OPENAI_API_KEY i OPENAI_BASE_URL wśród udokumentowanego zestawu, karmią te same ustawienia. Flagi to sposób, żeby zrobić A/B drugiego modelu bez dotykania pliku.
Pełna konfiguracja: agent, Lakeview i uruchomienie.
Pełna konfiguracja wiąże agenta z głównym modelem, a Lakeview z szybkim, oba przez ten sam wpis providera. Zauważ pośredniość: agents.trae_agent.model nazywa wpis w models, a każdy wpis models nazywa providera przez model_provider. Literówka w którymkolwiek odwołaniu zawodzi łańcuch, więc trzymaj trzy nazwy spójne. Jedna historyczna uwaga, która wyjaśnia większość zdezorientowanych tutoriali: konfiguracja Trae Agent kiedyś była trae_config.json, a repozytorium teraz dokumentuje ten format jako legacy, z YAML jako bieżącą formą. Przewodniki pokazujące JSON opisują starszy układ; klucze się przeniosły, koncepcje przetrwały. Jeśli masz starą konfigurację JSON, dokumentacja legacy-config repozytorium pokrywa mapowanie. Kąt jednego klucza warto wyłożyć konkretnie dla tego narzędzia. Natywna lista providerów Trae Agent obejmuje dostawców amerykańskich i chińskich, co normalnie oznacza konto i klucz per dostawca, z których niektóre trudno zdobyć zależnie od tego, gdzie siedzisz. Za jednym wpisem bramki, claude-sonnet-4-6, gpt-5.5, deepseek-v4-pro, glm-5.2 i kimi-k2.7-code są wszystkie o jeden string modelu, na jednym kluczu, z jednym saldem, z której strony Pacyfiku byś nie programował.
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.5Dobór modeli dla pętli agenta.
Flagi --provider i --model czynią workflow porównania konkretnym: uruchom to samo zadanie dwa razy z różnymi flagami, odczytaj kroki-do-końca i wycenione użycie per model w konsoli, i awansuj zwycięzcę do trae_config.yaml.
- Główna pętla to praca narzędziowa o długim horyzoncie: czytanie plików, edycja, uruchamianie bash, ocenianie, kiedy zadanie jest skończone. claude-sonnet-4-6 i gpt-5.5 trzymają razem dwustukrokowy plan; to ostatnie miejsce, żeby oszczędzać.
- Lakeview to streszczanie o wysokiej częstotliwości i niskiej stawce. claude-haiku-4-5-20251001 albo deepseek-v4-flash utrzymuje je efektywnie darmowym obok wydatku głównej pętli.
- kimi-k2.7-code i glm-5.2 to poważni kandydaci do głównej pętli na bazach kodu z chińskimi komentarzami, historią commitów albo dokumentacją; dwujęzyczne repozytorium to miejsce, gdzie biją modele nastawione na angielski w zrozumieniu, nie tylko w cenie.
- deepseek-v4-pro to wybór wolumenowy do uruchomień wsadowych, przemiatających tę samą poprawkę na wielu repozytoriach albo uruchamiających agenta w CI, gdzie koszt per zadanie się mnoży.
- max_steps to Twój regulator kosztu. Model, który błądzi, spala kroki; przy porównywaniu kandydatów porównuj kroki-do-końca na tym samym zadaniu, nie tokeny per żądanie.
Płatność za użycie · poniżej cen oficjalnych
Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.
| Model | Cena oficjalna | Nasza cena |
|---|---|---|
| Claude Sonnet 4.6 | $3.00 / $15.00 per M | $2.40 / $12.00 per M |
| GPT-5.5 | $5.00 / $30.00 per M | $4.00 / $24.00 per M |
| DeepSeek V4 Pro | $0.43 / $0.87 per M | $0.40 / $0.90 per M |
| GLM-5.2 | $1.14 / $4.00 per M | $1.10 / $4.00 per M |
| Kimi K2.7 Code | $0.95 / $4.00 per M | $1.00 / $4.00 per M |
Tryby awarii charakterystyczne dla Trae Agent.
Zamieszanie JSON-kontra-YAML prowadzi wszystko. trae_config.json skopiowany ze starszego przewodnika jest czytany w najlepszym razie jako legacy, a w najgorszym ignorowany, a objawem jest CLI zachowujące się tak, jakbyś nigdy niczego nie skonfigurował. Bieżące konfiguracje należą do trae_config.yaml; migruj stare pliki używając dokumentacji legacy-config repozytorium, zamiast zgadywać nazwy kluczy. Łańcuch trzech nazw łamie się cicho. agents.trae_agent.model musi nazywać wpis models, a model_provider tego wpisu musi nazywać wpis model_providers. Zmień nazwę jednego, a nie pozostałych, a uruchomienie zawiedzie przy starcie z błędem rozwiązywania, a nie błędem żądania, co wskazuje na YAML, nie na sieć. base_url chce mieć dołączone /v1, pasując do przykładu upstream, który wskazuje na korzeń /v1 routera. Goły host produkuje 404, gdy tylko klient dokleja ścieżkę chat-completions. Lakeview zawodzące, podczas gdy agent działa, oznacza, że lakeview_model odwołuje się do identyfikatora, którego endpoint nie serwuje, łatwo to przeoczyć, bo przetestowałeś główny model i zapomniałeś o drugim slocie. A zmienne środowiskowe po cichu wspierające providera, o którym myślałeś, że jest skonfigurowany plikiem, zwłaszcza OPENAI_API_KEY, warto sprawdzić, gdy uwierzytelnianie zachowuje się niespójnie między powłokami.
Kto kieruje Trae Agent przez bramkę.
- Deweloperzy, którzy chcą, żeby Claude albo GPT napędzały pętlę agenta, a GLM, Kimi albo DeepSeek były o jedną flagę dalej, bez trzymania konta u każdego dostawcy.
- Dwujęzyczne zespoły pracujące na bazach kodu chińskich i angielskich, dla których najsilniejszy model per repozytorium może pochodzić z któregokolwiek ekosystemu, adresowalny przez jeden klucz.
- Inżynierowie uruchamiający zadania agenta wsadowo albo w CI, gdzie śledzenie użycia per klucz zamienia flotę uruchomień trae-cli w czytelny raport kosztów.
- Badacze benchmarkujący modele agentów, ponieważ Trae Agent jest zbudowany pod porównania w stylu ablacji, a bramka czyni każdego kandydata tą samą zmianą jednej flagi.
- Deweloperzy bez dostępu do rozliczeń danego dostawcy. Dostęp oparty na doładowaniu, bez wymogu karty, usuwa zależność od rejestracji u każdego dostawcy z osobna.
Zweryfikuj endpoint i debuguj pierwsze zadanie.
Potwierdź, że endpoint serwuje Twoje identyfikatory przed pierwszym uruchomieniem: listing /v1/models Twoim kluczem jest autorytatywną pisownią dla każdego pola model w YAML, zarówno głównego slotu, jak i slotu Lakeview. Awarie pierwszego uruchomienia sortują się czysto. Błąd rozwiązywania konfiguracji, zanim padnie jakiekolwiek żądanie, to łańcuch trzech nazw albo plik JSON legacy. 401 to api_key w bloku providera, albo zmienna środowiskowa go nadpisująca. 404 na każdym żądaniu to base_url bez /v1. Błąd model-not-found nazywa slot, który jest zły, sprawdź, czy to był model agenta czy model Lakeview. A uruchomienie, które startuje, ale zawiesza się w środku zadania, to zwykle model błądzący, a nie endpoint zawodzący, do czego służą max_steps i log kroków. Gdy zadania już działają, konsola APIsRouter pokazuje model per żądanie, liczbę tokenów i wydatki. Agent, który robi sto kroków per zadanie, mnoży wszystko, a log użycia to miejsce, gdzie dowiadujesz się, ile faktycznie kosztuje zadanie na każdym kandydackim modelu.
curl -s https://api.apisrouter.com/v1/models \
-H "Authorization: Bearer $APISROUTER_API_KEY" | head -50Częste pytania
Gdzie w konfiguracji Trae Agent trafia niestandardowy base URL?
W trae_config.yaml pod model_providers: nadaj wpisowi api_key, provider: openai i base_url: https://api.apisrouter.com/v1. Konfiguracje modeli w bloku models odwołują się wtedy do tego wpisu po nazwie przez model_provider.
Czy trae_config.json jest wciąż wspierany?
Repozytorium dokumentuje JSON jako format legacy, a YAML jako bieżący, z dokumentem migracji dla starych plików. Przewodniki pokazujące trae_config.json opisują starszy układ; nowe konfiguracje powinny używać trae_config.yaml.
Czy Trae Agent może uruchamiać Claude, GLM, Kimi i DeepSeek przez jeden klucz?
Tak. Typ providera ustawia format żądania, a pole model jest przekazywane jako zwykły string, więc działa dowolny identyfikator serwowany przez endpoint: claude-sonnet-4-6, glm-5.2, kimi-k2.7-code i deepseek-v4-pro wszystkie przez ten sam blok providera i klucz.
Czym jest lakeview_model i czy potrzebuje własnego endpointu?
Lakeview streszcza każdy krok agenta w krótkie, czytelne aktualizacje, używając modelu nazwanego w lakeview_model. Rozwiązuje się przez ten sam mechanizm model_providers, więc wskaż go na szybki identyfikator z katalogu na tym samym wpisie bramki; strzela często i nie potrzebuje rozumowania z czołówki.
Czy flagi CLI nadpisują trae_config.yaml?
Tak. trae-cli przyjmuje --provider i --model per uruchomienie, co jest zamierzonym sposobem na przetestowanie innego modelu bez edytowania pliku. Zmienne środowiskowe providera, takie jak OPENAI_API_KEY i OPENAI_BASE_URL, są też czytane, więc sprawdź nieaktualne eksporty, gdy zachowanie różni się między powłokami.
Czy base_url powinien zawierać /v1?
Tak. Przykład upstream wskazuje providera openai na korzeń /v1 routera, a wartość APIsRouter to https://api.apisrouter.com/v1. Goły host dostaje 404, gdy tylko klient dokleja ścieżkę żądania.