Rövid útmutató: Védett anyag észlelése (előzetes verzió)
A védett anyag szövege ismert szövegtartalommal (például dalszövegekkel, cikkekkel, receptekkel, kijelölt webes tartalommal) egyező nyelvet ír le. Ezzel a funkcióval azonosíthatja és letilthatja az ismert szöveges tartalmak megjelenítését a nyelvi modell kimenetében (csak angol tartalom esetén).
Előfeltételek
- Azure-előfizetés – Ingyenes létrehozás
- Miután megkapta az Azure-előfizetését, hozzon létre egy Content Széf ty erőforrást az Azure Portalon a kulcs és a végpont lekéréséhez. Adja meg az erőforrás egyedi nevét, válassza ki az előfizetését, és válasszon ki egy erőforráscsoportot, egy támogatott régiót (lásd a régió elérhetőségét) és a támogatott tarifacsomagot. Válassza a Létrehozás parancsot.
- Az erőforrás üzembe helyezése néhány percet vesz igénybe. A befejezés után válassza az Ugrás az erőforráshoz lehetőséget. A bal oldali panel Erőforrás-kezelés területén válassza az Előfizetési kulcsot és a Végpontot. A végpont és a kulcsok bármelyike az API-k meghívására szolgál.
- telepített cURL
Szöveg elemzése védett anyagészleléshez
A következő szakasz végigvezet egy mintakérésen a cURL használatával. Illessze be az alábbi parancsot egy szövegszerkesztőbe, és végezze el a következő módosításokat.
- Cserélje le
<endpoint>az erőforráshoz társított végponti URL-címre. - Cserélje le
<your_subscription_key>az erőforráshoz tartozó egyik kulcsra. - Szükség esetén cserélje le a
"text"törzs mezőjét az elemezni kívánt saját szövegre.Tipp.
Szövegméret és részletesség
A szöveges beküldések alapértelmezett maximális hossza 1K karakter. A minimális hossz 111 karakter. A védett anyagészlelést LLM-kiegészítéseken kell futtatni, nem pedig felhasználói kéréseken.
curl --location --request POST '<endpoint>/contentsafety/text:detectProtectedMaterial?api-version=2023-10-15-preview' \
--header 'Ocp-Apim-Subscription-Key: <your_subscription_key>' \
--header 'Content-Type: application/json' \
--data-raw '{
"text": "to everyone, the best things in life are free. the stars belong to everyone, they gleam there for you and me. the flowers in spring, the robins that sing, the sunbeams that shine, they\'re yours, they\'re mine. and love can come to everyone, the best things in life are"
}'
Az alábbi mezőknek szerepelnie kell az URL-címben:
| Név | Kötelező | Leírás | Típus |
|---|---|---|---|
| API-verzió | Kötelező | Ezt az API-verziót kell ellenőrizni. A jelenlegi verzió: api-version=2023-10-15-preview. Példa: <endpoint>/contentsafety/text:detectProtectedMaterial?api-version=2023-10-15-preview |
Sztring |
A kérelem törzsének paramétereit ebben a táblában definiáljuk:
| Név | Kötelező | Leírás | Típus |
|---|---|---|---|
| text | Kötelező | Ezt a nyers szöveget kell ellenőrizni. Egyéb nem ascii karakterek is belefoglalhatók. | Sztring |
Tekintse meg a következő mintakérés törzsét:
{
"text": "string"
}
Nyisson meg egy parancssori ablakot, és futtassa a cURL parancsot.
Az API-válasz értelmezése
A védett anyagészlelési eredményeknek JSON-adatként kell megjelennie a konzol kimenetében. Példa:
{
"protectedMaterialAnalysis": {
"detected": true
}
}
A kimenet JSON-mezői itt vannak definiálva:
| Név | Leírás | Típus |
|---|---|---|
| protectedMaterialAnalysis | Minden kimeneti osztály, amelyet az API előre jelez. | Sztring |
| Észlelt | Azt jelzi, hogy a védett anyag észlelhető-e. | Logikai |
Az erőforrások eltávolítása
Ha törölni és eltávolítani szeretne egy Azure AI-szolgáltatási előfizetést, törölheti az erőforrást vagy az erőforráscsoportot. Az erőforráscsoport törlése a hozzá társított egyéb erőforrásokat is törli.
Következő lépések
Konfigurálja az egyes kategóriák szűrőit, és tesztelje az adathalmazokat a Content Széf ty Studióval, exportálja a kódot, és telepítse őket.