Mulai Cepat: Mendeteksi Informasi Identifikasi Pribadi (PII)

Artikel
04/30/2024

Catatan

Mulai cepat ini hanya mencakup deteksi PII dalam dokumen. Untuk mempelajari selengkapnya tentang mendeteksi PII dalam percakapan, lihat Cara mendeteksi dan meredaksi PII dalam percakapan.

Dokumentasi | referensi Paket sampel | lainnya (NuGet) | Kode sumber pustaka

Gunakan mulai cepat ini untuk membuat aplikasi deteksi Informasi Pengidentifikasi Pribadi (PII) dengan pustaka klien untuk .NET. Dalam contoh berikut, Anda membuat aplikasi C# yang dapat mengidentifikasi informasi sensitif yang dikenali dalam teks.

Tip

Anda dapat menggunakan Language Studio untuk mencoba deteksi PII di dokumen tanpa perlu menulis kode.

Prasyarat

Langganan Azure - Buat langganan secara gratis
IDE Visual Studio

Menyiapkan

Membuat grup sumber daya Azure

Untuk menggunakan sampel kode di bawah ini, Anda harus menyebarkan sumber daya Azure. Sumber daya ini akan berisi kunci dan titik akhir yang akan Anda gunakan untuk mengautentikasi panggilan API yang Anda kirim ke layanan Bahasa.

Gunakan tautan berikut untuk membuat sumber daya bahasa menggunakan portal Azure. Anda harus masuk menggunakan langganan Azure Anda.
Pada layar Pilih fitur tambahan yang muncul, pilih Lanjutkan untuk membuat sumber daya Anda.

Di layar Buat bahasa, berikan informasi berikut ini:

Detail	Deskripsi
Langganan	Akun langganan yang akan dikaitkan dengan sumber daya Anda. Pilih langganan Azure Anda dari menu drop-down.
Grup sumber daya	Grup sumber daya adalah kontainer yang menyimpan sumber daya yang Anda buat. Pilih Buat baru untuk membuat grup sumber daya baru.
Wilayah	Lokasi sumber daya Bahasa Anda. Wilayah yang berbeda dapat memperkenalkan latensi tergantung pada lokasi fisik Anda, tetapi tidak berdampak pada ketersediaan runtime sumber daya Anda. Untuk mulai cepat ini, pilih wilayah yang tersedia di dekat Anda, atau pilih US Timur.
Nama	Nama untuk sumber daya Bahasa Anda. Nama ini juga akan digunakan untuk membuat URL titik akhir yang akan digunakan aplikasi Anda untuk mengirim permintaan API.
Tingkatan harga	Tingkat harga untuk sumber daya Bahasa Anda. Anda dapat menggunakan tingkat F0 Gratis untuk mencoba layanan dan meningkatkannya nanti ke tingkat berbayar untuk produksi.

Pastikan kotak centang Pemberitahuan AI Bertanggung Jawab dicentang.
Pilih Tinjau + Buat di bagian bawah halaman.
Di layar yang muncul, pastikan validasi telah berlalu, dan Anda memasukkan informasi dengan benar. Lalu pilih Buat.

Dapatkan kunci dan titik akhir Anda

Selanjutnya Anda akan memerlukan kunci dan titik akhir dari sumber daya untuk menghubungkan aplikasi Anda ke API. Anda akan menempelkan kunci dan titik akhir Anda ke dalam kode di mulai cepat nanti.

Setelah sumber daya Bahasa berhasil disebarkan, klik tombol Buka Sumber Daya di bawah Langkah Berikutnya.
Pada layar untuk sumber daya Anda, pilih Kunci dan titik akhir di menu navigasi kiri. Anda akan menggunakan salah satu kunci dan titik akhir Anda dalam langkah-langkah di bawah ini.

Membuat variabel lingkungan

Aplikasi Anda harus diautentikasi untuk mengirim permintaan API. Untuk produksi, gunakan cara yang aman dalam menyimpan dan mengakses info masuk Anda. Dalam contoh ini, Anda akan menulis kredensial Anda ke variabel lingkungan pada komputer lokal yang menjalankan aplikasi.

Tip

Jangan sertakan kunci langsung dalam kode Anda, dan jangan pernah mempostingnya secara publik. Lihat artikel keamanan layanan Azure AI untuk opsi autentikasi lainnya seperti Azure Key Vault.

Untuk mengatur variabel lingkungan untuk kunci sumber daya Bahasa Anda, buka jendela konsol, dan ikuti instruksi untuk sistem operasi dan lingkungan pengembangan Anda.

Untuk mengatur LANGUAGE_KEY variabel lingkungan, ganti your-key dengan salah satu kunci untuk sumber daya Anda.
Untuk mengatur LANGUAGE_ENDPOINT variabel lingkungan, ganti your-endpoint dengan titik akhir untuk sumber daya Anda.

setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

Catatan

Jika Anda hanya perlu mengakses variabel lingkungan di konsol yang sedang berjalan saat ini, Anda dapat mengatur variabel lingkungan dengan set alih-alih setx.

Setelah menambahkan variabel lingkungan, Anda mungkin perlu memulai ulang program yang sedang berjalan yang perlu membaca variabel lingkungan, termasuk jendela konsol. Misalnya, jika Anda menggunakan Visual Studio sebagai editor, hidupkan ulang Visual Studio sebelum menjalankan contoh.

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Setelah Anda menambahkan variabel lingkungan, jalankan source ~/.bashrc dari jendela konsol Anda untuk membuat perubahan efektif.

Bash

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Setelah Anda menambahkan variabel lingkungan, jalankan source ~/.bash_profile dari jendela konsol Anda untuk membuat perubahan efektif.

Xcode

Untuk pengembangan iOS dan macOS, Anda mengatur variabel lingkungan di Xcode. Misalnya, ikuti langkah-langkah ini untuk mengatur variabel lingkungan di Xcode 13.4.1.

Pilih skema Edit SkemaProduk>>
Pilih Argumen pada halaman Jalankan (Eksekusi Debug)
Di bawah Variabel Lingkungan pilih tanda plus (+) untuk menambahkan variabel lingkungan baru.
Masukkan LANGUAGE_KEY untuk Nama dan masukkan kunci sumber daya Bahasa Anda untuk Nilai.
Lakukan langkah-langkah ini untuk titik akhir sumber daya Anda. Beri nama variabel LANGUAGE_ENDPOINTlingkungan baru .

Untuk opsi konfigurasi lainnya, lihat dokumentasi Xcode.

Buat aplikasi .NET Core baru

Menggunakan Ide Visual Studio, buat aplikasi konsol .NET Core baru. Ini membuat proyek "Halo Dunia" dengan satu file sumber C#: program.cs.

Pasang pustaka klien dengan mengeklik kanan solusi proyek di Penjelajah Solusi, lalu pilih Kelola Paket NuGet. Di manajer paket yang terbuka pilih Telusuri dan cari Azure.AI.TextAnalytics. Pilih versi 5.2.0, lalu Pasang. Anda juga dapat menggunakan Package Manager Console.

Contoh kode

Salin kode berikut ke file program.cs Anda dan jalankan kode.

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();
        }

    }
}

Output

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

Dokumentasi | referensi Paket sampel | lainnya (Maven) | Kode sumber pustaka

Gunakan mulai cepat ini untuk membuat aplikasi deteksi Informasi Pengidentifikasi Pribadi (PII) dengan pustaka klien untuk Java. Dalam contoh berikut, Anda membuat aplikasi Java yang dapat mengidentifikasi informasi sensitif yang dikenali dalam teks.

Tip

Anda dapat menggunakan Language Studio untuk mencoba deteksi PII di dokumen tanpa perlu menulis kode.

Prasyarat

Langganan Azure - Buat langganan secara gratis
Java Development Kit (JDK) versi 8 atau lebih tinggi

Menyiapkan

Membuat grup sumber daya Azure

Gunakan tautan berikut untuk membuat sumber daya bahasa menggunakan portal Azure. Anda harus masuk menggunakan langganan Azure Anda.
Pada layar Pilih fitur tambahan yang muncul, pilih Lanjutkan untuk membuat sumber daya Anda.

Di layar Buat bahasa, berikan informasi berikut ini:

Detail	Deskripsi
Langganan	Akun langganan yang akan dikaitkan dengan sumber daya Anda. Pilih langganan Azure Anda dari menu drop-down.
Grup sumber daya	Grup sumber daya adalah kontainer yang menyimpan sumber daya yang Anda buat. Pilih Buat baru untuk membuat grup sumber daya baru.
Wilayah	Lokasi sumber daya Bahasa Anda. Wilayah yang berbeda dapat memperkenalkan latensi tergantung pada lokasi fisik Anda, tetapi tidak berdampak pada ketersediaan runtime sumber daya Anda. Untuk mulai cepat ini, pilih wilayah yang tersedia di dekat Anda, atau pilih US Timur.
Nama	Nama untuk sumber daya Bahasa Anda. Nama ini juga akan digunakan untuk membuat URL titik akhir yang akan digunakan aplikasi Anda untuk mengirim permintaan API.
Tingkatan harga	Tingkat harga untuk sumber daya Bahasa Anda. Anda dapat menggunakan tingkat F0 Gratis untuk mencoba layanan dan meningkatkannya nanti ke tingkat berbayar untuk produksi.

Pastikan kotak centang Pemberitahuan AI Bertanggung Jawab dicentang.
Pilih Tinjau + Buat di bagian bawah halaman.
Di layar yang muncul, pastikan validasi telah berlalu, dan Anda memasukkan informasi dengan benar. Lalu pilih Buat.

Dapatkan kunci dan titik akhir Anda

Selanjutnya Anda akan memerlukan kunci dan titik akhir dari sumber daya untuk menghubungkan aplikasi Anda ke API. Anda akan menempelkan kunci dan titik akhir Anda ke dalam kode di mulai cepat nanti.

Setelah sumber daya Bahasa berhasil disebarkan, klik tombol Buka Sumber Daya di bawah Langkah Berikutnya.
Pada layar untuk sumber daya Anda, pilih Kunci dan titik akhir di menu navigasi kiri. Anda akan menggunakan salah satu kunci dan titik akhir Anda dalam langkah-langkah di bawah ini.

Membuat variabel lingkungan

Tip

Jangan sertakan kunci langsung dalam kode Anda, dan jangan pernah mempostingnya secara publik. Lihat artikel keamanan layanan Azure AI untuk opsi autentikasi lainnya seperti Azure Key Vault.

Untuk mengatur variabel lingkungan untuk kunci sumber daya Bahasa Anda, buka jendela konsol, dan ikuti instruksi untuk sistem operasi dan lingkungan pengembangan Anda.

Untuk mengatur LANGUAGE_KEY variabel lingkungan, ganti your-key dengan salah satu kunci untuk sumber daya Anda.
Untuk mengatur LANGUAGE_ENDPOINT variabel lingkungan, ganti your-endpoint dengan titik akhir untuk sumber daya Anda.

setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

Catatan

Jika Anda hanya perlu mengakses variabel lingkungan di konsol yang sedang berjalan saat ini, Anda dapat mengatur variabel lingkungan dengan set alih-alih setx.

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Setelah Anda menambahkan variabel lingkungan, jalankan source ~/.bashrc dari jendela konsol Anda untuk membuat perubahan efektif.

Bash

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Setelah Anda menambahkan variabel lingkungan, jalankan source ~/.bash_profile dari jendela konsol Anda untuk membuat perubahan efektif.

Xcode

Untuk pengembangan iOS dan macOS, Anda mengatur variabel lingkungan di Xcode. Misalnya, ikuti langkah-langkah ini untuk mengatur variabel lingkungan di Xcode 13.4.1.

Pilih skema Edit SkemaProduk>>
Pilih Argumen pada halaman Jalankan (Eksekusi Debug)
Di bawah Variabel Lingkungan pilih tanda plus (+) untuk menambahkan variabel lingkungan baru.
Masukkan LANGUAGE_KEY untuk Nama dan masukkan kunci sumber daya Bahasa Anda untuk Nilai.
Lakukan langkah-langkah ini untuk titik akhir sumber daya Anda. Beri nama variabel LANGUAGE_ENDPOINTlingkungan baru .

Untuk opsi konfigurasi lainnya, lihat dokumentasi Xcode.

Tambahkan pustaka klien

Buat proyek Maven di IDE atau lingkungan pengembangan pilihan Anda. Kemudian, tambahkan dependensi berikut ke file pom.xml proyek Anda. Anda dapat menemukan sintaks implementasi untuk alat build online lainnya.

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

Contoh kode

Buat file Java bernama Example.java. Buka file dan salin kode di bawah ini. Kemudian jalankan kode.

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()));
    }
}

Output

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

Dokumentasi | referensi Paket sampel | lainnya (npm) | Kode sumber pustaka

Gunakan mulai cepat ini untuk membuat aplikasi deteksi Informasi Pengidentifikasi Pribadi (PII) dengan pustaka klien untuk Node.js. Dalam contoh berikut, Anda membuat aplikasi JavaScript yang dapat mengidentifikasi informasi sensitif yang dikenali dalam teks.

Prasyarat

Langganan Azure - Buat langganan secara gratis
Node.js v14 LTS atau yang lebih baru

Menyiapkan

Membuat grup sumber daya Azure

Gunakan tautan berikut untuk membuat sumber daya bahasa menggunakan portal Azure. Anda harus masuk menggunakan langganan Azure Anda.
Pada layar Pilih fitur tambahan yang muncul, pilih Lanjutkan untuk membuat sumber daya Anda.

Di layar Buat bahasa, berikan informasi berikut ini:

Detail	Deskripsi
Langganan	Akun langganan yang akan dikaitkan dengan sumber daya Anda. Pilih langganan Azure Anda dari menu drop-down.
Grup sumber daya	Grup sumber daya adalah kontainer yang menyimpan sumber daya yang Anda buat. Pilih Buat baru untuk membuat grup sumber daya baru.
Wilayah	Lokasi sumber daya Bahasa Anda. Wilayah yang berbeda dapat memperkenalkan latensi tergantung pada lokasi fisik Anda, tetapi tidak berdampak pada ketersediaan runtime sumber daya Anda. Untuk mulai cepat ini, pilih wilayah yang tersedia di dekat Anda, atau pilih US Timur.
Nama	Nama untuk sumber daya Bahasa Anda. Nama ini juga akan digunakan untuk membuat URL titik akhir yang akan digunakan aplikasi Anda untuk mengirim permintaan API.
Tingkatan harga	Tingkat harga untuk sumber daya Bahasa Anda. Anda dapat menggunakan tingkat F0 Gratis untuk mencoba layanan dan meningkatkannya nanti ke tingkat berbayar untuk produksi.

Pastikan kotak centang Pemberitahuan AI Bertanggung Jawab dicentang.
Pilih Tinjau + Buat di bagian bawah halaman.
Di layar yang muncul, pastikan validasi telah berlalu, dan Anda memasukkan informasi dengan benar. Lalu pilih Buat.

Dapatkan kunci dan titik akhir Anda

Selanjutnya Anda akan memerlukan kunci dan titik akhir dari sumber daya untuk menghubungkan aplikasi Anda ke API. Anda akan menempelkan kunci dan titik akhir Anda ke dalam kode di mulai cepat nanti.

Setelah sumber daya Bahasa berhasil disebarkan, klik tombol Buka Sumber Daya di bawah Langkah Berikutnya.
Pada layar untuk sumber daya Anda, pilih Kunci dan titik akhir di menu navigasi kiri. Anda akan menggunakan salah satu kunci dan titik akhir Anda dalam langkah-langkah di bawah ini.

Membuat variabel lingkungan

Tip

Jangan sertakan kunci langsung dalam kode Anda, dan jangan pernah mempostingnya secara publik. Lihat artikel keamanan layanan Azure AI untuk opsi autentikasi lainnya seperti Azure Key Vault.

Untuk mengatur variabel lingkungan untuk kunci sumber daya Bahasa Anda, buka jendela konsol, dan ikuti instruksi untuk sistem operasi dan lingkungan pengembangan Anda.

Untuk mengatur LANGUAGE_KEY variabel lingkungan, ganti your-key dengan salah satu kunci untuk sumber daya Anda.
Untuk mengatur LANGUAGE_ENDPOINT variabel lingkungan, ganti your-endpoint dengan titik akhir untuk sumber daya Anda.

setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

Catatan

Jika Anda hanya perlu mengakses variabel lingkungan di konsol yang sedang berjalan saat ini, Anda dapat mengatur variabel lingkungan dengan set alih-alih setx.

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Setelah Anda menambahkan variabel lingkungan, jalankan source ~/.bashrc dari jendela konsol Anda untuk membuat perubahan efektif.

Bash

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Setelah Anda menambahkan variabel lingkungan, jalankan source ~/.bash_profile dari jendela konsol Anda untuk membuat perubahan efektif.

Xcode

Untuk pengembangan iOS dan macOS, Anda mengatur variabel lingkungan di Xcode. Misalnya, ikuti langkah-langkah ini untuk mengatur variabel lingkungan di Xcode 13.4.1.

Pilih skema Edit SkemaProduk>>
Pilih Argumen pada halaman Jalankan (Eksekusi Debug)
Di bawah Variabel Lingkungan pilih tanda plus (+) untuk menambahkan variabel lingkungan baru.
Masukkan LANGUAGE_KEY untuk Nama dan masukkan kunci sumber daya Bahasa Anda untuk Nilai.
Lakukan langkah-langkah ini untuk titik akhir sumber daya Anda. Beri nama variabel LANGUAGE_ENDPOINTlingkungan baru .

Untuk opsi konfigurasi lainnya, lihat dokumentasi Xcode.

Membuat aplikasi Node.js baru

Di jendela konsol (seperti cmd, PowerShell, atau Bash), buat direktori baru untuk aplikasi Anda, dan buka direktori tersebut.

mkdir myapp 

cd myapp

Jalankan perintah npm init untuk membuat aplikasi node dengan file package.json.

npm init

Memasang pustaka klien

Instal paket npm:

npm install @azure/ai-text-analytics

Contoh kode

Buka file dan salin kode di bawah ini. Kemudian jalankan kode.

"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);
});

Output

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

Dokumentasi | referensi Paket sampel | lainnya (PyPi) | Kode sumber pustaka

Gunakan mulai cepat ini untuk membuat aplikasi deteksi Informasi Pengidentifikasi Pribadi (PII) dengan pustaka klien untuk Python. Dalam contoh berikut, Anda akan membuat aplikasi Python yang dapat mengidentifikasi informasi sensitif yang dikenali dalam teks.

Prasyarat

Langganan Azure - Buat langganan secara gratis
Python 3.8 atau yang lebih baru

Menyiapkan

Membuat grup sumber daya Azure

Gunakan tautan berikut untuk membuat sumber daya bahasa menggunakan portal Azure. Anda harus masuk menggunakan langganan Azure Anda.
Pada layar Pilih fitur tambahan yang muncul, pilih Lanjutkan untuk membuat sumber daya Anda.

Di layar Buat bahasa, berikan informasi berikut ini:

Detail	Deskripsi
Langganan	Akun langganan yang akan dikaitkan dengan sumber daya Anda. Pilih langganan Azure Anda dari menu drop-down.
Grup sumber daya	Grup sumber daya adalah kontainer yang menyimpan sumber daya yang Anda buat. Pilih Buat baru untuk membuat grup sumber daya baru.
Wilayah	Lokasi sumber daya Bahasa Anda. Wilayah yang berbeda dapat memperkenalkan latensi tergantung pada lokasi fisik Anda, tetapi tidak berdampak pada ketersediaan runtime sumber daya Anda. Untuk mulai cepat ini, pilih wilayah yang tersedia di dekat Anda, atau pilih US Timur.
Nama	Nama untuk sumber daya Bahasa Anda. Nama ini juga akan digunakan untuk membuat URL titik akhir yang akan digunakan aplikasi Anda untuk mengirim permintaan API.
Tingkatan harga	Tingkat harga untuk sumber daya Bahasa Anda. Anda dapat menggunakan tingkat F0 Gratis untuk mencoba layanan dan meningkatkannya nanti ke tingkat berbayar untuk produksi.

Pastikan kotak centang Pemberitahuan AI Bertanggung Jawab dicentang.
Pilih Tinjau + Buat di bagian bawah halaman.
Di layar yang muncul, pastikan validasi telah berlalu, dan Anda memasukkan informasi dengan benar. Lalu pilih Buat.

Dapatkan kunci dan titik akhir Anda

Selanjutnya Anda akan memerlukan kunci dan titik akhir dari sumber daya untuk menghubungkan aplikasi Anda ke API. Anda akan menempelkan kunci dan titik akhir Anda ke dalam kode di mulai cepat nanti.

Setelah sumber daya Bahasa berhasil disebarkan, klik tombol Buka Sumber Daya di bawah Langkah Berikutnya.
Pada layar untuk sumber daya Anda, pilih Kunci dan titik akhir di menu navigasi kiri. Anda akan menggunakan salah satu kunci dan titik akhir Anda dalam langkah-langkah di bawah ini.

Membuat variabel lingkungan

Tip

Jangan sertakan kunci langsung dalam kode Anda, dan jangan pernah mempostingnya secara publik. Lihat artikel keamanan layanan Azure AI untuk opsi autentikasi lainnya seperti Azure Key Vault.

Untuk mengatur variabel lingkungan untuk kunci sumber daya Bahasa Anda, buka jendela konsol, dan ikuti instruksi untuk sistem operasi dan lingkungan pengembangan Anda.

Untuk mengatur LANGUAGE_KEY variabel lingkungan, ganti your-key dengan salah satu kunci untuk sumber daya Anda.
Untuk mengatur LANGUAGE_ENDPOINT variabel lingkungan, ganti your-endpoint dengan titik akhir untuk sumber daya Anda.

setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

Catatan

Jika Anda hanya perlu mengakses variabel lingkungan di konsol yang sedang berjalan saat ini, Anda dapat mengatur variabel lingkungan dengan set alih-alih setx.

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Setelah Anda menambahkan variabel lingkungan, jalankan source ~/.bashrc dari jendela konsol Anda untuk membuat perubahan efektif.

Bash

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Setelah Anda menambahkan variabel lingkungan, jalankan source ~/.bash_profile dari jendela konsol Anda untuk membuat perubahan efektif.

Xcode

Untuk pengembangan iOS dan macOS, Anda mengatur variabel lingkungan di Xcode. Misalnya, ikuti langkah-langkah ini untuk mengatur variabel lingkungan di Xcode 13.4.1.

Pilih skema Edit SkemaProduk>>
Pilih Argumen pada halaman Jalankan (Eksekusi Debug)
Di bawah Variabel Lingkungan pilih tanda plus (+) untuk menambahkan variabel lingkungan baru.
Masukkan LANGUAGE_KEY untuk Nama dan masukkan kunci sumber daya Bahasa Anda untuk Nilai.
Lakukan langkah-langkah ini untuk titik akhir sumber daya Anda. Beri nama variabel LANGUAGE_ENDPOINTlingkungan baru .

Untuk opsi konfigurasi lainnya, lihat dokumentasi Xcode.

Memasang pustaka klien

Setelah memasang Python, Anda dapat memasang pustaka klien dengan:

pip install azure-ai-textanalytics==5.2.0

Contoh kode

Buat file Python baru dan salin kode di bawah ini. Kemudian jalankan kode.

# 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)

Output

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

Dokumentasi rujukan

Gunakan mulai cepat ini untuk mengirim permintaan deteksi Informasi Pengidentifikasi Pribadi (PII) menggunakan REST API. Dalam contoh berikut, Anda akan menggunakan cURL untuk mengidentifikasi informasi sensitif yang dikenali dalam teks.

Prasyarat

Langganan Azure - Buat langganan secara gratis

Menyiapkan

Membuat grup sumber daya Azure

Gunakan tautan berikut untuk membuat sumber daya bahasa menggunakan portal Azure. Anda harus masuk menggunakan langganan Azure Anda.
Pada layar Pilih fitur tambahan yang muncul, pilih Lanjutkan untuk membuat sumber daya Anda.

Di layar Buat bahasa, berikan informasi berikut ini:

Detail	Deskripsi
Langganan	Akun langganan yang akan dikaitkan dengan sumber daya Anda. Pilih langganan Azure Anda dari menu drop-down.
Grup sumber daya	Grup sumber daya adalah kontainer yang menyimpan sumber daya yang Anda buat. Pilih Buat baru untuk membuat grup sumber daya baru.
Wilayah	Lokasi sumber daya Bahasa Anda. Wilayah yang berbeda dapat memperkenalkan latensi tergantung pada lokasi fisik Anda, tetapi tidak berdampak pada ketersediaan runtime sumber daya Anda. Untuk mulai cepat ini, pilih wilayah yang tersedia di dekat Anda, atau pilih US Timur.
Nama	Nama untuk sumber daya Bahasa Anda. Nama ini juga akan digunakan untuk membuat URL titik akhir yang akan digunakan aplikasi Anda untuk mengirim permintaan API.
Tingkatan harga	Tingkat harga untuk sumber daya Bahasa Anda. Anda dapat menggunakan tingkat F0 Gratis untuk mencoba layanan dan meningkatkannya nanti ke tingkat berbayar untuk produksi.

Pastikan kotak centang Pemberitahuan AI Bertanggung Jawab dicentang.
Pilih Tinjau + Buat di bagian bawah halaman.
Di layar yang muncul, pastikan validasi telah berlalu, dan Anda memasukkan informasi dengan benar. Lalu pilih Buat.

Dapatkan kunci dan titik akhir Anda

Selanjutnya Anda akan memerlukan kunci dan titik akhir dari sumber daya untuk menghubungkan aplikasi Anda ke API. Anda akan menempelkan kunci dan titik akhir Anda ke dalam kode di mulai cepat nanti.

Setelah sumber daya Bahasa berhasil disebarkan, klik tombol Buka Sumber Daya di bawah Langkah Berikutnya.
Pada layar untuk sumber daya Anda, pilih Kunci dan titik akhir di menu navigasi kiri. Anda akan menggunakan salah satu kunci dan titik akhir Anda dalam langkah-langkah di bawah ini.

Membuat variabel lingkungan

Tip

Jangan sertakan kunci langsung dalam kode Anda, dan jangan pernah mempostingnya secara publik. Lihat artikel keamanan layanan Azure AI untuk opsi autentikasi lainnya seperti Azure Key Vault.

Untuk mengatur variabel lingkungan untuk kunci sumber daya Bahasa Anda, buka jendela konsol, dan ikuti instruksi untuk sistem operasi dan lingkungan pengembangan Anda.

Untuk mengatur LANGUAGE_KEY variabel lingkungan, ganti your-key dengan salah satu kunci untuk sumber daya Anda.
Untuk mengatur LANGUAGE_ENDPOINT variabel lingkungan, ganti your-endpoint dengan titik akhir untuk sumber daya Anda.

setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

Catatan

Jika Anda hanya perlu mengakses variabel lingkungan di konsol yang sedang berjalan saat ini, Anda dapat mengatur variabel lingkungan dengan set alih-alih setx.

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Setelah Anda menambahkan variabel lingkungan, jalankan source ~/.bashrc dari jendela konsol Anda untuk membuat perubahan efektif.

Bash

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Setelah Anda menambahkan variabel lingkungan, jalankan source ~/.bash_profile dari jendela konsol Anda untuk membuat perubahan efektif.

Xcode

Untuk pengembangan iOS dan macOS, Anda mengatur variabel lingkungan di Xcode. Misalnya, ikuti langkah-langkah ini untuk mengatur variabel lingkungan di Xcode 13.4.1.

Pilih skema Edit SkemaProduk>>
Pilih Argumen pada halaman Jalankan (Eksekusi Debug)
Di bawah Variabel Lingkungan pilih tanda plus (+) untuk menambahkan variabel lingkungan baru.
Masukkan LANGUAGE_KEY untuk Nama dan masukkan kunci sumber daya Bahasa Anda untuk Nilai.
Lakukan langkah-langkah ini untuk titik akhir sumber daya Anda. Beri nama variabel LANGUAGE_ENDPOINTlingkungan baru .

Untuk opsi konfigurasi lainnya, lihat dokumentasi Xcode.

Membuat file JSON dengan contoh isi permintaan

Di editor kode, buat file baru bernama test_pii_payload.json dan salin contoh JSON berikut. Contoh permintaan ini akan dikirim ke API pada langkah berikutnya.

{
    "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"
            }
        ]
    }
}
'

Simpan test_pii_payload.json di suatu tempat di komputer Anda. Misalnya, desktop Anda.

Mengirim permintaan API deteksi informasi identifikasi pribadi (PII)

Gunakan perintah berikut untuk mengirim permintaan API menggunakan program yang Anda gunakan. Salin perintah ke terminal Anda, dan jalankan.

parameter	Deskripsi
`-X POST <endpoint>`	Menentukan titik akhir Anda untuk mengakses API.
`-H Content-Type: application/json`	Jenis konten untuk mengirim data JSON.
`-H "Ocp-Apim-Subscription-Key:<key>`	Menentukan kunci untuk mengakses API.
`-d <documents>`	JSON berisi dokumen yang ingin Anda kirim.

Ganti C:\Users\<myaccount>\Desktop\test_pii_payload.json dengan lokasi contoh file permintaan JSON yang Anda buat di langkah sebelumnya.

Perintah

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"

Gunakan perintah berikut untuk mengirim permintaan API menggunakan program yang Anda gunakan. Ganti /home/mydir/test_sentiment_payload.json dengan lokasi contoh file permintaan JSON yang Anda buat di langkah sebelumnya.

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 "@/home/mydir/test_pii_payload.json"

Gunakan perintah berikut untuk mengirim permintaan API menggunakan program yang Anda gunakan. Ganti /home/mydir/test_pii_payload.json dengan lokasi contoh file permintaan JSON yang Anda buat di langkah sebelumnya.

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 "@/home/mydir/test_pii_payload.json"

Respons JSON

{
	"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"
	}
}

Membersihkan sumber daya

Jika Anda ingin membersihkan dan menghapus langganan layanan Azure AI, Anda dapat menghapus sumber daya atau grup sumber daya. Menghapus grup sumber daya juga menghapus sumber daya apa pun yang terkait dengannya.

Langkah berikutnya

Ringkasan

Mulai Cepat: Mendeteksi Informasi Identifikasi Pribadi (PII)

Prasyarat

Menyiapkan

Membuat grup sumber daya Azure

Dapatkan kunci dan titik akhir Anda

Membuat variabel lingkungan

Buat aplikasi .NET Core baru

Contoh kode

Output

Prasyarat

Menyiapkan

Membuat grup sumber daya Azure

Dapatkan kunci dan titik akhir Anda

Membuat variabel lingkungan

Tambahkan pustaka klien

Contoh kode

Output

Prasyarat

Menyiapkan

Membuat grup sumber daya Azure

Dapatkan kunci dan titik akhir Anda

Membuat variabel lingkungan

Membuat aplikasi Node.js baru

Memasang pustaka klien

Contoh kode

Output

Prasyarat

Menyiapkan

Membuat grup sumber daya Azure

Dapatkan kunci dan titik akhir Anda

Membuat variabel lingkungan

Memasang pustaka klien

Contoh kode

Output

Prasyarat

Menyiapkan

Membuat grup sumber daya Azure

Dapatkan kunci dan titik akhir Anda

Membuat variabel lingkungan

Membuat file JSON dengan contoh isi permintaan

Mengirim permintaan API deteksi informasi identifikasi pribadi (PII)

Perintah

PowerShell

Respons JSON

Membersihkan sumber daya

Langkah berikutnya

Sumber Daya Tambahan: