Az Azure API Management használata Azure OpenAI-készségekkel és vektorizáló eszközökkel az Azure AI Keresésben

A Azure API Managementet a Microsoft Foundry Models szolgáltatásban elérhető Azure OpenAI és a Microsoft Foundry üzembe helyezései elé helyezheti, hogy központosítsa az útválasztást, a terheléselosztást, a szabályozást és a megfigyelhetőséget a Foundry-modelleket használó Azure AI Keresés-munkaterhelések számára. Ez a cikk ismerteti a támogatott forgatókönyveket, az ajánlott hitelesítést és a szerepköralapú hozzáférés-vezérlési (RBAC) mintát, valamint azt, hogy miként teheti a kapcsolatot Azure AI Keresés privátsá.

Támogatott forgatókönyvek

A Microsoft Foundry-modell üzembe helyezését az API Managementen keresztül hívhatja meg az alábbi Azure AI Keresés funkciókból:

• Azure OpenAI beágyazási készség
• Azure OpenAI-vektorizáló
• GenAI parancssori készség

Mindegyiknél állítsa a képesség vagy a vektorizáló végpontját az API Management-átjáró URL-címére, vagy a(z) https://<resource-name>.azure-api.netAPI Management egyéni tartományára.

Nem támogatott forgatókönyvek

Az API Management nem támogatott átjáróként a következőkhöz:

• A Azure content understanding skill által használt nagyméretű nyelvi modell (LLM).
• Az ágensi visszakeresésben használt tudásbázis által használt LLM.

Architecture

Két gyakori folyamat létezik. Mindkettő ugyanazt az API Management-konfigurációt használja a háttérrendszeren.

Nyilvános elérési út

Az Azure AI Keresés a nyilvános végpontján keresztül hívja az API Management-átjárót. Az API Management hitelesíti az Microsoft Foundry-erőforrást, és továbbítja a kérést.

Azure AI Search (skill or vectorizer)
   └─▶ API Management gateway (azure-api.net or custom domain)
          [API Management policies authenticate the caller]
          [API Management's managed identity authenticates to Foundry]
          └─▶ Azure OpenAI in Foundry Models / Microsoft Foundry resource

Privát elérési út a Azure AI Keresés és az API Management között

Ha a keresési szolgáltatásnak privátan kell elérnie az API Managementet, hozzon létre egy megosztott privát hivatkozást a keresési szolgáltatásból az API Management-példányra, és futtassa az indexelőket a privát végrehajtási környezetben.

Azure AI Search (private indexer execution)
   └─▶ Shared private link (Microsoft.ApiManagement/service, group "Gateway")
          └─▶ API Management private endpoint
                 └─▶ Microsoft Foundry resource (public or private endpoint)

Az API Management to Foundry a szabványos háttérrendszer-minta. A topológiára vonatkozó részletesebb útmutatásért – beleértve a több régióra kiterjedő, többpéldányos, valamint az aktív-aktív és az aktív-passzív konfigurációkat is – tekintse meg a Átjáró használata több Azure OpenAI-telepítés vagy -példány előtt és a A generatív AI-átjáró képességeinek áttekintése az Azure API Managementben című cikket.

Konfigurálja a végpontot a képességében vagy a vektorizáló eszközben

Állítsa be a képesség- vagy vektorizáló végpontot az API Management-átjáró URL-címére:

Hitelesítés és RBAC

Két identitás van benne. Különböző felelősségi körük és szerepkör-hozzárendelésük van.

Az ajánlott minta a credential termination and re-establishment: a hívó hitelesíti az API Managementet, az API Management pedig a saját felügyelt identitását használja a Microsoft Foundry-erőforráson való hitelesítéshez. További információ: Azure OpenAI-engedélyezés az AOAI-átjáró architektúrájának útmutatójában.

Hitelesítési lehetőségek az API Management-átjárón

Válassza az alábbi lehetőségek egyikét, hogy Azure AI Keresés hogyan hitelesítse magát az API Managementben. További információkért és házirend-példákért lásd: LLM API-k hitelesítése és hozzáférésének engedélyezése az API Management használatával.

• Subscription key: Az API Management az Microsoft Foundry erőforrás API-kulcsát egy nevű értékben tárolja, és egy szabályzat továbbítja azt a háttérkérelemen. Ez a legegyszerűbb konfigurálási lehetőség. A(z) set-header házirendet használja a(z) api-key fejléccel. Mivel a keresési szolgáltatás csak az API Management előfizetési kulcsát küldi el, nincs szükség Microsoft Entra ID szerepkörre a keresési szolgáltatás által felügyelt identitáson.

• A felügyelt identitás az átjárón OAuth-ellenőrzéssel: Az API Management a validate-azure-ad-token szabályzatot használja a keresési szolgáltatás által felügyelt identitás által bemutatott Microsoft Entra ID jogkivonat érvényesítéséhez. Használja ezt a lehetőséget a többrétegű védelemhez.

• (Az ajánlott mintához szükséges) API Management felügyelt identitás a háttérrendszerhez:Engedélyezzen egy rendszer által hozzárendelt vagy felhasználó által hozzárendelt felügyelt identitást az API Management-példányon, majd rendelje hozzá a Cognitive Services OpenAI User szerepkört a Microsoft Foundry-erőforráson. Lásd: Hitelesítés felügyelt identitással és Szerepköralapú hozzáférés-vezérlés az Azure OpenAI-hoz.

Privát kapcsolat a Azure AI Keresés és az API Management között

Hagyja ki ezt a szakaszt, ha Azure AI Keresés meghívja az API Managementet a nyilvános végponton keresztül.

A keresési szolgáltatásból egy privát csatornára irányuló kimenő forgalom korlátozása:

1. Hozzon létre egy megosztott privát hivatkozást a keresési szolgáltatásból az API Management-példányra. Használja a Microsoft.ApiManagement/service erőforrástípust és a Gateway csoportazonosítót. A lépésekért lásd: Kimenő kapcsolatok létrehozása megosztott privát kapcsolaton keresztül.

2. Hagyja jóvá a privát végpontkapcsolatot az API Management-példányon.

3. Konfigurálja azokat az indexelőket, amelyek a képességet vagy a vektorosítót használják a privát végrehajtási környezetben való futtatáshoz.

A megosztott privát hivatkozás beleszámít a keresési szolgáltatási szint megosztott privát hivatkozási korlátjához .

Privát kapcsolat az API Management és a Microsoft Foundry erőforrás között

Az API Management és a Microsoft Foundry-erőforrás privát csatornája független a keresési-API Management-kapcsolattól, és az API Management oldalán van konfigurálva. A beállításokat lásd:

• Virtuális hálózat használata az Azure API Managementtel
• Az Azure OpenAI hálózat konfigurálása

Kapcsolódó tartalom

• Azure OpenAI beágyazási készség
• Azure OpenAI-vektorizáló
• GenAI parancssori készség
• Kimenő kapcsolatok létrehozása megosztott privát kapcsolaton keresztül
• Átjáró használata több Azure OpenAI telepítés vagy példány előtt