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

Rövid útmutató: Személyazonosításra alkalmas adatok észlelése (PII)

  • Cikk

Feljegyzés

Ez a rövid útmutató csak a dokumentumokban található PII-észlelést ismerteti. Ha többet szeretne megtudni a PII beszélgetésekben való észleléséről, olvassa el a PII észlelése és újbóli használata a beszélgetésekben című témakört.

Referenciadokumentáció | További minták | Csomag (NuGet) | Kódtár forráskódja

Ezzel a rövid útmutatóval létrehozhat egy személyazonosításra alkalmas adatokat (PII) észlelő alkalmazást a .NET ügyfélkódtárával. Az alábbi példában létrehoz egy C#-alkalmazást, amely képes azonosítani a szövegben felismert bizalmas információkat .

Tipp.

A Language Studio használatával kódírás nélkül is kipróbálhatja a PII-észlelést a dokumentumokban.

Előfeltételek

Beállítás

Azure-erőforrás létrehozása

Az alábbi kódminta használatához üzembe kell helyeznie egy Azure-erőforrást. Ez az erőforrás tartalmazni fog egy kulcsot és végpontot, a nyelvszolgáltatásnak küldött API-hívások hitelesítéséhez.

  1. Az alábbi hivatkozással nyelvi erőforrást hozhat létre az Azure Portal használatával. Az Azure-előfizetéssel kell bejelentkeznie.

  2. A megjelenő További funkciók kiválasztása képernyőn válassza a Folytatás lehetőséget az erőforrás létrehozásához.

    Képernyőkép az Azure Portal további funkcióiról.

  3. A Nyelv létrehozása képernyőn adja meg a következő információkat:

    Részlet Leírás
    Előfizetés Az az előfizetési fiók, amelyhez az erőforrás társítva lesz. Válassza ki az Azure-előfizetését a legördülő menüből.
    Erőforráscsoport Az erőforráscsoportok olyan tárolók, amelyek a létrehozott erőforrásokat tárolják. Új erőforráscsoport létrehozásához válassza az Új létrehozása lehetőséget.
    Régió A nyelvi erőforrás helye. A különböző régiók késést okozhatnak a fizikai helytől függően, de nincs hatással az erőforrás futásidejű rendelkezésre állására. Ebben a rövid útmutatóban válasszon ki egy Önhöz közeli elérhető régiót, vagy válassza az USA keleti régióját.
    Név A nyelvi erőforrás neve. Ez a név egy végponti URL-cím létrehozásához is használható, amelyet az alkalmazások API-kérések küldéséhez fognak használni.
    Tarifacsomag A nyelvi erőforrás tarifacsomagja . Az ingyenes F0 szinttel kipróbálhatja a szolgáltatást, és később frissíthet egy fizetős szintre éles környezetben.

    Képernyőkép az erőforrás-létrehozás részleteiről az Azure Portalon.

  4. Győződjön meg arról, hogy a Felelős AI-értesítés jelölőnégyzet be van jelölve.

  5. Válassza a Véleményezés + Létrehozás lehetőséget a lap alján.

  6. A megjelenő képernyőn győződjön meg arról, hogy az ellenőrzés sikeres volt, és helyesen adta meg az adatokat. Válassza a Létrehozás parancsot.

Kulcs és végpont lekérése

Ezután szüksége lesz az erőforrás kulcsára és végpontjára az alkalmazás API-hoz való csatlakoztatásához. A rövid útmutató későbbi részében illessze be a kulcsot és a végpontot a kódba.

  1. A nyelvi erőforrás sikeres üzembe helyezése után kattintson az Ugrás az erőforrásra gombra a Következő lépések csoportban.

    Képernyőkép az erőforrás üzembe helyezésének következő lépéseiről.

  2. Az erőforrás képernyőjén válassza a bal oldali navigációs menü Kulcsok és végpont elemét. Az alábbi lépésekben az egyik kulcsot és a végpontot fogja használni.

    Egy erőforrás kulcsait és végpontszakaszát bemutató képernyőkép.

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

Az alkalmazásnak hitelesítenie kell az API-kérések küldéséhez. Éles környezetben használjon biztonságos módot a hitelesítő adatok tárolására és elérésére. 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 nyelvi erőforráskulcs 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.

  1. A LANGUAGE_KEY környezeti változó beállításához cserélje le your-key az erőforrás egyik kulcsára.
  2. A LANGUAGE_ENDPOINT környezeti változó beállításához cserélje le your-endpoint az erőforrás végpontját.
setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

Feljegyzés

Ha csak az aktuális futó konzolon kell hozzáférnie a környezeti változókhoz, a környezeti változót set ahelyett setxállíthatja be.

A környezeti változók hozzáadása után előfordulhat, hogy újra kell indítania a futó programokat, amelyeknek be kell olvasniuk a környezeti változókat, beleértve a konzolablakot is. Ha például a Visual Studiót használja szerkesztőként, indítsa újra a Visual Studiót a példa futtatása előtt.

Egy új .NET Core-alkalmazás létrehozása

A Visual Studio IDE használatával hozzon létre egy új .NET Core-konzolalkalmazást. Ez létrehoz egy ""Helló világ!" alkalmazás" projektet egyetlen C#-forrásfájllal: program.cs.

Az ügyfélkódtár telepítéséhez először kattintson a Megoldáskezelőben a megoldáson a jobb gombbal, és válassza a NuGet-csomagok kezelése pontot. A megnyíló csomagkezelőben válassza a Tallózás lehetőséget , és keressen rá Azure.AI.TextAnalytics. Válassza ki az 5.2.0 verziót, majd a Telepítés parancsot. Használhatja a Csomagkezelő konzolját is.

Mintakód

Másolja a következő kódot a program.cs fájlba, és futtassa a kódot.

using Azure;
using System;
using Azure.AI.TextAnalytics;

namespace Example
{
    class Program
    {
        // This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
        static string languageKey = Environment.GetEnvironmentVariable("LANGUAGE_KEY");
        static string languageEndpoint = Environment.GetEnvironmentVariable("LANGUAGE_ENDPOINT");

        private static readonly AzureKeyCredential credentials = new AzureKeyCredential(languageKey);
        private static readonly Uri endpoint = new Uri(languageEndpoint);

        // Example method for detecting sensitive information (PII) from text 
        static void RecognizePIIExample(TextAnalyticsClient client)
        {
            string document = "Call our office at 312-555-1234, or send an email to support@contoso.com.";
        
            PiiEntityCollection entities = client.RecognizePiiEntities(document).Value;
        
            Console.WriteLine($"Redacted Text: {entities.RedactedText}");
            if (entities.Count > 0)
            {
                Console.WriteLine($"Recognized {entities.Count} PII entit{(entities.Count > 1 ? "ies" : "y")}:");
                foreach (PiiEntity entity in entities)
                {
                    Console.WriteLine($"Text: {entity.Text}, Category: {entity.Category}, SubCategory: {entity.SubCategory}, Confidence score: {entity.ConfidenceScore}");
                }
            }
            else
            {
                Console.WriteLine("No entities were found.");
            }
        }

        static void Main(string[] args)
        {
            var client = new TextAnalyticsClient(endpoint, credentials);
            RecognizePIIExample(client);

            Console.Write("Press any key to exit.");
            Console.ReadKey();
        }

    }
}

Hozam

Redacted Text: Call our office at ************, or send an email to *******************.
Recognized 2 PII entities:
Text: 312-555-1234, Category: PhoneNumber, SubCategory: , Confidence score: 0.8
Text: support@contoso.com, Category: Email, SubCategory: , Confidence score: 0.8

Referenciadokumentáció | További minták | csomag (Maven) | Kódtár forráskódja

Ezzel a rövid útmutatóval létrehozhat egy személyazonosításra alkalmas információkat (PII) észlelő alkalmazást a Java ügyfélkódtárával. Az alábbi példában egy Java-alkalmazást hoz létre, amely képes felismerni a szövegben lévő bizalmas információkat .

Tipp.

A Language Studio használatával kódírás nélkül is kipróbálhatja a PII-észlelést a dokumentumokban.

Előfeltételek

Beállítás

Azure-erőforrás létrehozása

Az alábbi kódminta használatához üzembe kell helyeznie egy Azure-erőforrást. Ez az erőforrás tartalmazni fog egy kulcsot és végpontot, a nyelvszolgáltatásnak küldött API-hívások hitelesítéséhez.

  1. Az alábbi hivatkozással nyelvi erőforrást hozhat létre az Azure Portal használatával. Az Azure-előfizetéssel kell bejelentkeznie.

  2. A megjelenő További funkciók kiválasztása képernyőn válassza a Folytatás lehetőséget az erőforrás létrehozásához.

    Képernyőkép az Azure Portal további funkcióiról.

  3. A Nyelv létrehozása képernyőn adja meg a következő információkat:

    Részlet Leírás
    Előfizetés Az az előfizetési fiók, amelyhez az erőforrás társítva lesz. Válassza ki az Azure-előfizetését a legördülő menüből.
    Erőforráscsoport Az erőforráscsoportok olyan tárolók, amelyek a létrehozott erőforrásokat tárolják. Új erőforráscsoport létrehozásához válassza az Új létrehozása lehetőséget.
    Régió A nyelvi erőforrás helye. A különböző régiók késést okozhatnak a fizikai helytől függően, de nincs hatással az erőforrás futásidejű rendelkezésre állására. Ebben a rövid útmutatóban válasszon ki egy Önhöz közeli elérhető régiót, vagy válassza az USA keleti régióját.
    Név A nyelvi erőforrás neve. Ez a név egy végponti URL-cím létrehozásához is használható, amelyet az alkalmazások API-kérések küldéséhez fognak használni.
    Tarifacsomag A nyelvi erőforrás tarifacsomagja . Az ingyenes F0 szinttel kipróbálhatja a szolgáltatást, és később frissíthet egy fizetős szintre éles környezetben.

    Képernyőkép az erőforrás-létrehozás részleteiről az Azure Portalon.

  4. Győződjön meg arról, hogy a Felelős AI-értesítés jelölőnégyzet be van jelölve.

  5. Válassza a Véleményezés + Létrehozás lehetőséget a lap alján.

  6. A megjelenő képernyőn győződjön meg arról, hogy az ellenőrzés sikeres volt, és helyesen adta meg az adatokat. Válassza a Létrehozás parancsot.

Kulcs és végpont lekérése

Ezután szüksége lesz az erőforrás kulcsára és végpontjára az alkalmazás API-hoz való csatlakoztatásához. A rövid útmutató későbbi részében illessze be a kulcsot és a végpontot a kódba.

  1. A nyelvi erőforrás sikeres üzembe helyezése után kattintson az Ugrás az erőforrásra gombra a Következő lépések csoportban.

    Képernyőkép az erőforrás üzembe helyezésének következő lépéseiről.

  2. Az erőforrás képernyőjén válassza a bal oldali navigációs menü Kulcsok és végpont elemét. Az alábbi lépésekben az egyik kulcsot és a végpontot fogja használni.

    Egy erőforrás kulcsait és végpontszakaszát bemutató képernyőkép.

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

Az alkalmazásnak hitelesítenie kell az API-kérések küldéséhez. Éles környezetben használjon biztonságos módot a hitelesítő adatok tárolására és elérésére. 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 nyelvi erőforráskulcs 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.

  1. A LANGUAGE_KEY környezeti változó beállításához cserélje le your-key az erőforrás egyik kulcsára.
  2. A LANGUAGE_ENDPOINT környezeti változó beállításához cserélje le your-endpoint az erőforrás végpontját.
setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

Feljegyzés

Ha csak az aktuális futó konzolon kell hozzáférnie a környezeti változókhoz, a környezeti változót set ahelyett setxállíthatja be.

A környezeti változók hozzáadása után előfordulhat, hogy újra kell indítania a futó programokat, amelyeknek be kell olvasniuk a környezeti változókat, beleértve a konzolablakot is. Ha például a Visual Studiót használja szerkesztőként, indítsa újra a Visual Studiót a példa futtatása előtt.

Az ügyfélkódtár hozzáadása

Hozzon létre egy Maven-projektet egy szabadon választott IDE- vagy fejlesztői környezetben. Ezután adja hozzá a következő függőséget a projekt pom.xml fájljához. Az egyéb buildelőeszközök implementációs szintaxisát megtalálja az interneten.

<dependencies>
     <dependency>
        <groupId>com.azure</groupId>
        <artifactId>azure-ai-textanalytics</artifactId>
        <version>5.2.0</version>
    </dependency>
</dependencies>

Mintakód

Hozzon létre egy Example.java nevű Java-fájlt. Nyissa meg a fájlt, és másolja az alábbi kódot. Most futtassa a kódot.

import com.azure.core.credential.AzureKeyCredential;
import com.azure.ai.textanalytics.models.*;
import com.azure.ai.textanalytics.TextAnalyticsClientBuilder;
import com.azure.ai.textanalytics.TextAnalyticsClient;

public class Example {

    // This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
    private static String languageKey = System.getenv("LANGUAGE_KEY");
    private static String languageEndpoint = System.getenv("LANGUAGE_ENDPOINT");

    public static void main(String[] args) {
        TextAnalyticsClient client = authenticateClient(languageKey, languageEndpoint);
        recognizePiiEntitiesExample(client);
    }
    // Method to authenticate the client object with your key and endpoint
    static TextAnalyticsClient authenticateClient(String key, String endpoint) {
        return new TextAnalyticsClientBuilder()
                .credential(new AzureKeyCredential(key))
                .endpoint(endpoint)
                .buildClient();
    }

    // Example method for detecting sensitive information (PII) from text 
    static void recognizePiiEntitiesExample(TextAnalyticsClient client)
    {
        // The text that need be analyzed.
        String document = "My SSN is 859-98-0987";
        PiiEntityCollection piiEntityCollection = client.recognizePiiEntities(document);
        System.out.printf("Redacted Text: %s%n", piiEntityCollection.getRedactedText());
        piiEntityCollection.forEach(entity -> System.out.printf(
            "Recognized Personally Identifiable Information entity: %s, entity category: %s, entity subcategory: %s,"
                + " confidence score: %f.%n",
            entity.getText(), entity.getCategory(), entity.getSubcategory(), entity.getConfidenceScore()));
    }
}

Hozam

Redacted Text: My SSN is ***********
Recognized Personally Identifiable Information entity: 859-98-0987, entity category: USSocialSecurityNumber, entity subcategory: null, confidence score: 0.650000.

Referenciadokumentáció | További minták | Csomag (npm) | Kódtár forráskódja

Ebben a rövid útmutatóban személyes azonosításra alkalmas információkat (PII) észlelő alkalmazást hozhat létre a Node.js ügyfélkódtárával. Az alábbi példában egy JavaScript-alkalmazást hoz létre, amely képes azonosítani a szövegben felismert bizalmas információkat .

Előfeltételek

Beállítás

Azure-erőforrás létrehozása

Az alábbi kódminta használatához üzembe kell helyeznie egy Azure-erőforrást. Ez az erőforrás tartalmazni fog egy kulcsot és végpontot, a nyelvszolgáltatásnak küldött API-hívások hitelesítéséhez.

  1. Az alábbi hivatkozással nyelvi erőforrást hozhat létre az Azure Portal használatával. Az Azure-előfizetéssel kell bejelentkeznie.

  2. A megjelenő További funkciók kiválasztása képernyőn válassza a Folytatás lehetőséget az erőforrás létrehozásához.

    Képernyőkép az Azure Portal további funkcióiról.

  3. A Nyelv létrehozása képernyőn adja meg a következő információkat:

    Részlet Leírás
    Előfizetés Az az előfizetési fiók, amelyhez az erőforrás társítva lesz. Válassza ki az Azure-előfizetését a legördülő menüből.
    Erőforráscsoport Az erőforráscsoportok olyan tárolók, amelyek a létrehozott erőforrásokat tárolják. Új erőforráscsoport létrehozásához válassza az Új létrehozása lehetőséget.
    Régió A nyelvi erőforrás helye. A különböző régiók késést okozhatnak a fizikai helytől függően, de nincs hatással az erőforrás futásidejű rendelkezésre állására. Ebben a rövid útmutatóban válasszon ki egy Önhöz közeli elérhető régiót, vagy válassza az USA keleti régióját.
    Név A nyelvi erőforrás neve. Ez a név egy végponti URL-cím létrehozásához is használható, amelyet az alkalmazások API-kérések küldéséhez fognak használni.
    Tarifacsomag A nyelvi erőforrás tarifacsomagja . Az ingyenes F0 szinttel kipróbálhatja a szolgáltatást, és később frissíthet egy fizetős szintre éles környezetben.

    Képernyőkép az erőforrás-létrehozás részleteiről az Azure Portalon.

  4. Győződjön meg arról, hogy a Felelős AI-értesítés jelölőnégyzet be van jelölve.

  5. Válassza a Véleményezés + Létrehozás lehetőséget a lap alján.

  6. A megjelenő képernyőn győződjön meg arról, hogy az ellenőrzés sikeres volt, és helyesen adta meg az adatokat. Válassza a Létrehozás parancsot.

Kulcs és végpont lekérése

Ezután szüksége lesz az erőforrás kulcsára és végpontjára az alkalmazás API-hoz való csatlakoztatásához. A rövid útmutató későbbi részében illessze be a kulcsot és a végpontot a kódba.

  1. A nyelvi erőforrás sikeres üzembe helyezése után kattintson az Ugrás az erőforrásra gombra a Következő lépések csoportban.

    Képernyőkép az erőforrás üzembe helyezésének következő lépéseiről.

  2. Az erőforrás képernyőjén válassza a bal oldali navigációs menü Kulcsok és végpont elemét. Az alábbi lépésekben az egyik kulcsot és a végpontot fogja használni.

    Egy erőforrás kulcsait és végpontszakaszát bemutató képernyőkép.

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

Az alkalmazásnak hitelesítenie kell az API-kérések küldéséhez. Éles környezetben használjon biztonságos módot a hitelesítő adatok tárolására és elérésére. 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 nyelvi erőforráskulcs 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.

  1. A LANGUAGE_KEY környezeti változó beállításához cserélje le your-key az erőforrás egyik kulcsára.
  2. A LANGUAGE_ENDPOINT környezeti változó beállításához cserélje le your-endpoint az erőforrás végpontját.
setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

Feljegyzés

Ha csak az aktuális futó konzolon kell hozzáférnie a környezeti változókhoz, a környezeti változót set ahelyett setxállíthatja be.

A környezeti változók hozzáadása után előfordulhat, hogy újra kell indítania a futó programokat, amelyeknek be kell olvasniuk a környezeti változókat, beleértve a konzolablakot is. Ha például a Visual Studiót használja szerkesztőként, indítsa újra a Visual Studiót a példa futtatása előtt.

Új Node.js-alkalmazás létrehozása

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

Telepítse az ügyfélkódtárat

Telepítse az npm-csomagot:

npm install @azure/ai-text-analytics

Mintakód

Nyissa meg a fájlt, és másolja az alábbi kódot. Most futtassa a kódot.

"use strict";

const { TextAnalyticsClient, AzureKeyCredential } = require("@azure/ai-text-analytics");

// This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
const key = process.env.LANGUAGE_KEY;
const endpoint = process.env.LANGUAGE_ENDPOINT;

//an example document for pii recognition
const documents = [ "The employee's phone number is (555) 555-5555." ];

async function main() {
    console.log(`PII recognition sample`);
  
    const client = new TextAnalyticsClient(endpoint, new AzureKeyCredential(key));
  
    const documents = ["My phone number is 555-555-5555"];
  
    const [result] = await client.analyze("PiiEntityRecognition", documents, "en");
  
    if (!result.error) {
      console.log(`Redacted text: "${result.redactedText}"`);
      console.log("Pii Entities: ");
      for (const entity of result.entities) {
        console.log(`\t- "${entity.text}" of type ${entity.category}`);
      }
    }
}

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

Hozam

PII recognition sample
Redacted text: "My phone number is ************"
Pii Entities:
        - "555-555-5555" of type PhoneNumber

Referenciadokumentáció | További minták | Csomag (PyPi) | Kódtár forráskódja

Ezzel a rövid útmutatóval létrehozhat egy személyazonosításra alkalmas adatokat (PII) észlelő alkalmazást a Python ügyfélkódtárával. A következő példában létrehoz egy Python-alkalmazást, amely képes azonosítani a szövegben felismert bizalmas információkat .

Előfeltételek

Beállítás

Azure-erőforrás létrehozása

Az alábbi kódminta használatához üzembe kell helyeznie egy Azure-erőforrást. Ez az erőforrás tartalmazni fog egy kulcsot és végpontot, a nyelvszolgáltatásnak küldött API-hívások hitelesítéséhez.

  1. Az alábbi hivatkozással nyelvi erőforrást hozhat létre az Azure Portal használatával. Az Azure-előfizetéssel kell bejelentkeznie.

  2. A megjelenő További funkciók kiválasztása képernyőn válassza a Folytatás lehetőséget az erőforrás létrehozásához.

    Képernyőkép az Azure Portal további funkcióiról.

  3. A Nyelv létrehozása képernyőn adja meg a következő információkat:

    Részlet Leírás
    Előfizetés Az az előfizetési fiók, amelyhez az erőforrás társítva lesz. Válassza ki az Azure-előfizetését a legördülő menüből.
    Erőforráscsoport Az erőforráscsoportok olyan tárolók, amelyek a létrehozott erőforrásokat tárolják. Új erőforráscsoport létrehozásához válassza az Új létrehozása lehetőséget.
    Régió A nyelvi erőforrás helye. A különböző régiók késést okozhatnak a fizikai helytől függően, de nincs hatással az erőforrás futásidejű rendelkezésre állására. Ebben a rövid útmutatóban válasszon ki egy Önhöz közeli elérhető régiót, vagy válassza az USA keleti régióját.
    Név A nyelvi erőforrás neve. Ez a név egy végponti URL-cím létrehozásához is használható, amelyet az alkalmazások API-kérések küldéséhez fognak használni.
    Tarifacsomag A nyelvi erőforrás tarifacsomagja . Az ingyenes F0 szinttel kipróbálhatja a szolgáltatást, és később frissíthet egy fizetős szintre éles környezetben.

    Képernyőkép az erőforrás-létrehozás részleteiről az Azure Portalon.

  4. Győződjön meg arról, hogy a Felelős AI-értesítés jelölőnégyzet be van jelölve.

  5. Válassza a Véleményezés + Létrehozás lehetőséget a lap alján.

  6. A megjelenő képernyőn győződjön meg arról, hogy az ellenőrzés sikeres volt, és helyesen adta meg az adatokat. Válassza a Létrehozás parancsot.

Kulcs és végpont lekérése

Ezután szüksége lesz az erőforrás kulcsára és végpontjára az alkalmazás API-hoz való csatlakoztatásához. A rövid útmutató későbbi részében illessze be a kulcsot és a végpontot a kódba.

  1. A nyelvi erőforrás sikeres üzembe helyezése után kattintson az Ugrás az erőforrásra gombra a Következő lépések csoportban.

    Képernyőkép az erőforrás üzembe helyezésének következő lépéseiről.

  2. Az erőforrás képernyőjén válassza a bal oldali navigációs menü Kulcsok és végpont elemét. Az alábbi lépésekben az egyik kulcsot és a végpontot fogja használni.

    Egy erőforrás kulcsait és végpontszakaszát bemutató képernyőkép.

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

Az alkalmazásnak hitelesítenie kell az API-kérések küldéséhez. Éles környezetben használjon biztonságos módot a hitelesítő adatok tárolására és elérésére. 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 nyelvi erőforráskulcs 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.

  1. A LANGUAGE_KEY környezeti változó beállításához cserélje le your-key az erőforrás egyik kulcsára.
  2. A LANGUAGE_ENDPOINT környezeti változó beállításához cserélje le your-endpoint az erőforrás végpontját.
setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

Feljegyzés

Ha csak az aktuális futó konzolon kell hozzáférnie a környezeti változókhoz, a környezeti változót set ahelyett setxállíthatja be.

A környezeti változók hozzáadása után előfordulhat, hogy újra kell indítania a futó programokat, amelyeknek be kell olvasniuk a környezeti változókat, beleértve a konzolablakot is. Ha például a Visual Studiót használja szerkesztőként, indítsa újra a Visual Studiót a példa futtatása előtt.

Telepítse az ügyfélkódtárat

A Python telepítése után az ügyfélkódtárat a következővel telepítheti:

pip install azure-ai-textanalytics==5.2.0

Mintakód

Hozzon létre egy új Python-fájlt, és másolja az alábbi kódot. Most futtassa a kódot.

# This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
language_key = os.environ.get('LANGUAGE_KEY')
language_endpoint = os.environ.get('LANGUAGE_ENDPOINT')

from azure.ai.textanalytics import TextAnalyticsClient
from azure.core.credentials import AzureKeyCredential

# Authenticate the client using your key and endpoint 
def authenticate_client():
    ta_credential = AzureKeyCredential(language_key)
    text_analytics_client = TextAnalyticsClient(
            endpoint=language_endpoint, 
            credential=ta_credential)
    return text_analytics_client

client = authenticate_client()

# Example method for detecting sensitive information (PII) from text 
def pii_recognition_example(client):
    documents = [
        "The employee's SSN is 859-98-0987.",
        "The employee's phone number is 555-555-5555."
    ]
    response = client.recognize_pii_entities(documents, language="en")
    result = [doc for doc in response if not doc.is_error]
    for doc in result:
        print("Redacted Text: {}".format(doc.redacted_text))
        for entity in doc.entities:
            print("Entity: {}".format(entity.text))
            print("\tCategory: {}".format(entity.category))
            print("\tConfidence Score: {}".format(entity.confidence_score))
            print("\tOffset: {}".format(entity.offset))
            print("\tLength: {}".format(entity.length))
pii_recognition_example(client)

Hozam

Redacted Text: The ********'s SSN is ***********.
Entity: employee
        Category: PersonType
        Confidence Score: 0.97
        Offset: 4
        Length: 8
Entity: 859-98-0987
        Category: USSocialSecurityNumber
        Confidence Score: 0.65
        Offset: 22
        Length: 11
Redacted Text: The ********'s phone number is ************.
Entity: employee
        Category: PersonType
        Confidence Score: 0.96
        Offset: 4
        Length: 8
Entity: 555-555-5555
        Category: PhoneNumber
        Confidence Score: 0.8
        Offset: 31
        Length: 12

Referenciadokumentáció

Ezzel a rövid útmutatóval személyes azonosításra alkalmas adatokat (PII) észlelési kéréseket küldhet a REST API használatával. Az alábbi példában a cURL használatával azonosítja a felismert bizalmas információkat a szövegben.

Előfeltételek

Beállítás

Azure-erőforrás létrehozása

Az alábbi kódminta használatához üzembe kell helyeznie egy Azure-erőforrást. Ez az erőforrás tartalmazni fog egy kulcsot és végpontot, a nyelvszolgáltatásnak küldött API-hívások hitelesítéséhez.

  1. Az alábbi hivatkozással nyelvi erőforrást hozhat létre az Azure Portal használatával. Az Azure-előfizetéssel kell bejelentkeznie.

  2. A megjelenő További funkciók kiválasztása képernyőn válassza a Folytatás lehetőséget az erőforrás létrehozásához.

    Képernyőkép az Azure Portal további funkcióiról.

  3. A Nyelv létrehozása képernyőn adja meg a következő információkat:

    Részlet Leírás
    Előfizetés Az az előfizetési fiók, amelyhez az erőforrás társítva lesz. Válassza ki az Azure-előfizetését a legördülő menüből.
    Erőforráscsoport Az erőforráscsoportok olyan tárolók, amelyek a létrehozott erőforrásokat tárolják. Új erőforráscsoport létrehozásához válassza az Új létrehozása lehetőséget.
    Régió A nyelvi erőforrás helye. A különböző régiók késést okozhatnak a fizikai helytől függően, de nincs hatással az erőforrás futásidejű rendelkezésre állására. Ebben a rövid útmutatóban válasszon ki egy Önhöz közeli elérhető régiót, vagy válassza az USA keleti régióját.
    Név A nyelvi erőforrás neve. Ez a név egy végponti URL-cím létrehozásához is használható, amelyet az alkalmazások API-kérések küldéséhez fognak használni.
    Tarifacsomag A nyelvi erőforrás tarifacsomagja . Az ingyenes F0 szinttel kipróbálhatja a szolgáltatást, és később frissíthet egy fizetős szintre éles környezetben.

    Képernyőkép az erőforrás-létrehozás részleteiről az Azure Portalon.

  4. Győződjön meg arról, hogy a Felelős AI-értesítés jelölőnégyzet be van jelölve.

  5. Válassza a Véleményezés + Létrehozás lehetőséget a lap alján.

  6. A megjelenő képernyőn győződjön meg arról, hogy az ellenőrzés sikeres volt, és helyesen adta meg az adatokat. Válassza a Létrehozás parancsot.

Kulcs és végpont lekérése

Ezután szüksége lesz az erőforrás kulcsára és végpontjára az alkalmazás API-hoz való csatlakoztatásához. A rövid útmutató későbbi részében illessze be a kulcsot és a végpontot a kódba.

  1. A nyelvi erőforrás sikeres üzembe helyezése után kattintson az Ugrás az erőforrásra gombra a Következő lépések csoportban.

    Képernyőkép az erőforrás üzembe helyezésének következő lépéseiről.

  2. Az erőforrás képernyőjén válassza a bal oldali navigációs menü Kulcsok és végpont elemét. Az alábbi lépésekben az egyik kulcsot és a végpontot fogja használni.

    Egy erőforrás kulcsait és végpontszakaszát bemutató képernyőkép.

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

Az alkalmazásnak hitelesítenie kell az API-kérések küldéséhez. Éles környezetben használjon biztonságos módot a hitelesítő adatok tárolására és elérésére. 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 nyelvi erőforráskulcs 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.

  1. A LANGUAGE_KEY környezeti változó beállításához cserélje le your-key az erőforrás egyik kulcsára.
  2. A LANGUAGE_ENDPOINT környezeti változó beállításához cserélje le your-endpoint az erőforrás végpontját.
setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

Feljegyzés

Ha csak az aktuális futó konzolon kell hozzáférnie a környezeti változókhoz, a környezeti változót set ahelyett setxállíthatja be.

A környezeti változók hozzáadása után előfordulhat, hogy újra kell indítania a futó programokat, amelyeknek be kell olvasniuk a környezeti változókat, beleértve a konzolablakot is. Ha például a Visual Studiót használja szerkesztőként, indítsa újra a Visual Studiót a példa futtatása előtt.

JSON-fájl létrehozása a példakérés törzsével

Hozzon létre egy új fájlt test_pii_payload.json egy kódszerkesztőben, és másolja a következő JSON-példát. Ezt a példakérést a rendszer a következő lépésben elküldi az API-nak.

{
    "kind": "PiiEntityRecognition",
    "parameters": {
        "modelVersion": "latest"
    },
    "analysisInput":{
        "documents":[
            {
                "id":"1",
                "language": "en",
                "text": "Call our office at 312-555-1234, or send an email to support@contoso.com"
            }
        ]
    }
}
'

Mentsen test_pii_payload.json valahol a számítógépen. Például az asztalra.

Személyazonosítási információ (PII) észlelési API-kérés küldése

Az alábbi parancsokkal küldje el az API-kérést a használt programmal. Másolja a parancsot a terminálba, és futtassa.

paraméter Leírás
-X POST <endpoint> Megadja a végpontot az API eléréséhez.
-H Content-Type: application/json A JSON-adatok küldéséhez használt tartalomtípus.
-H "Ocp-Apim-Subscription-Key:<key> Megadja az API eléréséhez szükséges kulcsot.
-d <documents> A elküldeni kívánt dokumentumokat tartalmazó JSON.

Cserélje le C:\Users\<myaccount>\Desktop\test_pii_payload.json az előző lépésben létrehozott példa JSON-kérelemfájl helyére.

Parancssor

curl -X POST "%LANGUAGE_ENDPOINT%/language/:analyze-text?api-version=2022-05-01" ^
-H "Content-Type: application/json" ^
-H "Ocp-Apim-Subscription-Key: %LANGUAGE_KEY%" ^
-d "@C:\Users\<myaccount>\Desktop\test_pii_payload.json"

PowerShell

curl.exe -X POST $env:LANGUAGE_ENDPOINT/language/:analyze-text?api-version=2022-05-01 `
-H "Content-Type: application/json" `
-H "Ocp-Apim-Subscription-Key: $env:LANGUAGE_KEY" `
-d "@C:\Users\<myaccount>\Desktop\test_pii_payload.json"

JSON-válasz

{
	"kind": "PiiEntityRecognitionResults",
	"results": {
		"documents": [{
			"redactedText": "Call our office at ************, or send an email to *******************",
			"id": "1",
			"entities": [{
				"text": "312-555-1234",
				"category": "PhoneNumber",
				"offset": 19,
				"length": 12,
				"confidenceScore": 0.8
			}, {
				"text": "support@contoso.com",
				"category": "Email",
				"offset": 53,
				"length": 19,
				"confidenceScore": 0.8
			}],
			"warnings": []
		}],
		"errors": [],
		"modelVersion": "2021-01-15"
	}
}

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