Rövid útmutató: Szöveges tartalom elemzése

Cikk
03/12/2024

Ismerkedés a Content Széf ty Studióval, a REST API-val vagy az ügyféloldali SDK-kkal az alapszintű szövegmoderáláshoz. Az Azure AI Content Széf ty szolgáltatás AI-algoritmusokat biztosít a kifogásolható tartalmak megjelöléséhez. A kipróbálásához kövesse az alábbi lépéseket.

Feljegyzés

A mintaadatok és a kód sértő tartalmat tartalmazhatnak. A felhasználó belátása ajánlott.

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 (az USA keleti régióját vagy Nyugat-Európát), valamint 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öveges tartalmak elemzése

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 10K karakter.

curl --location --request POST '<endpoint>/contentsafety/text:analyze?api-version=2023-10-01' \
--header 'Ocp-Apim-Subscription-Key: <your_subscription_key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "text": "I hate you",
  "categories": [
   "Hate","Sexual","SelfHarm","Violence"
  ]
   "blocklistNames": [
      "string"
    ],
   "haltOnBlocklistHit": true,
   "outputType": "FourSeverityLevels"
}'

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-01. Példa: `<endpoint>/contentsafety/text:analyze?api-version=2023-10-01`	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
Kategóriák	Választható	A rendszer feltételezi, hogy ez a kategórianevek tömbje. Az elérhető kategórianevek listáját a Kárkategóriák útmutatóban találja. Ha nincs megadva kategória, a rendszer mind a négy kategóriát használja. Több kategóriát használunk a pontszámok egyetlen kérelemben való lekéréséhez.	Sztring
blocklistNames	Választható	Szövegblokkoló neve. Csak a következő karaktereket támogatja: `0-9 A-Z a-z - . _ ~`. Itt több listanevet is csatolhat.	Tömb
haltOnBlocklistHit	Választható	Ha be van `true`állítva, a káros tartalmak további elemzése nem történik meg olyan esetekben, amikor a tiltólistákat találatok érik. Ha be van `false`állítva, minden káros tartalom elemzése el lesz végezve, függetlenül attól, hogy a tiltólistákat találatok érik-e el.	Logikai
outputType	Választható	`"FourSeverityLevels"` vagy `"EightSeverityLevels"`. A kimenet súlyossága négy vagy nyolc szinten, az érték lehet `0,2,4,6` vagy `0,1,2,3,4,5,6,7`.	Sztring

Tekintse meg a következő mintakérés törzsét:

{
  "text": "I hate you",
  "categories": [
   "Hate","Sexual","SelfHarm","Violence"
  ],
  "blocklistNames": [
    "array"
  ],
  "haltOnBlocklistHit": false,
  "outputType": "FourSeverityLevels"
}

Nyisson meg egy parancssori ablakot, és futtassa a cURL parancsot.

Az API-válasz értelmezése

A szövegmoderálási eredményeknek JSON-adatokként kell megjelennie a konzol kimenetében. Példa:

{
  "blocklistsMatch": [
    {
      "blocklistName": "string",
      "blocklistItemId": "string",
      "blocklistItemText": "string"
    }
  ],
  "categoriesAnalysis": [
        {
            "category": "Hate",
            "severity": 2
        },
        {
            "category": "SelfHarm",
            "severity": 0
        },
        {
            "category": "Sexual",
            "severity": 0
        },
        {
            "category": "Violence",
            "severity": 0
  ]
}

A kimenet JSON-mezői itt vannak definiálva:

Név	Leírás	Típus
categoriesAnalysis	Minden kimeneti osztály, amelyet az API előre jelez. A besorolás többcímkés is lehet. Ha például egy szövegmintát futtat a szövegmoderálási modellen, az szexuális tartalomként és erőszakként is besorolható. Kárkategóriák	Sztring
Súlyosság	Minél nagyobb a bemeneti tartalom súlyossága, annál nagyobb ez az érték.	Egész

Referenciadokumentáció Kódtár forráskódcsomagja | (NuGet) | -minták |

Előfeltételek

Azure-előfizetés – Ingyenes létrehozás
A Visual Studio IDE és a számítási feladat .NET asztali fejlesztése engedélyezve van. Vagy ha nem tervezi a Visual Studio IDE használatát, akkor a .NET Core aktuális verziójára van szüksége.
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 (az USA keleti régióját vagy Nyugat-Európát), valamint 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.

Alkalmazás beállítása

Hozzon létre egy új C#-alkalmazást.

Visual Studio IDE
Parancssori felület

Nyissa meg a Visual Studiót, és az Első lépések csoportban válassza az Új projekt létrehozása lehetőséget. Állítsa be a sablonszűrőket A C#/Minden platform/konzol értékre. Válassza a Konzolalkalmazás (a .NET-en futtatható parancssori alkalmazás Windows, Linux és macOS rendszeren) lehetőséget, és válassza a Tovább gombot. Frissítse a projekt nevét a Content Széf tyQuickstart fájlra, és válassza a Tovább gombot. Válassza a .NET 6.0-s vagy újabb verzióját, és válassza a Létrehozás lehetőséget a projekt létrehozásához.

Az ügyféloldali SDK telepítése

Miután létrehozott egy új projektet, telepítse az ügyfél SDK-t a jobb gombbal a projektmegoldásra kattintva a Megoldáskezelő, majd válassza a NuGet-csomagok kezelése lehetőséget. A megnyíló csomagkezelőben válassza a Tallózás lehetőséget, és keressen ráAzure.AI.ContentSafety. Válassza a Telepítés lehetőséget.

Egy konzolablakban (például parancsmag, PowerShell vagy Bash) a dotnet new paranccsal hozzon létre egy új konzolalkalmazást a névvel content-safety-quickstart. Ez a parancs egy egyszerű ""Helló világ!" alkalmazás" C#-projektet hoz létre egyetlen forrásfájllal: Program.cs.

dotnet new console -n content-safety-quickstart

Módosítsa a könyvtárat az újonnan létrehozott alkalmazásmappára. Az alkalmazást a következőkkel hozhatja létre:

dotnet build

A buildkimenet nem tartalmazhat figyelmeztetést vagy hibát.

...
Build succeeded.
  0 Warning(s)
  0 Error(s)
...

Az ügyféloldali SDK telepítése

Az alkalmazáskönyvtárban telepítse a Computer Vision ügyfél SDK for .NET-et a következő paranccsal:

dotnet add package Azure.AI.ContentSafety

Környezeti változók létrehozása

Ebben a példában a hitelesítő adatokat az alkalmazást futtató helyi gépen lévő környezeti változókba fogja írni.

Tipp.

Ne vegye fel közvetlenül a kulcsot a kódba, és soha ne tegye közzé nyilvánosan. Az Azure AI-szolgáltatások biztonsági cikkében további hitelesítési lehetőségeket talál, például az Azure Key Vaultot.

A kulcs és a végpont környezeti változójának beállításához nyisson meg egy konzolablakot, és kövesse az operációs rendszer és a fejlesztési környezet utasításait.

A CONTENT_SAFETY_KEY környezeti változó beállításához cserélje le YOUR_CONTENT_SAFETY_KEY az erőforrás egyik kulcsára.
A CONTENT_SAFETY_ENDPOINT környezeti változó beállításához cserélje le YOUR_CONTENT_SAFETY_ENDPOINT az erőforrás végpontját.

Windows
Linux

setx CONTENT_SAFETY_KEY 'YOUR_CONTENT_SAFETY_KEY'

setx CONTENT_SAFETY_ENDPOINT 'YOUR_CONTENT_SAFETY_ENDPOINT'

A környezeti változók hozzáadása után előfordulhat, hogy újra kell indítania azokat a futó programokat, amelyek felolvassák a környezeti változókat, beleértve a konzolablakot is.

export CONTENT_SAFETY_KEY='YOUR_CONTENT_SAFETY_KEY'

export CONTENT_SAFETY_ENDPOINT='YOUR_CONTENT_SAFETY_ENDPOINT'

Miután hozzáadta a környezeti változókat, futtassa source ~/.bashrc a konzolablakból a módosítások hatékonyabbá tétele érdekében.

Szöveges tartalmak elemzése

A projektkönyvtárban nyissa meg a korábban létrehozott Program.cs fájlt. Illessze be a következő kódot:

using System;
using Azure.AI.ContentSafety;

namespace Azure.AI.ContentSafety.Dotnet.Sample
{
  class ContentSafetySampleAnalyzeText
  {
    public static void AnalyzeText()
    {
      // retrieve the endpoint and key from the environment variables created earlier
      string endpoint = Environment.GetEnvironmentVariable("CONTENT_SAFETY_ENDPOINT");
      string key = Environment.GetEnvironmentVariable("CONTENT_SAFETY_KEY");

      ContentSafetyClient client = new ContentSafetyClient(new Uri(endpoint), new AzureKeyCredential(key));

      string text = "Your input text";

      var request = new AnalyzeTextOptions(text);

      Response<AnalyzeTextResult> response;
      try
      {
          response = client.AnalyzeText(request);
      }
      catch (RequestFailedException ex)
      {
          Console.WriteLine("Analyze text failed.\nStatus code: {0}, Error code: {1}, Error message: {2}", ex.Status, ex.ErrorCode, ex.Message);
          throw;
      }

      Console.WriteLine("\nAnalyze text succeeded:");
      Console.WriteLine("Hate severity: {0}", response.Value.CategoriesAnalysis.FirstOrDefault(a => a.Category == TextCategory.Hate)?.Severity ?? 0);
      Console.WriteLine("SelfHarm severity: {0}", response.Value.CategoriesAnalysis.FirstOrDefault(a => a.Category == TextCategory.SelfHarm)?.Severity ?? 0);
      Console.WriteLine("Sexual severity: {0}", response.Value.CategoriesAnalysis.FirstOrDefault(a => a.Category == TextCategory.Sexual)?.Severity ?? 0);
      Console.WriteLine("Violence severity: {0}", response.Value.CategoriesAnalysis.FirstOrDefault(a => a.Category == TextCategory.Violence)?.Severity ?? 0);

    }
    static void Main()
    {
        AnalyzeText();
    }
  }
}

Cserélje le "Your input text" a használni kívánt szöveges tartalomra.

Tipp.

Szövegméret és részletesség

A szöveges beküldések alapértelmezett maximális hossza 10K karakter.

Visual Studio IDE
Parancssori felület

Az alkalmazás létrehozásához és futtatásához válassza a Hibakeresés indítása lehetőséget az IDE ablak tetején található Hibakeresés menüből (vagy nyomja le az F5 billentyűt).

Hozza létre és futtassa az alkalmazást az alkalmazáskönyvtárból az alábbi parancsokkal:

dotnet build
dotnet run

Referenciadokumentáció Kódtár forráskódcsomagja | (PyPI)Minták | | |

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 (az USA keleti régióját vagy Nyugat-Európát), valamint 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.
Python 3.x
- A Python-telepítésnek tartalmaznia kell a pipet. A parancssorban való futtatással pip --version ellenőrizheti, hogy telepítve van-e a pip. Kérje le a pipet a Python legújabb verziójának telepítésével.

Környezeti változók létrehozása

Ebben a példában a hitelesítő adatokat az alkalmazást futtató helyi gépen lévő környezeti változókba fogja írni.

Tipp.

A kulcs és a végpont környezeti változójának beállításához nyisson meg egy konzolablakot, és kövesse az operációs rendszer és a fejlesztési környezet utasításait.

A CONTENT_SAFETY_KEY környezeti változó beállításához cserélje le YOUR_CONTENT_SAFETY_KEY az erőforrás egyik kulcsára.
A CONTENT_SAFETY_ENDPOINT környezeti változó beállításához cserélje le YOUR_CONTENT_SAFETY_ENDPOINT az erőforrás végpontját.

Windows
Linux

setx CONTENT_SAFETY_KEY 'YOUR_CONTENT_SAFETY_KEY'

setx CONTENT_SAFETY_ENDPOINT 'YOUR_CONTENT_SAFETY_ENDPOINT'

A környezeti változók hozzáadása után előfordulhat, hogy újra kell indítania azokat a futó programokat, amelyek felolvassák a környezeti változókat, beleértve a konzolablakot is.

export CONTENT_SAFETY_KEY='YOUR_CONTENT_SAFETY_KEY'

export CONTENT_SAFETY_ENDPOINT='YOUR_CONTENT_SAFETY_ENDPOINT'

Miután hozzáadta a környezeti változókat, futtassa source ~/.bashrc a konzolablakból a módosítások hatékonyabbá tétele érdekében.

Szöveges tartalmak elemzése

A következő szakasz végigvezet egy mintakérésen a Python SDK-val.

Nyisson meg egy parancssort, keresse meg a projektmappát, és hozzon létre egy quickstart.py nevű új fájlt.
Futtassa ezt a parancsot az Azure AI Content Széf ty kódtár telepítéséhez:
```
pip install azure-ai-contentsafety
```

Másolja a következő kódot a quickstart.py:

import os
from azure.ai.contentsafety import ContentSafetyClient
from azure.core.credentials import AzureKeyCredential
from azure.core.exceptions import HttpResponseError
from azure.ai.contentsafety.models import AnalyzeTextOptions, TextCategory

def analyze_text():
    # analyze text
    key = os.environ["CONTENT_SAFETY_KEY"]
    endpoint = os.environ["CONTENT_SAFETY_ENDPOINT"]

    # Create an Azure AI Content Safety client
    client = ContentSafetyClient(endpoint, AzureKeyCredential(key))

    # Contruct request
    request = AnalyzeTextOptions(text="Your input text")

    # Analyze text
    try:
        response = client.analyze_text(request)
    except HttpResponseError as e:
        print("Analyze text failed.")
        if e.error:
            print(f"Error code: {e.error.code}")
            print(f"Error message: {e.error.message}")
            raise
        print(e)
        raise

    hate_result = next(item for item in response.categories_analysis if item.category == TextCategory.HATE)
    self_harm_result = next(item for item in response.categories_analysis if item.category == TextCategory.SELF_HARM)
    sexual_result = next(item for item in response.categories_analysis if item.category == TextCategory.SEXUAL)
    violence_result = next(item for item in response.categories_analysis if item.category == TextCategory.VIOLENCE)

    if hate_result:
        print(f"Hate severity: {hate_result.severity}")
    if self_harm_result:
        print(f"SelfHarm severity: {self_harm_result.severity}")
    if sexual_result:
        print(f"Sexual severity: {sexual_result.severity}")
    if violence_result:
        print(f"Violence severity: {violence_result.severity}")

if __name__ == "__main__":
    analyze_text()

Cserélje le "Your input text" a használni kívánt szöveges tartalomra.

Tipp.

Szövegméret és részletesség

A szöveges beküldések alapértelmezett maximális hossza 10K karakter.
Ezután futtassa az alkalmazást a python rövid útmutatófájl parancsával.
```
python quickstart.py
```

Referenciadokumentáció Kódtár forráskód | összetevője (Maven)Minták | |

Előfeltételek

Azure-előfizetés – Ingyenes létrehozás
A Java Development Kit (JDK) aktuális verziója
A Gradle buildelési eszköz vagy egy másik függőségkezelő.
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 (az USA keleti régióját vagy Nyugat-Európát), valamint 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.

Alkalmazás beállítása

Hozzon létre egy új Gradle-projektet.

Egy konzolablakban (pl. cmd, PowerShell vagy Bash) hozzon létre egy új mappát az alkalmazásnak, majd navigáljon oda.

mkdir myapp && cd myapp

Futtassa a gradle init parancsot a munkakönyvtárból. Ez a parancs alapvető buildfájlokat hoz létre a Gradle-hez, beleértve a build.gradle.kts fájlt, amelyet futásidőben használnak az alkalmazás létrehozásához és konfigurálásához.

gradle init --type basic

Amikor a rendszer kéri, hogy válasszon egy DSL-t, válassza a Kotlin lehetőséget.

A munkakönyvtárban futtassa a következő parancsot a projekt forrásmappájának létrehozásához:

mkdir -p src/main/java

Lépjen az új mappára, és hozzon létre egy Content Széf tyQuickstart.java nevű fájlt.

Az ügyféloldali SDK telepítése

Ez a rövid útmutató a Gradle függőségkezelőt használja. A Maven Central-adattárban megtalálhatja a többi függőségkezelő ügyfélkódtárát és információit.

Keresse meg a build.gradle.kts fájlt, és nyissa meg a kívánt IDE- vagy szövegszerkesztővel. Ezután másolja a következő buildkonfigurációba. Ez a konfiguráció java-alkalmazásként definiálja a projektet, amelynek belépési pontja a Content Széf tyQuickstart osztály. Importálja az Azure AI Vision-kódtárat.

plugins {
    java
    application
}
application { 
    mainClass.set("ContentSafetyQuickstart")
}
repositories {
    mavenCentral()
}
dependencies {
    implementation(group = "com.azure", name = "azure-ai-contentsafety", version = "1.0.0")
}

Környezeti változók létrehozása

Ebben a példában a hitelesítő adatokat az alkalmazást futtató helyi gépen lévő környezeti változókba fogja írni.

Tipp.

A kulcs és a végpont környezeti változójának beállításához nyisson meg egy konzolablakot, és kövesse az operációs rendszer és a fejlesztési környezet utasításait.

A CONTENT_SAFETY_KEY környezeti változó beállításához cserélje le YOUR_CONTENT_SAFETY_KEY az erőforrás egyik kulcsára.
A CONTENT_SAFETY_ENDPOINT környezeti változó beállításához cserélje le YOUR_CONTENT_SAFETY_ENDPOINT az erőforrás végpontját.

Windows
Linux

setx CONTENT_SAFETY_KEY 'YOUR_CONTENT_SAFETY_KEY'

setx CONTENT_SAFETY_ENDPOINT 'YOUR_CONTENT_SAFETY_ENDPOINT'

A környezeti változók hozzáadása után előfordulhat, hogy újra kell indítania azokat a futó programokat, amelyek felolvassák a környezeti változókat, beleértve a konzolablakot is.

export CONTENT_SAFETY_KEY='YOUR_CONTENT_SAFETY_KEY'

export CONTENT_SAFETY_ENDPOINT='YOUR_CONTENT_SAFETY_ENDPOINT'

Miután hozzáadta a környezeti változókat, futtassa source ~/.bashrc a konzolablakból a módosítások hatékonyabbá tétele érdekében.

Szöveges tartalmak elemzése

Nyissa meg a Tartalmat Széf tyQuickstart.java az előnyben részesített szerkesztőben vagy IDE-ben, és illessze be a következő kódba. Cserélje le <your text sample> a használni kívánt szöveges tartalomra.

Tipp.

Szövegméret és részletesség

A szöveges beküldések alapértelmezett maximális hossza 10K karakter.

import com.azure.ai.contentsafety.ContentSafetyClient;
import com.azure.ai.contentsafety.ContentSafetyClientBuilder;
import com.azure.ai.contentsafety.models.AnalyzeTextOptions;
import com.azure.ai.contentsafety.models.AnalyzeTextResult;
import com.azure.ai.contentsafety.models.TextCategoriesAnalysis;
import com.azure.core.credential.KeyCredential;
import com.azure.core.util.Configuration;


public class ContentSafetyQuickstart {
    public static void main(String[] args) {

        // get endpoint and key from environment variables
        String endpoint = System.getenv("CONTENT_SAFETY_ENDPOINT");
        String key = System.getenv("CONTENT_SAFETY_KEY");
        
        ContentSafetyClient contentSafetyClient = new ContentSafetyClientBuilder()
            .credential(new KeyCredential(key))
            .endpoint(endpoint).buildClient();

        AnalyzeTextResult response = contentSafetyClient.analyzeText(new AnalyzeTextOptions("<your text sample>"));

        for (TextCategoriesAnalysis result : response.getCategoriesAnalysis()) {
            System.out.println(result.getCategory() + " severity: " + result.getSeverity());
        }
    }
}

Lépjen vissza a projekt gyökérmappájához, és hozza létre az alkalmazást a következőkkel:

gradle build

Ezután futtassa a gradle run következő paranccsal:

gradle run

Hozam

Hate severity: 0
SelfHarm severity: 0
Sexual severity: 0
Violence severity: 0

Referenciadokumentáció Kódtár forráskódcsomagja | (npm)Minták | | |

Előfeltételek

Azure-előfizetés – Ingyenes létrehozás
A Node.js aktuális verziója
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 (az USA keleti régióját vagy Nyugat-Európát), valamint 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.

Alkalmazás beállítása

Hozzon létre egy új Node.js alkalmazást. Egy konzolablakban (pl. cmd, PowerShell vagy Bash) hozzon létre egy új mappát az alkalmazásnak, majd navigáljon oda.

mkdir myapp && cd myapp

Futtassa az npm init parancsot egy Node-alkalmazás package.json fájllal való létrehozásához.

npm init

Az ügyféloldali SDK telepítése

Telepítse az @azure-rest/ai-content-safety npm-csomagot:

npm install @azure-rest/ai-content-safety

Telepítse a modult környezeti dotenv változók használatára is:

npm install dotenv

Az alkalmazás package.json fájlja frissül a függőségekkel.

Környezeti változók létrehozása

Ebben a példában a hitelesítő adatokat az alkalmazást futtató helyi gépen lévő környezeti változókba fogja írni.

Tipp.

A kulcs és a végpont környezeti változójának beállításához nyisson meg egy konzolablakot, és kövesse az operációs rendszer és a fejlesztési környezet utasításait.

A CONTENT_SAFETY_KEY környezeti változó beállításához cserélje le YOUR_CONTENT_SAFETY_KEY az erőforrás egyik kulcsára.
A CONTENT_SAFETY_ENDPOINT környezeti változó beállításához cserélje le YOUR_CONTENT_SAFETY_ENDPOINT az erőforrás végpontját.

Windows
Linux

setx CONTENT_SAFETY_KEY 'YOUR_CONTENT_SAFETY_KEY'

setx CONTENT_SAFETY_ENDPOINT 'YOUR_CONTENT_SAFETY_ENDPOINT'

A környezeti változók hozzáadása után előfordulhat, hogy újra kell indítania azokat a futó programokat, amelyek felolvassák a környezeti változókat, beleértve a konzolablakot is.

export CONTENT_SAFETY_KEY='YOUR_CONTENT_SAFETY_KEY'

export CONTENT_SAFETY_ENDPOINT='YOUR_CONTENT_SAFETY_ENDPOINT'

Miután hozzáadta a környezeti változókat, futtassa source ~/.bashrc a konzolablakból a módosítások hatékonyabbá tétele érdekében.

Szöveges tartalmak elemzése

Hozzon létre egy új fájlt a címtárban, index.js. Nyissa meg a kívánt szerkesztőben vagy IDE-ben, és illessze be a következő kódba. Cserélje le <your text sample> a használni kívánt szöveges tartalomra.

Tipp.

Szövegméret és részletesség

A szöveges beküldések alapértelmezett maximális hossza 10K karakter.

const ContentSafetyClient = require("@azure-rest/ai-content-safety").default,
  { isUnexpected } = require("@azure-rest/ai-content-safety");
const { AzureKeyCredential } = require("@azure/core-auth");

// Load the .env file if it exists
require("dotenv").config();

async function main() {
    // get endpoint and key from environment variables
    const endpoint = process.env["CONTENT_SAFETY_ENDPOINT"];
    const key = process.env["CONTENT_SAFETY_KEY"];
    
    const credential = new AzureKeyCredential(key);
    const client = ContentSafetyClient(endpoint, credential);
    
    // replace with your own sample text string 
    const text = "<your sample text>";
    const analyzeTextOption = { text: text };
    const analyzeTextParameters = { body: analyzeTextOption };
    
    const result = await client.path("/text:analyze").post(analyzeTextParameters);
    
    if (isUnexpected(result)) {
        throw result;
    }
    
    for (let i = 0; i < result.body.categoriesAnalysis.length; i++) {
    const textCategoriesAnalysisOutput = result.body.categoriesAnalysis[i];
    console.log(
      textCategoriesAnalysisOutput.category,
      " severity: ",
      textCategoriesAnalysisOutput.severity
    );
  }
}

main().catch((err) => {
    console.error("The sample encountered an error:", err);
});

Futtassa az alkalmazást a node paranccsal a gyorsútmutatós fájlon.

node index.js

Hozam

Hate severity:  0
SelfHarm severity:  0
Sexual severity:  0
Violence severity:  0

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.

A Content Széf ty Studio rövid útmutatója

Share via

Rövid útmutató: Szöveges tartalom elemzése

Előfeltételek

Szöveges tartalmak elemzése

Az API-válasz értelmezése

Előfeltételek

Alkalmazás beállítása

Az ügyféloldali SDK telepítése

Az ügyféloldali SDK telepítése

Környezeti változók létrehozása

Szöveges tartalmak elemzése

Előfeltételek

Környezeti változók létrehozása

Szöveges tartalmak elemzése

Előfeltételek

Alkalmazás beállítása

Az ügyféloldali SDK telepítése

Környezeti változók létrehozása

Szöveges tartalmak elemzése

Hozam

Előfeltételek

Alkalmazás beállítása

Az ügyféloldali SDK telepítése

Környezeti változók létrehozása

Szöveges tartalmak elemzése

Hozam

Az erőforrások eltávolítása

Következő lépések

További források