Mulai Cepat: menggunakan pustaka klien Ekstraksi Frasa Kunci dan REST API

Artikel
07/18/2022
10 menit untuk membaca

Dokumentasi referensi | Sampel tambahan | Paket (NuGet) | Kode sumber pustaka

Gunakan mulai cepat ini untuk membuat aplikasi ekstraksi frasa kunci dengan pustaka klien untuk .NET. Dalam contoh berikut, Anda akan membuat aplikasi C# yang dapat mengidentifikasi frasa dan kata kunci yang ditemukan dalam teks.

Prasyarat

Langganan Azure - Buat langganan secara gratis
IDE Visual Studio
Setelah Anda memiliki langganan Azure, buat sumber daya Bahasa di portal Azure untuk mendapatkan kunci dan titik akhir Anda. Setelah disebarkan, klik Buka sumber daya.
- Anda akan memerlukan kunci dan titik akhir dari referensi yang Anda buat untuk menyambungkan aplikasi Anda ke API. Anda akan menempelkan kunci dan titik akhir ke dalam kode di bawah ini nanti di mulai cepat.
- Anda dapat menggunakan tingkat harga gratis (Free F0) untuk mencoba layanan, lalu meningkatkannya ke tingkat berbayar untuk produksi.
Untuk menggunakan fitur Analisis, Anda memerlukan sumber daya Bahasa dengan tingkat harga standar (S).

Saya mengalami masalah

Persiapan

Buat aplikasi .NET Core baru

Menggunakan Ide Visual Studio, buat aplikasi konsol .NET Core baru. Ini akan 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.1.1, lalu Pasang. Anda juga dapat menggunakan Package Manager Console.

Saya mengalami masalah

Contoh kode

Salin kode berikut ke dalam file program.cs Anda. Jangan lupa untuk mengganti variabel key dengan kunci untuk referensi Anda dan ganti variabel endpoint dengan titik akhir untuk referensi Anda.

Penting

Pergi ke portal Microsoft Azure. Jika sumber daya bahasa yang Anda buat di bagian Prasyarat berhasil disebarkan, klik tombol Buka Referensi di bawah Langkah Berikutnya. Anda dapat menemukan kunci dan titik akhir dengan membuka halaman Kunci dan Titik Akhir sumber daya, di bagian Manajemen Sumber Daya.

Ingatlah untuk menghapus kunci dari kode Anda setelah selesai, dan jangan pernah memposting kode secara publik. Untuk produksi, pertimbangkan untuk menggunakan cara menyimpan dan mengakses info masuk Anda dengan aman. Misalnya, Brankas kunci Azure.

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

namespace KeyPhraseExtractionExample
{
    class Program
    {
        private static readonly AzureKeyCredential credentials = new AzureKeyCredential("replace-with-your-key-here");
        private static readonly Uri endpoint = new Uri("replace-with-your-endpoint-here");

        // Example method for extracting key phrases from text
        static void KeyPhraseExtractionExample(TextAnalyticsClient client)
        {
            var response = client.ExtractKeyPhrases(@"Dr. Smith has a very modern medical office, and she has great staff.");

            // Printing key phrases
            Console.WriteLine("Key phrases:");

            foreach (string keyphrase in response.Value)
            {
                Console.WriteLine($"\t{keyphrase}");
            }
        }

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

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

    }
}

Saya mengalami masalah

Output

Key phrases:
    modern medical office
    Dr. Smith
    great staff

Dokumentasi referensi | Sampel tambahan | Paket (Maven) | Kode sumber pustaka

Gunakan mulai cepat ini untuk membuat aplikasi ekstraksi frasa kunci dengan pustaka klien untuk Java. Dalam contoh berikut, Anda akan membuat aplikasi Java yang dapat mengidentifikasi frasa dan kata kunci yang ditemukan dalam teks.

Prasyarat

Langganan Azure - Buat langganan secara gratis
Java Development Kit (JDK) versi 8 atau lebih tinggi
Setelah Anda memiliki langganan Azure, buat sumber daya Bahasa di portal Azure untuk mendapatkan kunci dan titik akhir Anda. Setelah disebarkan, klik Buka sumber daya.
- Anda akan memerlukan kunci dan titik akhir dari referensi yang Anda buat untuk menyambungkan aplikasi Anda ke API. Anda akan menempelkan kunci dan titik akhir ke dalam kode di bawah ini nanti di mulai cepat.
- Anda dapat menggunakan tingkat harga gratis (Free F0) untuk mencoba layanan, lalu meningkatkannya ke tingkat berbayar untuk produksi.
Untuk menggunakan fitur Analisis, Anda memerlukan sumber daya Bahasa dengan tingkat harga standar (S).

Saya mengalami masalah

Persiapan

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.1.10</version>
    </dependency>
</dependencies>

Saya mengalami masalah

Contoh kode

Buat file Java bernama Example.java. Buka file dan salin kode di bawah ini. Jangan lupa untuk mengganti variabel key dengan kunci untuk referensi Anda dan ganti variabel endpoint dengan titik akhir untuk referensi Anda.

Penting

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


public class Example {

    private static String KEY = "replace-with-your-key-here";
    private static String ENDPOINT = "replace-with-your-endpoint-here";

    public static void main(String[] args) {
        TextAnalyticsClient client = authenticateClient(KEY, ENDPOINT);
        extractKeyPhrasesExample(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 extracting key phrases from text
    static void extractKeyPhrasesExample(TextAnalyticsClient client)
    {
        // The text to be analyzed
        String text = "Dr. Smith has a very modern medical office, and she has great staff.";

        System.out.printf("Recognized phrases: %n");
        for (String keyPhrase : client.extractKeyPhrases(text)) {
            System.out.printf("%s%n", keyPhrase);
        }
    }
}

Saya mengalami masalah

Output

Recognized phrases: 

modern medical office
Dr. Smith
great staff

Dokumentasi referensi | Sampel tambahan | Paket (npm) | Kode sumber pustaka

Gunakan mulai cepat ini untuk membuat aplikasi ekstraksi frasa kunci dengan pustaka klien untuk Node.js. Dalam contoh berikut, Anda akan membuat aplikasi JavaScript yang dapat mengidentifikasi frasa dan kata kunci yang ditemukan dalam teks.

Prasyarat

Langganan Azure - Buat langganan secara gratis
Versi terbaru Node.js.
Setelah Anda memiliki langganan Azure, buat sumber daya Bahasa di portal Azure untuk mendapatkan kunci dan titik akhir Anda. Setelah disebarkan, klik Buka sumber daya.
- Anda akan memerlukan kunci dan titik akhir dari referensi yang Anda buat untuk menyambungkan aplikasi Anda ke API. Anda akan menempelkan kunci dan titik akhir ke dalam kode di bawah ini nanti di mulai cepat.
- Anda dapat menggunakan tingkat harga gratis (Free F0) untuk mencoba layanan, lalu meningkatkannya ke tingkat berbayar untuk produksi.
Untuk menggunakan fitur Analisis, Anda memerlukan sumber daya Bahasa dengan tingkat harga standar (S).

Saya mengalami masalah

Persiapan

Buat aplikasi Node.js baru

Di jendela konsol (seperti cmd, PowerShell, atau Bash), buat direktori baru untuk aplikasi Anda, dan arahkan ke sana.

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 --save @azure/ai-text-analytics@5.1.0

Saya mengalami masalah

Contoh kode

Buka file dan salin kode di bawah ini. Jangan lupa untuk mengganti variabel key dengan kunci untuk referensi Anda dan ganti variabel endpoint dengan titik akhir untuk referensi Anda.

Penting

"use strict";

const { TextAnalyticsClient, AzureKeyCredential } = require("@azure/ai-text-analytics");
const key = '<paste-your-key-here>';
const endpoint = '<paste-your-endpoint-here>';
// Authenticate the client with your key and endpoint
const textAnalyticsClient = new TextAnalyticsClient(endpoint, new AzureKeyCredential(key));

// Example method for extracting key phrases from text
async function keyPhraseExtraction(client){

    const keyPhrasesInput = [
        "Dr. Smith has a very modern medical office, and she has great staff.",
    ];
    const keyPhraseResult = await client.extractKeyPhrases(keyPhrasesInput);
    
    keyPhraseResult.forEach(document => {
        console.log(`ID: ${document.id}`);
        console.log(`\tDocument Key Phrases: ${document.keyPhrases}`);
    });
}
keyPhraseExtraction(textAnalyticsClient);

Output

ID: 0
    Document Key Phrases: modern medical office,Dr. Smith,great staff

Saya mengalami masalah

Dokumentasi referensi | Sampel tambahan | Paket (PiPy) | Kode sumber pustaka

Gunakan mulai cepat ini untuk membuat aplikasi ekstraksi frasa kunci dengan pustaka klien untuk Python. Dalam contoh berikut, Anda akan membuat aplikasi Python yang dapat mengidentifikasi frasa dan kata kunci yang ditemukan dalam teks.

Prasyarat

Langganan Azure - Membuat langganan gratis
Python 3.x
Setelah Anda memiliki langganan Azure, buat sumber daya Bahasa di portal Azure untuk mendapatkan kunci dan titik akhir Anda. Setelah disebarkan, klik Buka sumber daya.
- Anda akan memerlukan kunci dan titik akhir dari referensi yang Anda buat untuk menyambungkan aplikasi Anda ke API. Anda akan menempelkan kunci dan titik akhir ke dalam kode di bawah ini nanti di mulai cepat.
- Anda dapat menggunakan tingkat harga gratis (Free F0) untuk mencoba layanan, lalu meningkatkannya ke tingkat berbayar untuk produksi.
Untuk menggunakan fitur Analisis, Anda memerlukan sumber daya Bahasa dengan tingkat harga standar (S).

Saya mengalami masalah

Persiapan

Memasang pustaka klien

Setelah memasang Python, Anda dapat memasang pustaka klien dengan:

pip install azure-ai-textanalytics==5.1.0

Saya mengalami masalah

Contoh kode

Buat file Python baru dan salin kode di bawah ini. Jangan lupa untuk mengganti variabel key dengan kunci untuk referensi Anda dan ganti variabel endpoint dengan titik akhir untuk referensi Anda.

Penting

key = "paste-your-key-here"
endpoint = "paste-your-endpoint-here"

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(key)
    text_analytics_client = TextAnalyticsClient(
            endpoint=endpoint, 
            credential=ta_credential)
    return text_analytics_client

client = authenticate_client()

def key_phrase_extraction_example(client):

    try:
        documents = ["Dr. Smith has a very modern medical office, and she has great staff."]

        response = client.extract_key_phrases(documents = documents)[0]

        if not response.is_error:
            print("\tKey Phrases:")
            for phrase in response.key_phrases:
                print("\t\t", phrase)
        else:
            print(response.id, response.error)

    except Exception as err:
        print("Encountered exception. {}".format(err))
        
key_phrase_extraction_example(client)

Saya mengalami masalah

Output

Key Phrases:
    modern medical office
    Dr. Smith
    great staff

Dokumentasi rujukan

Gunakan mulai cepat ini untuk mengirim permintaan ekstraksi frasa kunci menggunakan REST API. Dalam contoh berikut, Anda akan menggunakan cURL untuk mengidentifikasi frasa dan kata kunci yang ditemukan dalam teks.

Prasyarat

Langganan Azure - Membuat langganan gratis
Versi cURL saat ini.
Setelah Anda memiliki langganan Azure, buat sumber daya Bahasa di portal Azure untuk mendapatkan kunci dan titik akhir Anda. Setelah disebarkan, klik Buka sumber daya.
- Anda akan memerlukan kunci dan titik akhir dari referensi yang Anda buat untuk menyambungkan aplikasi Anda ke API. Anda akan menempelkan kunci dan titik akhir ke dalam kode di bawah ini nanti di mulai cepat.
- Anda dapat menggunakan tingkat harga gratis (Free F0) untuk mencoba layanan, dan kemudian meningkatkannya ke tingkat berbayar untuk produksi.

Catatan

Contoh BASH berikut menggunakan \ karakter kelanjutan baris. Jika konsol atau terminal Anda menggunakan karakter kelanjutan baris yang berbeda, silakan gunakan karakter tersebut.
Anda dapat menemukan sampel spesifik bahasa di GitHub.
Buka portal Microsoft Azure, lalu cari kunci dan titik akhir untuk Sumber daya bahasa yang Anda buat di prasyarat. Kunci dan titik akhir berada di halaman kunci dan titik akhir sumber daya, di bagian manajemen sumber daya. Kemudian ganti string di dalam kode berikut dengan kunci dan titik akhir Anda. Untuk memanggil API, Anda memerlukan informasi berikut:

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.

Perintah cURL berikut dijalankan dari shell BASH. Edit perintah berikut ini dengan nama sumber daya, kunci sumber daya, dan nilai JSON milik Anda.

Saya mengalami masalah

Ekstraksi frasa kunci

Salin perintah ke editor teks.
JIka diperlukan, buat perubahan berikut dalam perintah:
1. Ganti nilai <your-text-analytics-key-here> dengan kunci Anda.
2. Ganti bagian pertama URL permintaan (<your-text-analytics-endpoint-here>) dengan URL titik akhir Anda sendiri.
Buka jendela wantian perintah.
Tempelkan perintah dari editor teks ke jendela perintah, lalu jalankan perintah.

curl -i -X POST https://<your-language-resource-endpoint>/language/:analyze-text?api-version=2022-05-01 \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: <your-language-resource-key>" \
-d \
'
{
    "kind": "KeyPhraseExtraction",
    "parameters": {
        "modelVersion": "latest"
    },
    "analysisInput":{
        "documents":[
            {
                "id":"1",
                "language":"en",
                "text": "Dr. Smith has a very modern medical office, and she has great staff."
            }
        ]
    }
}
'

Saya mengalami masalah

Respons JSON

{
	"kind": "KeyPhraseExtractionResults",
	"results": {
		"documents": [{
			"id": "1",
			"keyPhrases": ["modern medical office", "Dr. Smith", "great staff"],
			"warnings": []
		}],
		"errors": [],
		"modelVersion": "2021-06-01"
	}
}

Membersihkan sumber daya

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

Saya mengalami masalah

Langkah berikutnya

Ringkasan ekstraksi frasa kunci