Rövid útmutató: a Key Phrase Extraction ügyfélkódtár és a REST API használata

Cikk
03/19/2024

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

Ezzel a rövid útmutatóval kulcskifejezés-kinyerési alkalmazást hozhat létre 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 található kulcsszavakat és kifejezéseket.

Tipp.

A Language Studio használatával kódírás nélkül is kipróbálhatja a Language Service szolgáltatásait.

Előfeltételek

Azure-előfizetés – Ingyenes létrehozás
A Visual Studio IDE
Miután megkapta az Azure-előfizetését, hozzon létre egy nyelvi erőforrást az Azure Portalon a kulcs és a végpont lekéréséhez. Az üzembe helyezés után válassza az Ugrás az erőforrásra lehetőséget.
- Az alkalmazás API-hoz való csatlakoztatásához szüksége lesz a létrehozott erőforrás kulcsára és végpontjára. A rövid útmutató későbbi részében illessze be a kulcsot és a végpontot az alábbi kódba.
- Az ingyenes tarifacsomag (Free F0) használatával kipróbálhatja a szolgáltatást, és később frissíthet egy fizetős szintre az éles környezetben.
Az Elemzés funkció használatához szüksége lesz egy nyelvi erőforrásra a standard (S) tarifacsomaggal.

Beállítás

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 „Hello World!” projektet egy program.cs nevű C#-forráskódfájllal.

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. Ne felejtse el lecserélni a változót key az erőforrás kulcsára, és cserélje le a változót endpoint az erőforrás végpontjára. Most futtassa a kódot.

Fontos

Nyissa meg az Azure Portalt. Ha az Előfeltételek szakaszban létrehozott nyelvi erőforrás sikeresen üzembe lett helyezve, kattintson az Erőforrás megnyitása gombra a Következő lépések csoportban. A kulcs és a végpont megkereséséhez lépjen az erőforrás Kulcsok és végpont lapjára az Erőforrás-kezelés területen.

Fontos

Ne felejtse el eltávolítani a kulcsot a kódból, amikor elkészült, és soha ne tegye közzé nyilvánosan. Éles környezetben biztonságos módon tárolhatja és érheti el a hitelesítő adatait, például az Azure Key Vaultot. További információkért tekintse meg az Azure AI-szolgáltatások biztonsági cikkét.

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

    }
}

Hozam

Key phrases:
    modern medical office
    Dr. Smith
    great staff

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

Ezzel a rövid útmutatóval kulcskifejezés-kinyerési alkalmazást hozhat létre a Java ügyfélkódtárával. Az alábbi példában egy Java-alkalmazást fog létrehozni, amely képes azonosítani a szövegben található kulcsszavakat és kifejezéseket.

Tipp.

A Language Studio használatával kódírás nélkül is kipróbálhatja a Language Service szolgáltatásait.

Előfeltételek

Azure-előfizetés – Ingyenes létrehozás
A Java fejlesztői készlet (JDK) 8-as vagy újabb verziója
Miután megkapta az Azure-előfizetését, hozzon létre egy nyelvi erőforrást az Azure Portalon a kulcs és a végpont lekéréséhez. Az üzembe helyezés után válassza az Ugrás az erőforrásra lehetőséget.
- Az alkalmazás API-hoz való csatlakoztatásához szüksége lesz a létrehozott erőforrás kulcsára és végpontjára. A rövid útmutató későbbi részében illessze be a kulcsot és a végpontot az alábbi kódba.
- Az ingyenes tarifacsomag (Free F0) használatával kipróbálhatja a szolgáltatást, és később frissíthet egy fizetős szintre az éles környezetben.
Az Elemzés funkció használatához szüksége lesz egy nyelvi erőforrásra a standard (S) tarifacsomaggal.

Beállítás

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. Ne felejtse el lecserélni a változót key az erőforrás kulcsára, és cserélje le a változót endpoint az erőforrás végpontjára. Most futtassa a kódot.

Fontos

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

Hozam

Recognized phrases: 

modern medical office
Dr. Smith
great staff

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

Ezzel a rövid útmutatóval kulcskifejezés-kinyerési alkalmazást hozhat létre a Node.js ügyfélkódtárával. Az alábbi példában egy JavaScript-alkalmazást fog létrehozni, amely képes azonosítani a szövegben található kulcsszavakat és kifejezéseket.

Tipp.

A Language Studio használatával kódírás nélkül is kipróbálhatja a Language Service szolgáltatásait.

Előfeltételek

Azure-előfizetés – Ingyenes létrehozás
Node.js v14 LTS vagy újabb verzió
Miután megkapta az Azure-előfizetését, hozzon létre egy nyelvi erőforrást az Azure Portalon a kulcs és a végpont lekéréséhez. Az üzembe helyezés után válassza az Ugrás az erőforrásra lehetőséget.
- Az alkalmazás API-hoz való csatlakoztatásához szüksége lesz a létrehozott erőforrás kulcsára és végpontjára. A rövid útmutató későbbi részében illessze be a kulcsot és a végpontot az alábbi kódba.
- Az ingyenes tarifacsomag (Free F0) használatával kipróbálhatja a szolgáltatást, és később frissíthet egy fizetős szintre az éles környezetben.
Az Elemzés funkció használatához szüksége lesz egy nyelvi erőforrásra a standard (S) tarifacsomaggal.

Beállítás

Ú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-language-text

Mintakód

Nyissa meg a fájlt, és másolja az alábbi kódot. Ne felejtse el lecserélni a változót key az erőforrás kulcsára, és cserélje le a változót endpoint az erőforrás végpontjára. Most futtassa a kódot.

Fontos

"use strict";

const { TextAnalysisClient, AzureKeyCredential } = require("@azure/ai-language-text");
const key = '<paste-your-key-here>';
const endpoint = '<paste-your-endpoint-here>';

//example sentence for performing key phrase extraction
const documents = ["Dr. Smith has a very modern medical office, and she has great staff."];

//example of how to use the client to perform entity linking on a document
async function main() {
    console.log("== key phrase extraction sample ==");
  
    const client = new TextAnalysisClient(endpoint, new AzureKeyCredential(key));
  
    const results = await client.analyze("KeyPhraseExtraction", documents);
  
    for (const result of results) {
      console.log(`- Document ${result.id}`);
      if (!result.error) {
        console.log("\tKey phrases:");
        for (const phrase of result.keyPhrases) {
          console.log(`\t- ${phrase}`);
        }
      } else {
        console.error("  Error:", result.error);
      }
    }
  }
  
  main().catch((err) => {
    console.error("The sample encountered an error:", err);
  });

Hozam

== key phrase extraction sample ==
- Document 0
    Key phrases:
    - modern medical office
    - Dr. Smith
    - great staff

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

Ezzel a rövid útmutatóval kulcskifejezés-kinyerési alkalmazást hozhat létre a Python ügyfélkódtárával. Az alábbi példában létrehoz egy Python-alkalmazást, amely képes azonosítani a szövegben található kulcsszavakat és kifejezéseket.

Tipp.

A Language Studio használatával kódírás nélkül is kipróbálhatja a Language Service szolgáltatásait.

Előfeltételek

Azure-előfizetés – Ingyenes létrehozás
Python 3.8 vagy újabb
Miután megkapta az Azure-előfizetését, hozzon létre egy nyelvi erőforrást az Azure Portalon a kulcs és a végpont lekéréséhez. Az üzembe helyezés után válassza az Ugrás az erőforrásra lehetőséget.
- Az alkalmazás API-hoz való csatlakoztatásához szüksége lesz a létrehozott erőforrás kulcsára és végpontjára. A rövid útmutató későbbi részében illessze be a kulcsot és a végpontot az alábbi kódba.
- Az ingyenes tarifacsomag (Free F0) használatával kipróbálhatja a szolgáltatást, és később frissíthet egy fizetős szintre az éles környezetben.
Az Elemzés funkció használatához szüksége lesz egy nyelvi erőforrásra a standard (S) tarifacsomaggal.

Beállítás

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. Ne felejtse el lecserélni a változót key az erőforrás kulcsára, és cserélje le a változót endpoint az erőforrás végpontjára. Most futtassa a kódot.

Fontos

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)

Hozam

Key Phrases:
    modern medical office
    Dr. Smith
    great staff

Referenciadokumentáció

Ezzel a rövid útmutatóval kulcskifejezés-kinyeré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 szövegben található kulcsszavakat és kifejezéseket.

Tipp.

A Language Studio használatával kódírás nélkül is kipróbálhatja a Language Service szolgáltatásait.

Előfeltételek

Azure-előfizetés – Ingyenes létrehozás
A cURL aktuális verziója.
Miután megkapta az Azure-előfizetését, hozzon létre egy nyelvi erőforrást az Azure Portalon a kulcs és a végpont lekéréséhez. Az üzembe helyezés után válassza az Ugrás az erőforrásra lehetőséget.
- Az alkalmazás API-hoz való csatlakoztatásához szüksége lesz a létrehozott erőforrás kulcsára és végpontjára. A rövid útmutató későbbi részében illessze be a kulcsot és a végpontot az alábbi kódba.
- Az ingyenes tarifacsomag (Free F0) használatával kipróbálhatja a szolgáltatást, és később frissíthet egy fizetős szintre az éles környezetben.

Feljegyzés

Az alábbi BASH-példák a sor folytatási karakterét \ használják. Ha a konzol vagy a terminál más vonal folytatási karaktert használ, használja ezt a karaktert.
Nyelvspecifikus mintákat a GitHubon találhat.
Nyissa meg az Azure Portalt, és keresse meg az előfeltételekben létrehozott nyelvi erőforrás kulcsát és végpontját. Ezek az erőforrás kulcs- és végpontoldalán, az erőforrás-kezelés alatt fognak elhelyezkedni. Ezután cserélje le az alábbi kód sztringeit a kulcsra és a végpontra. Az API meghívásához a következő információkra van szüksége:

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.

A következő cURL-parancsok bash-rendszerhéjból lesznek végrehajtva. Szerkessze ezeket a parancsokat saját erőforrásnevével, erőforráskulcsával és JSON-értékeivel.

Kulcsszókeresés

Másolja a parancsot egy szövegszerkesztőbe.
Szükség esetén végezze el a következő módosításokat a parancsban:
1. Cserélje le az értéket <your-language-resource-key> a kulcsra.
2. Cserélje le a kérelem URL-címének <your-language-resource-endpoint> első részét a végpont URL-címére.
Nyisson meg egy parancsablakot.
Illessze be a szövegszerkesztőből a parancsot, majd futtassa.

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

JSON-válasz

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

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

Kulcskifejezések kinyerésének áttekintése

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

Rövid útmutató: a Key Phrase Extraction ügyfélkódtár és a REST API használata

Előfeltételek

Beállítás

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

Mintakód

Hozam

Előfeltételek

Beállítás

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

Mintakód

Hozam

Előfeltételek

Beállítás

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

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

Mintakód

Hozam

Előfeltételek

Beállítás

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

Mintakód

Hozam

Előfeltételek

Kulcsszókeresés

JSON-válasz

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

Következő lépések

További források