Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A KÖVETKEZŐRE VONATKOZIK: Minden API Management-szint
A azure-openai-semantic-cache-store szabályzat gyorsítótárazza az Azure OpenAI Chat Completion API-kérésekre adott válaszokat egy konfigurált külső gyorsítótárba. A válasz gyorsítótárazása csökkenti a háttérbeli Azure OpenAI API-ra vonatkozó sávszélességet és feldolgozási követelményeket, és csökkenti az API-felhasználók által érzékelt késést.
Feljegyzés
- Ennek a szabályzatnak rendelkeznie kell egy megfelelő Get cached responses to Azure OpenAI API requests policy-val.
- A szemantikai gyorsítótárazás engedélyezésének előfeltételeit és lépéseit az Azure OpenAI API-k szemantikai gyorsítótárazásának engedélyezése az Azure API Managementben című témakörben találja.
Feljegyzés
Állítsa be a szabályzat elemeit és gyermekelemeit a szabályzatutasításban megadott sorrendben. További információ az API Management-szabályzatok beállításáról és szerkesztéséről.
Támogatott Azure OpenAI az Azure AI Foundry-modellekben
A szabályzatot az API Managementhez hozzáadott API-k használják az Azure OpenAI-ból az AI Foundry-modellekben az alábbi típusok esetében:
| API-típus | Támogatott modellek |
|---|---|
| Csevegés befejezése | gpt-3.5gpt-4gpt-4ogpt-4o-minio1o3 |
| Beágyazások | text-embedding-3-largetext-embedding-3-smalltext-embedding-ada-002 |
| Válaszok (előzetes verzió) |
gpt-4o(Verziók: 2024-11-20, 2024-08-06) 2024-05-13gpt-4o-mini (Verzió: 2024-07-18)gpt-4.1 (Verzió: 2025-04-14)gpt-4.1-nano (Verzió: 2025-04-14)gpt-4.1-mini (Verzió: 2025-04-14)gpt-image-1 (Verzió: 2025-04-15)o3 (Verzió: 2025-04-16)o4-mini (Verzió: '2025-04-16) |
Feljegyzés
A hagyományos befejező API-k csak régi modellverziókkal érhetők el, és a támogatás korlátozott.
A modellekről és képességeikről az Azure OpenAI in Foundry Models című témakörben tájékozódhat.
Szabályzatutasítás
<azure-openai-semantic-cache-store duration="seconds"/>
Attribútumok
| Attribútum | Leírás | Kötelező | Alapértelmezett |
|---|---|---|---|
| időtartam | A gyorsítótárazott bejegyzések élettartamának beállítása másodpercben megadva. A szabályzatkifejezések engedélyezettek. | Igen | n/a |
Használat
- Szabályzatszakaszok: kimenő
- Szabályzat hatókörei: globális, termék, API, művelet
- Átjárók: klasszikus, v2, használat, saját üzemeltetésű
Használati megjegyzések
- Ez a szabályzat csak egyszer használható egy szabályzatszakaszban.
- Ha a gyorsítótár-keresés sikertelen, a gyorsítótárral kapcsolatos műveletet használó API-hívás nem okoz hibát, és a gyorsítótár-művelet sikeresen befejeződik.
- Javasoljuk, hogy a gyorsítótár-keresés után azonnal konfiguráljon egy sebességkorlátozó szabályzatot (vagy kulcsonkénti sebességkorlátozási szabályzatot). Ez segít abban, hogy a háttérszolgáltatás túlterhelt legyen, ha a gyorsítótár nem érhető el.
Példák
Példa az azure-openai-szemantic-cache-lookup szabályzatra
Az alábbi példa bemutatja, hogyan használható a szabályzat és a azure-openai-semantic-cache-lookup szabályzat a azure-openai-semantic-cache-store szemantikailag hasonló gyorsítótárazott válaszok lekérésére 0,05-ös hasonlósági pontszám küszöbértékkel. A gyorsítótárazott értékeket a hívó előfizetés-azonosítója particionálta.
Feljegyzés
Adjon hozzá egy sebességkorlát-szabályzatot (vagy kulcsonkénti sebességkorlátozási szabályzatot) a gyorsítótár-keresés után, hogy korlátozza a hívások számát, és megakadályozza a háttérszolgáltatás túlterhelését abban az esetben, ha a gyorsítótár nem érhető el.
<policies>
<inbound>
<base />
<azure-openai-semantic-cache-lookup
score-threshold="0.05"
embeddings-backend-id ="azure-openai-backend"
embeddings-backend-auth ="system-assigned" >
<vary-by>@(context.Subscription.Id)</vary-by>
</azure-openai-semantic-cache-lookup>
<rate-limit calls="10" renewal-period="60" />
</inbound>
<outbound>
<azure-openai-semantic-cache-store duration="60" />
<base />
</outbound>
</policies>
Kapcsolódó szabályzatok
Kapcsolódó tartalom
A szabályzatok használatával kapcsolatos további információkért lásd:
- Oktatóanyag: AZ API átalakítása és védelme
- Szabályzathivatkozás a szabályzatutasságok és azok beállításainak teljes listájához
- Házirend-kifejezések
- Házirendek beállítása vagy szerkesztése
- Szabályzatkonfigurációk újrafelhasználása
- Szabályzatrészletek adattára
- Házirend-játszótér adattára
- Azure API Management policy toolkit
- A Copilot segítségével szabályzatokat hozhat létre, magyarázhat el és háríthat el hibákat.