Integracje28 wrz 2026
Po połączeniu Azure OpenAI z Xcellerate AIG ruch AI trafia do Twojego własnego zasobu Azure OpenAI: Twoja subskrypcja, Twój region, Twoje wdrożenia. Aplikacje nadal wywołują zgodne z OpenAI API AIG kluczem wirtualnym, a AIG przekształca każde zapytanie na format Azure. Ten poradnik jest dla administratorów, którzy konfigurują AIG dla MSP, małej firmy lub firmy usługowej.
W skrócie
- Potrzebujesz endpointu zasobu, klucza API i nazw swoich wdrożeń (deployments).
- Wywołujący wskazują wdrożenie jako
<nazwa-providera>/<nazwa-wdrożenia>.- Jeden provider może obsługiwać kilka zasobów Azure lub wersji API, po jednej na klucz.
Zanim zaczniesz
- Zasób Azure OpenAI z co najmniej jednym wdrożeniem modelu. Zapisz każdą nazwę wdrożenia dokładnie tak, jak nadałeś ją w portalu Azure.
- Endpoint zasobu, np.
https://<your-resource>.openai.azure.com, oraz jeden z jego kluczy API. Oba znajdziesz na stronie Keys and Endpoint zasobu. - Opcjonalnie wersja API. Jeśli zostawisz ją pustą, AIG użyje
2024-10-21. To dolna granica, a nie rekomendacja. - Rola Admin w AIG lub własna rola z uprawnieniem do tworzenia i edycji providerów.
- Wychodzący ruch HTTPS z AIG do Twojego endpointu. Adresy callback nie są potrzebne.
Konfiguracja Azure OpenAI
1. Utwórz providera
Przejdź do Connect → Providers (Połącz → Providerzy) i kliknij Connect a provider (połącz providera) lub Add provider (dodaj providera). Wybierz typ Azure OpenAI i nadaj nazwę, np. „Azure Europa Zachodnia”. Azure nie ma domyślnego Base URL (bazowy URL): endpoint ustawia się na kluczu. Base URL providera służy tylko jako rozwiązanie zapasowe.
2. Wklej klucz API
Wklej klucz Azure w pole API key (klucz API).
3. Wypełnij pola Azure
Te pola są wyświetlane pod nazwami technicznymi we wszystkich językach:
endpoint(wymagane): URL Twojego zasobu.api_version(opcjonalne): wersja API.deployment(opcjonalne): przypina ten klucz do jednego wdrożenia.
4. Przetestuj i włącz
Kliknij Test connection (testuj połączenie), a potem Enable provider (włącz providera).
5. Wywołaj wdrożenie
Wywołujący używają <nazwa-providera>/<nazwa-wdrożenia>. Na przykład azure_openai/prod-gpt4o trafia do wdrożenia prod-gpt4o. Część „model” w adresie to więc nazwa wdrożenia.
6. Ustaw swoje ceny
W Cost → Pricing (Koszty → Ceny) dodaj własną cenę. Prywatnej nazwy wdrożenia może nie być w publicznej karcie danych, a wynegocjowane ceny się różnią.
Co dzieje się po połączeniu
AIG wysyła każde zapytanie na <endpoint>/openai/deployments/<deployment>/<operation>?api-version=<version>, z Twoim kluczem w nagłówku api-key. Dostępne są czat, embeddings, obrazy, mowa i transkrypcja. Jeśli Twój zasób ma mniej wdrożeń, zawęź providera przez What this provider serves (co obsługuje ten provider); inne zapytania zostaną wtedy odrzucone już w AIG. Zarządzanie, logowanie, budżety i trasy zapasowe działają jak przy każdym innym providerze.
Dobrze wiedzieć
- Azure potrzebuje nazwy wdrożenia, a nie modelu. AIG przekazuje część „model” z adresu jako wdrożenie, chyba że ustawisz
deploymentna kluczu. - Dwie subskrypcje z różnymi wersjami API? Dodaj dwa klucze, każdy z własnym
endpointiapi_version. - AIG uwierzytelnia się w Azure OpenAI kluczem API.
- Twoje dane są przetwarzane w regionie Twojego zasobu Azure.
- Klucze są tylko do zapisu i nigdy nie wracają do przeglądarki.
- Bez licencji AIG działa w trybie darmowym: 5 kluczy wirtualnych, po 5 zapytań na klucz dziennie.
Rozwiązywanie problemów
Azure provider '<name>' has no endpoint configured on its key.Uzupełnijendpointna kluczu albo Base URL na providerze.<model> did not answer (<ms> ms): <message>podczas testu. Zwykle błędny jest endpoint, nazwa wdrożenia lub wersja API.No healthy API key is available for provider '…'Azure odrzucił klucz, a AIG oznaczył go jako Dead. Popraw klucz i kliknij Clear health flags (wyczyść znaczniki stanu).
Porozmawiaj z nami o AIG
Chcesz wiedzieć, jak AIG łączy Twoje środowisko Azure z innymi providerami? Porozmawiaj z nami o AIG. Więcej o wszystkich dostawcach w jednym katalogu i kluczach wirtualnych.