Routing i wybór modelu: relacja między kanałami, modelami i klientami

Podczas korzystania z bramki AI najłatwiej o pomylenie trzech pojęć: kanału, modelu i klienta. Zrozumienie relacji między nimi pomoże Ci poprawnie skonfigurować routing i uniknąć wątpliwości typu „dlaczego żądanie nie poszło przez kanał, którego oczekiwałem".

Trzy podstawowe pojęcia

• Kanał to pojedyncze połączenie nadrzędne (upstream): instancja Ollama albo konto u dostawcy chmury.
• Model to zdolność dostępna na danym kanale: np. konkretna nazwa modelu, taka jak qwen3:8b.
• Klient to narzędzie AI, z którego korzystasz na co dzień: Claude Code, Codex, opencode itd.

Ich wzajemna relacja tworzy jednokierunkowy łańcuch:

Klient → (klucz wirtualny) → bramka (strategia routingu) → kanał → model

Przy każdym żądaniu klient podaje w nim nazwę modelu, a bramka na jej podstawie znajduje kanał, który może je obsłużyć, i przekazuje żądanie dalej.

Co oznacza zapis „model (nazwa kanału)” na liście modeli

W selektorze modeli klientów takich jak Claude Code czy opencode zobaczysz wpisy typu qwen3:8b (Ollama Qwen3). Nazwa w nawiasie oznacza kanał źródłowy danego modelu, a nie „osobne połączenie”:

• Między Twoim klientem a bramką zawsze istnieje tylko jedno połączenie (jeden adres + jeden klucz wirtualny).
• Ten sam model może być skonfigurowany na wielu kanałach. W takim przypadku selektor nadal pokazuje tylko jeden wiersz (w nawiasie widnieje jeden z kanałów źródłowych), a o tym, który kanał faktycznie obsłuży dane żądanie, decyduje strategia routingu (patrz niżej).

Trzy tryby routingu: Fixed, Failover, Balanced

Strategia routingu odpowiada na pytanie: który kanał wykorzystać, gdy ten sam model może być obsługiwany przez wiele kanałów?

Tryb	Zachowanie	Odpowiednie scenariusze
Fixed (stały)	Zawsze używa tego samego kanału	Stabilna jakość kanału, gdy chcesz przypiąć źródło
Failover (główny–zapasowy)	Po awarii kanału głównego lub wyczerpaniu limitu kolejno przełącza się na kanały zapasowe	Konfiguracje z kanałem głównym i zapasowym
Balanced (zbalansowany)	Rozdziela żądania rotacyjnie między dostępne kanały	Rozłożenie obciążenia na wiele równorzędnych kanałów

Dwie kluczowe zasady:

1. Routing przełącza wyłącznie między kanałami, nigdy między modelami. O tym, którego modelu dotyczy żądanie, zawsze decyduje Twój klient — bramka nie zmieni modelu w Twoim imieniu.
2. Różne modele z natury korzystają z własnych kanałów. Balanced nie działa w ten sposób, że „raz użyje modelu z kanału A, a innym razem z kanału B” — rotacja odbywa się wyłącznie między kanałami tego samego modelu.

O modelu decyduje klient: jak zmienić model

Bramka zajmuje się tylko przekazywaniem żądań: Twoje narzędzie dołącza nazwę modelu do każdego żądania, a bramka kieruje je zgodnie z tą nazwą. Zmianę modelu wykonujesz w kliencie:

• opencode: wpisz /models w interfejsie TUI i wybierz model; możesz też skonfigurować model (model główny) oraz small_model (lekkie zadania, np. generowanie tytułów) w pliku opencode.json.
• Claude Code: przełączaj poleceniem /model.
• Codex: wskaż model parametrem -m <model> lub w pliku konfiguracyjnym.

Bezpieczna integracja codziennych narzędzi z bramką

Obawiasz się wpływu na codzienną pracę? Postępuj zgodnie z tym schematem:

1. Najpierw przetestuj na mniej ważnym projekcie: wykonaj integrację jednym kliknięciem w katalogu mało istotnego projektu i upewnij się, że przepływ pracy działa poprawnie.
2. Weryfikacja jednym żądaniem: wyślij żądanie testowe i sprawdź na stronie „Historia użycia”, na który model i który kanał trafiło oraz ile kosztowało.
3. W każdej chwili możesz się wycofać: zatrzymaj przejęcie na stronie „Zarządzanie integracjami”. Po zatrzymaniu: konfiguracja zapisana przez ServBay zostanie usunięta, a klucze wirtualne utworzone podczas przejęcia zostaną unieważnione; Twoje wcześniejsze własne konfiguracje nie zostaną automatycznie przywrócone — w razie potrzeby dostosuj je ręcznie; zmiany zadziałają po ponownym uruchomieniu klienta.

Podsumowanie

• Kanał = połączenie nadrzędne (upstream); model = zdolność dostępna na kanale; nazwę modelu w każdym żądaniu podaje klient.
• Strategia routingu wybiera wyłącznie spośród wielu kanałów tego samego modelu: Fixed — stały wybór, Failover — główny/zapasowy, Balanced — rotacja.
• Model zmieniasz w selektorze modeli klienta; przypisanie i koszt każdego żądania weryfikujesz na stronie „Historia użycia”.

Powiązane artykuły

• Wprowadzenie do bramki AI
• Zarządzanie kanałami
• Klucze wirtualne
• Przejęcie jednym kliknięciem