Rövid útmutató: Személyazonosításra alkalmas adatok észlelése (PII)
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
- Azure-előfizetés – Ingyenes létrehozás
- A Visual Studio IDE
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.
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.
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.
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. Győződjön meg arról, hogy a Felelős AI-értesítés jelölőnégyzet be van jelölve.
Válassza a Véleményezés + Létrehozás lehetőséget a lap alján.
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.
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.
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.
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.
- A
LANGUAGE_KEY
környezeti változó beállításához cserélje leyour-key
az erőforrás egyik kulcsára. - A
LANGUAGE_ENDPOINT
környezeti változó beállításához cserélje leyour-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
- Azure-előfizetés – Ingyenes létrehozás
- A Java fejlesztői készlet (JDK) 8-as vagy újabb verziója
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.
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.
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.
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. Győződjön meg arról, hogy a Felelős AI-értesítés jelölőnégyzet be van jelölve.
Válassza a Véleményezés + Létrehozás lehetőséget a lap alján.
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.
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.
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.
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.
- A
LANGUAGE_KEY
környezeti változó beállításához cserélje leyour-key
az erőforrás egyik kulcsára. - A
LANGUAGE_ENDPOINT
környezeti változó beállításához cserélje leyour-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
- Azure-előfizetés – Ingyenes létrehozás
- Node.js v14 LTS vagy újabb verzió
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.
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.
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.
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. Győződjön meg arról, hogy a Felelős AI-értesítés jelölőnégyzet be van jelölve.
Válassza a Véleményezés + Létrehozás lehetőséget a lap alján.
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.
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.
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.
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.
- A
LANGUAGE_KEY
környezeti változó beállításához cserélje leyour-key
az erőforrás egyik kulcsára. - A
LANGUAGE_ENDPOINT
környezeti változó beállításához cserélje leyour-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
- Azure-előfizetés – Ingyenes létrehozás
- Python 3.8 vagy újabb
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.
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.
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.
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. Győződjön meg arról, hogy a Felelős AI-értesítés jelölőnégyzet be van jelölve.
Válassza a Véleményezés + Létrehozás lehetőséget a lap alján.
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.
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.
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.
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.
- A
LANGUAGE_KEY
környezeti változó beállításához cserélje leyour-key
az erőforrás egyik kulcsára. - A
LANGUAGE_ENDPOINT
környezeti változó beállításához cserélje leyour-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
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
- Azure-előfizetés – Ingyenes létrehozás
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.
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.
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.
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. Győződjön meg arról, hogy a Felelős AI-értesítés jelölőnégyzet be van jelölve.
Válassza a Véleményezés + Létrehozás lehetőséget a lap alján.
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.
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.
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.
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.
- A
LANGUAGE_KEY
környezeti változó beállításához cserélje leyour-key
az erőforrás egyik kulcsára. - A
LANGUAGE_ENDPOINT
környezeti változó beállításához cserélje leyour-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.