Megosztás a következőn keresztül:

Azure OpenAI API importálása

A KÖVETKEZŐRE VONATKOZIK: Minden API-kezelési szint

Az Azure OpenAI-ban az Öntödei modellekben üzembe helyezett AI-modellvégpontokat REST API-ként importálhatja az API Management-példányba. Az AI-átjáróházirendek és más képességek használata az API Managementben az integráció egyszerűsítése, a megfigyelhetőség javítása és a modellvégpontok feletti vezérlés javítása érdekében.

Ez a cikk két lehetőséget mutat be az Azure OpenAI API REST API-ként való importálására egy Azure API Management-példányba:

További információ az AI API-k kezeléséről az API Managementben:

Előfeltételek

1. lehetőség: API importálása az Azure OpenAI-ból

Az Azure OpenAI API-t közvetlenül az Azure OpenAI-ból importálhatja az API Managementbe.

Megjegyzés

Ez a funkció jelenleg nem érhető el a munkaterületeken.

Az API importálásakor az API Management automatikusan konfigurálja a következőket:

  • Az Azure OpenAI REST API-végpontok esetén végrehajtandó műveletek
  • Rendszer által hozzárendelt identitás az Azure OpenAI-erőforrás eléréséhez szükséges engedélyekkel.
  • Egy háttérerőforrás és egy set-backend-service szabályzat, amely az API-kéréseket az Azure OpenAI-végpontra irányítja.
  • Az Azure OpenAI-háttérrendszerhez való hitelesítés a példány rendszer által kijelölt felügyelt identitással.
  • (opcionálisan) Szabályzatok az Azure OpenAI API figyeléséhez és kezeléséhez.

Azure OpenAI API importálása az API Managementbe:

  1. Az Azure Portalon keresse meg az API Management-példányt.

  2. A bal oldali menü API-k alatt válassza az hozzáadása lehetőséget.

  3. Az Azure-erőforrás létrehozása területen válassza az Azure OpenAI lehetőséget.

    Képernyőkép egy API azure OpenAI-ból való létrehozásáról a portálon.

  4. Az Alapszintű beállítások lapon:

    1. Válassza ki az importálni kívánt Azure OpenAI-erőforrást.

    2. Igény szerint válasszon egy Azure OpenAI API-verziót. Ha nem választ egyet, a rendszer alapértelmezés szerint a legújabb éles üzemre kész REST API-verziót használja. Jegyezze fel a kiválasztott verziót. Az API teszteléséhez szüksége lesz rá.

    3. Adja meg az API megjelenítendő nevét és opcionális leírását .

    4. Az alap URL-címben fűzze hozzá az API Management-példány által az Azure OpenAI API-végpontokhoz való hozzáféréshez használt elérési utat. Ha engedélyezi az OpenAI SDK kompatibilitásának biztosítását (ajánlott), /openai a rendszer automatikusan hozzáfűzi az alap URL-címet.

      Például, ha az API Management átjáró végpontja https://contoso.azure-api.net, állítson be egy alap URL-t, ami hasonló a -hez.

    5. Igény szerint válasszon ki egy vagy több, az API-hoz társítandó terméket. Válassza a Tovább lehetőséget.

  5. A Szabályzatok lapon engedélyezheti a szabályzatok használatát az API figyeléséhez és kezeléséhez. A szabályzatokat később is beállíthatja vagy szerkesztheti.

    Ha be van jelölve, adja meg az alábbi szabályzatokat meghatározó beállításokat vagy alapértelmezett beállításokat (az előfeltételekről és a konfiguráció részleteiről lásd a csatolt cikkeket):

    Válassza a Felülvizsgálat és létrehozás lehetőséget.

  6. A beállítások érvényesítése után válassza a Létrehozás lehetőséget.

2. lehetőség: OpenAPI-specifikáció hozzáadása az API Managementhez

Másik lehetőségként töltse le manuálisan az Azure OpenAI REST API OpenAPI-specifikációját, és adja hozzá az API Managementhez OpenAPI API-ként.

Az OpenAPI specifikációjának letöltése

Töltse le az Azure OpenAI REST API OpenAPI-specifikációját, például a 2024-10-21 GA-verziót.

  1. Egy szövegszerkesztőben nyissa meg a letöltött specifikációs fájlt.

  2. servers A specifikáció elemében cserélje le a helyőrzők értékei között az Azure OpenAI-végpont nevét az url és default végpontokban. Ha például az Azure OpenAI-végpontja contoso.openai.azure.com, akkor frissítse a servers elemet a következő értékekkel:

    • URL-cím: https://contoso.openai.azure.com/openai
    • alapértelmezett végpont: contoso.openai.azure.com
    [...]
"servers": [
    {
      "url": "https://contoso.openai.azure.com/openai",
      "variables": {
        "endpoint": {
          "default": "contoso.openai.azure.com"
        }
      }
    }
  ],
[...]

  3. Jegyezze fel az API version értékét a specifikációban. Az API teszteléséhez szüksége lesz rá. Példa: 2024-10-21.

OpenAPI-specifikáció hozzáadása az API Managementhez

  1. Az Azure Portalon keresse meg az API Management-példányt.
  2. A bal oldali menüben válassza az API-k>+ API hozzáadása lehetőséget.
  3. Az Új API definiálása területen válassza az OpenAPI lehetőséget. Adja meg az API megjelenítendő nevét és nevét .
  4. Adjon meg egy olyan API URL-utótagot, amely az /openai-re végződik, hogy elérje az Azure OpenAI API-végpontokat az API-kezelési példányában. Példa: my-openai-api/openai.
  5. Válassza a Létrehozás lehetőséget.

Az API importálva van, és az OpenAPI-specifikációból jeleníti meg a műveleteket.

Hitelesítés konfigurálása az Azure OpenAI API-ra

Az Azure OpenAI API hitelesítéséhez meg kell adnia egy API-kulcsot vagy egy felügyelt identitást. Ha az Azure OpenAI API-t közvetlenül az API Management-példányba importálta, a rendszer automatikusan konfigurálja az API Management-példány felügyelt identitását használó hitelesítést.

Ha az Azure OpenAI API-t az OpenAPI-specifikációból adta hozzá, konfigurálnia kell a hitelesítést. A hitelesítés API Management-szabályzatok használatával történő konfigurálásáról további információt az Azure OpenAI API hitelesítése és engedélyezése című témakörben talál.

Az Azure OpenAI API tesztelése

Annak érdekében, hogy az Azure OpenAI API a várt módon működjön, tesztelje azt az API Management tesztkonzolon. Az API teszteléséhez meg kell adnia az Azure OpenAI-erőforrásban konfigurált modelltelepítési azonosítót (nevet) és az API-verziót.

  1. Válassza ki az előző lépésben létrehozott API-t.

  2. Kattintson a Teszt fülre.

  3. Válasszon ki egy olyan műveletet, amely kompatibilis az Azure OpenAI-erőforrásban üzembe helyezett modellel. A lapon a paraméterek és fejlécek mezői láthatók.

  4. A sablonparaméterekben adja meg a következő értékeket:

    • deployment-id - egy üzembe helyezés azonosítója az Azure OpenAI-ban
    • api-version - érvényes Azure OpenAI API-verzió, például az API importálásakor kiválasztott API-verzió. Képernyőkép az Azure OpenAI API portálon való teszteléséről.

  5. Szükség szerint adjon meg más paramétereket és fejléceket. A művelettől függően előfordulhat, hogy konfigurálnia vagy frissítenie kell egy kérelem törzsét.

    Megjegyzés

    A tesztkonzolon az API Management automatikusan feltölt egy Ocp-Apim-Subscription-Key fejlécet, és konfigurálja a beépített teljes hozzáférésű előfizetés előfizetési kulcsát. Ez a kulcs lehetővé teszi az API Management-példány összes API-jának elérését. Az Ocp-Apim-Subscription-Key fejlécet igény szerint a HTTP-kérés melletti "szem" ikonra kattintva jelenítheti meg.

  6. Válassza az Küldés lehetőséget.

    Ha a teszt sikeres, a háttérrendszer egy sikeres HTTP-válaszkóddal és néhány adattal válaszol. A válaszhoz csatolva találhatók a tokenhasználati adatok, amelyek segítenek az Azure OpenAI API-tokenhasználat monitorozásában és kezelésében.

    Képernyőkép a tokenhasználati adatokról az API-válaszban a portálon.

Kapcsolódó tartalom