BlogInfrastruktura
Co robi brama LLM i kiedy firma jej potrzebuje
Brama LLM (LLM gateway) to jedna usługa między twoimi aplikacjami a dostawcami modeli: zapytania przechodzą przez nią, więc klucze, budżety, dostęp do modeli, routing, fallbacki i logi obsługujesz w jednym miejscu, a nie w każdej aplikacji osobno. Firma jej potrzebuje, gdy kilka zespołów lub narzędzi korzysta z modeli więcej niż jednego dostawcy albo gdy ktoś musi odpowiedzieć, kto ile wydał i który zespół może używać którego modelu. Przy jednej aplikacji i jednym dostawcy na razie zwykle wystarczą klucze i konsola dostawcy.
Jakie problemy rozwiązuje brama LLM
Brama rozwiązuje problemy z koordynacją. Pojawiają się, gdy z modeli korzysta coraz więcej zespołów, i żadna pojedyncza aplikacja nie rozwiąże ich sama. Oto pięć, o których słyszymy najczęściej, opisanych tak, jak mówią o nich ludzie:
- 'Każdy zespół ma własne klucze do dostawców i nikt nie wie, ile ich jest.' Brama przechowuje klucze dostawców i wydaje każdemu zespołowi, usłudze lub programiście własny klucz bramy, który można osobno ograniczyć i unieważnić. W LiteLLM na przykład każdy klucz wirtualny ma przypisane dozwolone modele, budżet i zespół, do którego należy.
- 'Dostajemy jedną fakturę i nie wiemy, który zespół za nią odpowiada.' Każde zapytanie trafia do logu z kluczem, zespołem, modelem i liczbą tokenów, więc wydatki da się zsumować dla każdego zespołu i przypadku użycia.
- 'Zmiana modelu oznacza zmiany w kodzie każdej aplikacji.' Aplikacje wywołują jeden endpoint z nazwą modelu, a brama przypisuje tę nazwę do wdrożenia u dostawcy. Zmiana sprowadza się do konfiguracji, choć prompty i odpowiedzi i tak trzeba przetestować na nowym modelu.
- 'Gdy dostawca ma awarię, nasze funkcje padają razem z nim.' Brama ponawia zapytania i przełącza się na inne wdrożenie lub innego dostawcę według reguł ustalonych z góry.
- 'Jakie dane mogą trafiać do którego modelu?' Brama może egzekwować odpowiedź, ale sama jej nie znajdzie. Kontroluje, które klucze i zespoły mogą wywoływać które modele, i zapisuje, co zostało wysłane. Sama z siebie nie wie, czy prompt zawiera dane klientów. Niektóre bramy oferują wykrywanie lub maskowanie danych osobowych jako opcjonalny guardrail, ale reguły klasyfikacji ustalają osoby odpowiedzialne za ochronę danych, a każda aplikacja nadal sama decyduje, co wkłada do promptu.
Jeśli żaden z tych problemów jeszcze nie doskwiera, brama to kolejna usługa do łatania, monitorowania i utrzymania w dostępności, więc może poczekać. To nasza ocena i zarazem najczęstszy dobry powód, by odłożyć wdrożenie.
Co robi brama, a co zostaje poza nią
Brama zarządza ruchem do modeli. Nie uruchamia modeli, nie decyduje, jakie dane może czytać aplikacja, i nie mówi ci, czy odpowiedzi są dobre. Tabela pokazuje typowy podział.
| Obszar | Robi brama | Potrzebne poza bramą |
|---|---|---|
| Klucze i budżety | Wydaje klucze dla zespołów, usług lub programistów i egzekwuje dostęp do modeli, limity zapytań i limity wydatków | Dostawca tożsamości dla użytkowników i menedżer sekretów dla poświadczeń dostawców |
| Routing i fallbacki | Przypisuje nazwę modelu do wdrożeń, rozkłada obciążenie, ponawia zapytania i przełącza się przy błędach | Ewaluacja pokazująca, że model zapasowy nadaje się do każdego zadania |
| Logowanie | Zapisuje dla każdego zapytania klucz, zespół, model, tokeny, koszt i opóźnienie, a po włączeniu także prompty i odpowiedzi | Decyzja o czasie przechowywania i miejsce do analizy logów, na przykład twój system monitoringu |
| Cache | Zwraca zapisane odpowiedzi na identyczne zapytania, a przy cache semantycznym także na podobne | Decyzja, które ścieżki w ogóle wolno cache'ować |
| Guardraile | Sprawdza prompty i odpowiedzi, na przykład pod kątem zakazanych tematów lub danych osobowych, jeśli produkt to oferuje | Polityka, którą te kontrole realizują, i testy pokazujące, że działają |
| Serwowanie modeli | Przekazuje zapytania do endpointu | Wdrożenia modeli na twoim koncie chmurowym albo własne serwowanie, na przykład vLLM na Kubernetes |
| Dostęp do danych | Nic: widzi tylko to, co wysyła aplikacja | Uprawnienia w systemie wyszukiwania i w narzędziach, które wywołują agenci |
| Ewaluacja | Dostarcza logi, z których mogą powstać zestawy testowe | Zestawy testowe, testy akceptacyjne i testy regresji przed każdą zmianą modelu lub promptu |
Ten podział ma znaczenie przy planowaniu pracy. Z naszego doświadczenia projekt opisany jako 'zainstalować bramę' zostawia bez właściciela ewaluację fallbacków, decyzję o przechowywaniu logów i politykę guardraili, a właśnie o nie pytają audytorzy i analizy incydentów.
Routing modeli LLM bez ukrytej utraty jakościFailover między dostawcami LLM bez zmiany jakości i dostępu
Główne bramy LLM według stanu na 7 listopada 2026
Większość firm wybiera między samodzielnie hostowaną bramą open source, funkcjami AI w produkcie do zarządzania API, którego już używa, a bramą hostowaną. Tabela obejmuje siedem popularnych opcji i podaje tylko fakty sprawdzone na stronach dostawców 7 listopada 2026. Właściciele, nazwy i funkcje zmieniały się na tym rynku w tym roku kilka razy, więc sprawdź je ponownie przed decyzją.
| Opcja | Jak działa | Licencja i właściciel | Warto wiedzieć |
|---|---|---|---|
| LiteLLM | Samodzielnie hostowane proxy, zwykle jako kontenery na twoim koncie chmurowym lub we własnym centrum danych | Open source na licencji MIT; licencja enterprise dodaje SSO dla więcej niż pięciu użytkowników, logi audytowe, budżety według tagów, guardraile dla kluczy i integracje z menedżerami sekretów | Klucze wirtualne z budżetami i listami modeli, wydatki według klucza i zespołu, fallbacki i cache są w wersji open source. W 2026 roku były trzy incydenty: złośliwe wydania 1.82.7 i 1.82.8 na PyPI 24 marca, aktywnie wykorzystywana podatność CVE-2026-42271 (naprawiona w 1.83.7) oraz 21 października złośliwe wydanie 1.107.0 z własnego potoku wydań LiteLLM, opublikowane na PyPI i jako obrazy Docker |
| Kong AI Gateway | Wtyczki AI do Kong Gateway: samodzielnie, z data plane w twoim środowisku podłączonymi do control plane Konnect, albo jako Dedicated Cloud Gateways hostowane przez Kong | Dokumentacja Kong wymienia Kong Gateway Enterprise jako warunek uruchomienia wtyczki AI Proxy Advanced on-premise | Wśród dostawców są OpenAI, Anthropic, Azure, Amazon Bedrock i Gemini; limity tokenów, cache semantyczny, prompt guardy i usuwanie danych osobowych to wtyczki. Obsługuje też ruch MCP i między agentami |
| Azure API Management | Polityki bramy AI w instancji API Management w twojej subskrypcji Azure | Część API Management, dostępność zależy od warstwy usługi. Microsoft oferuje też osobny produkt AI Gateway, według strony zaktualizowanej 28 października 2026 w publicznej wersji preview w regionach East US 2 i Sweden Central | Limity tokenów, metryki tokenów, cache semantyczny, rozkładanie obciążenia na backendy z circuit breakerem i kontrole bezpieczeństwa treści. Backendami mogą być Microsoft Foundry, Amazon Bedrock i własne endpointy |
| Cloudflare AI Gateway | Usługa hostowana przez Cloudflare | Dostępna we wszystkich planach Cloudflare | Analityka, logowanie, cache, limity zapytań, ponowienia i fallback modelu; limity wydatków, guardraile, ochrona przed wyciekiem danych, dynamiczne ścieżki i przechowywanie własnych kluczy dostawców są oznaczone jako beta |
| Portkey | Brama hostowana; bramę open source można też hostować samodzielnie | Brama open source na licencji MIT. Palo Alto Networks zamknęło przejęcie Portkey 29 maja 2026, a dokumentacja nazywa teraz produkt Prisma AIRS AI Gateway | Routing warunkowy, fallbacki, zwykły i semantyczny cache, budżety kosztów i tokenów, limity zapytań. Po zmianie właściciela zapytaj o plany rozwoju dla twojego przypadku użycia |
| OpenRouter | Hostowany router z własnym katalogiem modeli i rozliczeniami | Stripe ogłosił 19 sierpnia 2026 porozumienie o przejęciu OpenRoutera; OpenRouter zapowiada, że nazwa, produkt i plany rozwoju pozostaną bez zmian | Według Stripe ponad 400 modeli od ponad 80 dostawców. Routing w regionie UE przez osobny bazowy URL UE w planie Business; dane konta i rozliczeń mogą nadal być przetwarzane w USA |
| Agent Router (dawniej Envoy AI Gateway) | Hostowany samodzielnie, zbudowany na Envoy Proxy i Envoy Gateway | Apache 2.0. We wrześniu 2026 zmienił nazwę i przeszedł do Agentic AI Foundation | API zgodne z OpenAI dla modeli, brama MCP dla narzędzi, limity tokenów i failover. Istniejące wdrożenia Envoy AI Gateway nie wymagają migracji z powodu zmiany nazwy |
Wiele list typu 'najlepsza brama LLM' czy 'alternatywy dla LiteLLM' publikują dostawcy konkurencyjnych bram. Przydają się do zebrania nazw, mniej do wyboru. Dwie z siedmiu opcji powyżej zostały w 2026 przejęte lub mają zostać przejęte, a trzecia zmieniła nazwę. To praktyczny argument za tym, by aplikacje korzystały ze standardowego formatu API, tak aby samą bramę dało się wymienić.
Jak wybrać bramę LLM
Wybieraj według tego, gdzie brama musi działać i kto będzie ją utrzymywał, a potem sprawdź obsługiwanych dostawców, licencję i reguły dotyczące danych. Listy funkcji są na tyle podobne, że same rzadko rozstrzygają.
- Własny hosting czy usługa hostowana. Brama hostowana samodzielnie działa w twojej sieci lub na twoim koncie chmurowym, więc prompty i logi zostają tam, gdzie ją wdrożysz, ale to ty ją łatasz, skalujesz i monitorujesz. Brama hostowana zdejmuje z ciebie tę pracę, ale dochodzi kolejny podmiot przetwarzający twoje prompty, którego warunki muszą zaakceptować osoby odpowiedzialne za ochronę danych.
- Istniejące zarządzanie API. Jeśli już używasz Azure API Management lub Konga, najpierw sprawdź ich funkcje AI. Mogą pokryć klucze, limity i logowanie bez dokładania nowego komponentu, którego ktoś musiałby się nauczyć.
- Obsługiwani dostawcy i klienci. Spisz dostawców i formaty API, których potrzebujesz teraz i w przyszłym roku, łącznie z modelami wdrożonymi na twoim koncie Azure lub AWS i modelami hostowanymi samodzielnie. Agenci kodujący dokładają warunek: Claude Code działa z każdą bramą udostępniającą obsługiwany format API, a Anthropic zaznacza, że bramę trzeba aktualizować, gdy Claude Code dostaje nowe funkcje.
- Licencja. Oddziel funkcje, których potrzebujesz, od tych w wersji darmowej lub open source. W LiteLLM SSO dla więcej niż pięciu użytkowników, logi audytowe i budżety według tagów wymagają licencji enterprise, więc zdecyduj wcześnie, czy ją kupić, czy zbudować te elementy wokół bramy.
- Reguły UE dotyczące danych. Dla każdej opcji zapisz, gdzie przetwarzane i przechowywane są prompty, odpowiedzi i logi. W hostowanych routerach odpowiedź może zależeć od rodzaju danych: OpenRouter przetwarza w Europie prompty kierowane do UE, ale podaje, że dane konta, rozliczeń i inne dane operacyjne mogą być przetwarzane w USA. Przy modelach w chmurze region i typ wdrożenia u dostawcy modelu znaczą tyle samo co brama.
- Nakład na utrzymanie. Policz elementy poza samą bramą. Dokumentacja LiteLLM zaleca Redis przy każdym wdrożeniu z więcej niż jednym workerem lub repliką: bez niego limity liczone są osobno dla każdego workera, więc limit 100 zapytań na minutę przy czterech workerach przepuszcza 400, a unieważniony klucz nadal działa na workerach, które nie przetworzyły unieważnienia. Do tego dochodzi baza danych na klucze i logi wydatków, aktualizacje i dyżury dla komponentu, od którego zależy każda funkcja AI.
Co często widzimy, choć to nie reguła: zespoły ustandaryzowane na Azure API Management lub Kongu zaczynają od nich. Zespoły, które potrzebują modeli w chmurze na własnym koncie AWS lub Azure oraz modeli hostowanych samodzielnie i mają ludzi do utrzymania, zwykle kończą z samodzielnie hostowanym LiteLLM. Zespoły bez zasobów operacyjnych i z mniej restrykcyjnymi wymaganiami co do danych korzystają z bramy hostowanej.
Gdzie brama znajduje się w twojej platformie AI
Brama znajduje się w środku platformy: wszystko, co wywołuje model, przechodzi przez nią, i tylko ona zna poświadczenia dostawców. Droga od wywołującego do modelu wygląda tak:
- 1
Wywołujący
Aplikacje, agenci i agenci kodujący, na przykład Claude Code. Każdy uwierzytelnia się własnym kluczem bramy lub przez twojego dostawcę tożsamości, nigdy kluczem dostawcy modelu.
- 2
Brama
Sprawdza klucz, uprawnienie do modelu i budżet, stosuje guardraile, wybiera wdrożenie i zapisuje wpis w logu. Działa w twojej sieci albo u dostawcy, jeśli postawisz na bramę hostowaną.
- 3
Modele
Modele w chmurze wdrożone na twoim koncie Azure lub AWS, bezpośrednie API dostawców tam, gdzie są dozwolone, i modele hostowane samodzielnie przez vLLM na Kubernetes. Dostęp do nich ma tylko brama.
- 4
Logi i monitoring
Logi i metryki bramy trafiają do monitoringu, którego już używasz, gdzie raportujesz koszt na zespół, odsetek błędów i opóźnienia u każdego dostawcy oraz ustawiasz alerty.
To działa tylko wtedy, gdy ruch nie może ominąć bramy. Trzymaj klucze dostawców w menedżerze sekretów, który może czytać tylko brama, ogranicz ruch wychodzący do endpointów modeli i porównuj raporty użycia dostawców z logami bramy, żeby znaleźć bezpośrednie wywołania. Agentów kodujących też da się przypiąć: według stanu na 7 listopada 2026 Claude Code od wersji 2.1.285 odrzuca sesje kierowane gdzie indziej niż do twojej bramy, gdy w zarządzanych ustawieniach allowedProviders ma wartość customEndpoint.
Sekrety i poświadczenia agentów: przechowywanie i rotacjaAgenci kodujący za bramą LLM
Wdrażanie bramy krok po kroku
Wdrażaj bramę zespół po zespole i ścieżka po ścieżce, a budżety, logowanie i fallbacki przetestuj, zanim przejdzie przez nią pierwsze produkcyjne zapytanie.
- 1
Spisz obecne użycie
Wypisz każde konto u dostawcy, każdy klucz i każdy zespół, który dziś wywołuje modele, oraz ile każdy wydaje według faktur.
- 2
Ustal reguły
Zdecyduj, które zespoły mogą używać których modeli, jakie są budżety, które ścieżki wolno cache'ować i czy oraz jak długo logować prompty. Ostatni punkt zatwierdzają osoby odpowiedzialne za ochronę danych.
- 3
Wdróż i zabezpiecz
Uruchom bramę w swoim środowisku albo skonfiguruj usługę hostowaną, z kluczami dostawców w menedżerze sekretów, bez publicznego panelu administracyjnego, z przypiętymi wersjami i alertami na błędy i opóźnienia.
- 4
Testuj przed prawdziwym ruchem
Sprawdź, czy budżety zatrzymują zapytania, czy unieważnione klucze przestają działać na każdej replice, czy fallbacki uruchamiają się przy właściwych błędach i czy logi zawierają to, co ustaliliście. Przepuść zestaw ewaluacyjny także przez ścieżki zapasowe.
- 5
Zacznij od jednego zespołu
Przełącz jedną aplikację lub jeden zespół na endpoint bramy, porównaj wydatki z bramy z raportem dostawcy za ten sam okres i wyjaśnij różnice, zanim przeniesiesz kolejny zespół.
- 6
Zamknij obejścia
Gdy wszystkie zespoły korzystają z bramy, unieważnij stare klucze dostawców trzymane w aplikacjach i zablokuj bezpośredni dostęp sieciowy do dostawców.
- 7
Utrzymuj jak produkcję
Łataj według harmonogramu, co miesiąc przeglądaj wydatki zespołów i po każdej aktualizacji powtarzaj testy fallbacków i unieważniania kluczy.
Cloudsail wdraża LiteLLM i platformę wokół niego, łącznie z testami opisanymi wyżej, na koncie AWS lub Azure klienta albo na jego własnych serwerach, a jeśli nie chcesz zajmować się utrzymaniem we własnym zakresie, mogą to potem robić nasi inżynierowie w Niemczech i w Polsce.
Brama LiteLLM: wdrożenie i utrzymanieInżynieria platformy LLMAI na twoim koncie chmurowym
Pytania
Czy brama LLM to to samo co AI gateway albo proxy LLM?
W dużej mierze tak. 'Proxy LLM' i 'brama LLM' to określenia programistów na usługę przekazującą zapytania do modeli, a 'AI gateway' to szersze pojęcie produktowe, które często obejmuje też ruch MCP do narzędzi i wywołania między agentami. Na przykład Kong AI Gateway, Azure API Management i Agent Router obsługują ruch MCP w tym samym produkcie.
Czy potrzebujemy bramy, jeśli korzystamy z jednego dostawcy?
Niekoniecznie. Osobne workspace'y, projekty lub klucze dla każdego zespołu u dostawcy już dają oddzielne poświadczenia i podstawowy podział wydatków. Brama zaczyna się opłacać, gdy dochodzi drugi dostawca lub modele hostowane samodzielnie, gdy potrzebujesz budżetów egzekwowanych dla wszystkich zespołów, jednego logu audytowego dla wszystkich wywołań albo fallbacku na wypadek awarii tego jednego dostawcy.
Czy brama spowalnia zapytania?
Dodaje do każdego zapytania jeden przeskok sieciowy i trochę przetwarzania. Ile, zależy od produktu, od tego, gdzie go wdrożysz względem aplikacji i dostawców, oraz od funkcji takich jak guardraile sprawdzające każdy prompt. Przed wdrożeniem zmierz 95. percentyl opóźnienia z bramą i bez niej na własnym ruchu, zamiast polegać na benchmarkach dostawców.
Czy brama może zdecydować, jakie dane trafią do którego modelu?
Nie. Egzekwuje decyzje podjęte gdzie indziej: które klucze i zespoły mogą wywoływać które modele i co trafia do logów. Opcjonalne guardraile, takie jak maskowanie danych osobowych, wyłapią część z nich, ale rozpoznają tylko wzorce i nie znają twojej klasyfikacji danych. Żeby wrażliwy przypadek użycia korzystał tylko z zatwierdzonego modelu, daj tej aplikacji klucz, który ma dostęp wyłącznie do niego.
Czy LiteLLM to nadal rozsądny wybór po incydentach bezpieczeństwa z 2026 roku?
Może być, przy odpowiednim modelu utrzymania. W 2026 roku były trzy incydenty: złośliwe wydania 1.82.7 i 1.82.8 na PyPI 24 marca, aktywnie wykorzystywana podatność CVE-2026-42271 (naprawiona w 1.83.7) oraz 21 października złośliwe wydanie 1.107.0 z własnego potoku wydań LiteLLM, opublikowane na PyPI i jako obrazy Docker. Każdy, kto uruchamiał dotkniętą wersję, powinien wymienić poświadczenia na tych systemach. Dla decyzji liczy się to, jak go uruchamiasz: wersje przypięte przez digest i zweryfikowane, brak publicznych endpointów administracyjnych, poświadczenia w menedżerze sekretów i proces łatania z jasnym właścicielem.
Powiązane usługi
Brama LiteLLM
Budżety i zasady dostępu do AI dla każdego zespołu, przez bramę LiteLLM, która jest zabezpieczona, podłączona do dostawcy tożsamości i aktualna.
Platforma AI dla wszystkich zespołów
Jedna zatwierdzona droga do AI dla każdego zespołu, z budżetami, logami i swobodnym wyborem modelu, na twoich serwerach albo w twojej chmurze.
Azure OpenAI i Bedrock
GPT i Claude na danych firmy, w ramach umów chmurowych, które już masz: Azure OpenAI i Amazon Bedrock na twoim koncie, z przetwarzaniem w UE i jedną bramą.
Więcej z bloga
Alokacja kosztów LLM
Jak wyjaśnić rachunek za LLM według zespołu, zadania i zaakceptowanego wyniku: oznaczaj zapytania w bramce, wyceniaj je tak, jak wystawiana jest faktura, rozdzielaj koszty wspólne według jawnej reguły i co miesiąc uzgadniaj wynik z finansami.
Kontrola jakości routingu LLM
Jak kierować proste zapytania do tańszych modeli, nie ukrywając spadków jakości: testuj router jak klasyfikator, trzymaj fallbacki osobno i zapisuj, który model naprawdę odpowiedział.
Przełączanie dostawcy modelu
Jak przełączyć się na inny model podczas awarii, nie zmieniając po cichu jakości, uprawnień ani warunków przetwarzania danych: kontrakt zapasowy, wyzwalacze, testy równoważności i powrót.
Rada zakładowa a logi AI
Które pola w logach asystenta AI, bramy LLM i agentów kodujących umożliwiają kontrolę wydajności lub zachowania w świetle niemieckiego prawa o współdecydowaniu i jak ustawić logi, żeby porozumienia zakładowego dało się dotrzymać.
Źródła
- Dokumentacja LiteLLM: Enterprise
- Dokumentacja LiteLLM: Virtual Keys
- Dokumentacja LiteLLM: fallbacki, ponowienia i niezawodność
- Dokumentacja LiteLLM: Caching
- Dokumentacja LiteLLM: What Needs Redis
- LiteLLM: komunikat bezpieczeństwa o podejrzewanym ataku na łańcuch dostaw, marzec 2026
- Dokumentacja Kong: Kong AI Gateway
- Dokumentacja Kong: konfiguracja AI Proxy Advanced z OpenAI
- Microsoft Learn: funkcje bramy AI w Azure API Management
- Microsoft Learn: AI Gateway a usługa Azure API Management
- Dokumentacja Cloudflare AI Gateway: przegląd
- Dokumentacja Cloudflare AI Gateway: funkcje
- Palo Alto Networks: zakończenie przejęcia Portkey
- Dokumentacja Portkey: AI Gateway
- Repozytorium Portkey AI Gateway na GitHubie
- Stripe newsroom: Stripe porozumiewa się w sprawie przejęcia OpenRoutera
- Blog OpenRouter: OpenRouter is joining Stripe
- Dokumentacja OpenRouter: Sovereign AI i routing w regionie
- Agentic AI Foundation: Agent Router dołącza do AAIF
- Agentic AI Foundation: strona projektu Agent Router
- Dokumentacja Claude Code: Other LLM gateways
Porozmawiaj z inżynierem
Przyjdź z jednym zadaniem, które chcesz usprawnić. Rozmowa trwa 30 minut i nie wymaga dostępu do twoich systemów ani danych.
Rezerwacja odbywa się w Kalendarzu Google.
Wolisz najpierw napisać? Zostaw adres e-mail i kilka zdań, a odpowiemy, proponując terminy.
Sprawdź wersję roboczą w swoim programie pocztowym
Wyślij ją stamtąd, a inżynier odpowie ci osobiście, proponując terminy 30-minutowej rozmowy. Jeśli wersja robocza się nie otworzyła, napisz do nas na adres miki@cloudsail.com.