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

  • Cikk

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 egy C#-alkalmazást hoz létre, amely képes azonosítani a szövegben található kulcsszavakat és kifejezéseket.

Előfeltételek

Beállítás

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

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

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

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

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

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

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

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

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

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

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

Kulcs és végpont lekérése

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

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

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

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

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

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

Az alkalmazásnak hitelesítenie kell az API-kérések küldéséhez. Éles környezetben használjon biztonságos módot a hitelesítő adatok tárolására és elérésére. Ebben a példában a hitelesítő adatokat az alkalmazást futtató helyi gépen lévő környezeti változókba fogja írni.

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 le your-key az erőforrás egyik kulcsára.
  • A LANGUAGE_ENDPOINT környezeti változó beállításához cserélje le your-endpoint az erőforrás végpontját.

Fontos

HA API-kulcsot használ, biztonságosan tárolja valahol máshol, például az Azure Key Vaultban. Ne foglalja bele közvetlenül az API-kulcsot a kódba, és soha ne tegye közzé nyilvánosan.

Az AI-szolgáltatások biztonságáról további információt az Azure AI-szolgáltatásokhoz érkező kérelmek hitelesítése című témakörben talál.

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. Ezzel 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. Most futtassa a kódot.

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

namespace KeyPhraseExtractionExample
{
    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 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 hoz létre, amely képes azonosítani a szövegben található kulcsszavakat és kifejezéseket.

Előfeltételek

Beállítás

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

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

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

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

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

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

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

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

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

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

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

Kulcs és végpont lekérése

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

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

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

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

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

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

Az alkalmazásnak hitelesítenie kell az API-kérések küldéséhez. Éles környezetben használjon biztonságos módot a hitelesítő adatok tárolására és elérésére. Ebben a példában a hitelesítő adatokat az alkalmazást futtató helyi gépen lévő környezeti változókba fogja írni.

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 le your-key az erőforrás egyik kulcsára.
  • A LANGUAGE_ENDPOINT környezeti változó beállításához cserélje le your-endpoint az erőforrás végpontját.

Fontos

HA API-kulcsot használ, biztonságosan tárolja valahol máshol, például az Azure Key Vaultban. Ne foglalja bele közvetlenül az API-kulcsot a kódba, és soha ne tegye közzé nyilvánosan.

Az AI-szolgáltatások biztonságáról további információt az Azure AI-szolgáltatásokhoz érkező kérelmek hitelesítése című témakörben talál.

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.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);
        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 hoz létre, amely képes azonosítani a szövegben található kulcsszavakat és kifejezéseket.

Előfeltételek

Beállítás

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

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

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

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

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

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

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

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

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

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

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

Kulcs és végpont lekérése

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

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

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

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

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

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

Az alkalmazásnak hitelesítenie kell az API-kérések küldéséhez. Éles környezetben használjon biztonságos módot a hitelesítő adatok tárolására és elérésére. Ebben a példában a hitelesítő adatokat az alkalmazást futtató helyi gépen lévő környezeti változókba fogja írni.

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 le your-key az erőforrás egyik kulcsára.
  • A LANGUAGE_ENDPOINT környezeti változó beállításához cserélje le your-endpoint az erőforrás végpontját.

Fontos

HA API-kulcsot használ, biztonságosan tárolja valahol máshol, például az Azure Key Vaultban. Ne foglalja bele közvetlenül az API-kulcsot a kódba, és soha ne tegye közzé nyilvánosan.

Az AI-szolgáltatások biztonságáról további információt az Azure AI-szolgáltatásokhoz érkező kérelmek hitelesítése című témakörben talál.

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

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;

//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.

Előfeltételek

Beállítás

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

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

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

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

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

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

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

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

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

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

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

Kulcs és végpont lekérése

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

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

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

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

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

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

Az alkalmazásnak hitelesítenie kell az API-kérések küldéséhez. Éles környezetben használjon biztonságos módot a hitelesítő adatok tárolására és elérésére. Ebben a példában a hitelesítő adatokat az alkalmazást futtató helyi gépen lévő környezeti változókba fogja írni.

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 le your-key az erőforrás egyik kulcsára.
  • A LANGUAGE_ENDPOINT környezeti változó beállításához cserélje le your-endpoint az erőforrás végpontját.

Fontos

HA API-kulcsot használ, biztonságosan tárolja valahol máshol, például az Azure Key Vaultban. Ne foglalja bele közvetlenül az API-kulcsot a kódba, és soha ne tegye közzé nyilvánosan.

Az AI-szolgáltatások biztonságáról további információt az Azure AI-szolgáltatásokhoz érkező kérelmek hitelesítése című témakörben talál.

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

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.

Előfeltételek

Beállítás

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

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

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

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

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

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

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

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

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

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

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

Kulcs és végpont lekérése

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

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

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

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

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

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

Az alkalmazásnak hitelesítenie kell az API-kérések küldéséhez. Éles környezetben használjon biztonságos módot a hitelesítő adatok tárolására és elérésére. Ebben a példában a hitelesítő adatokat az alkalmazást futtató helyi gépen lévő környezeti változókba fogja írni.

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 le your-key az erőforrás egyik kulcsára.
  • A LANGUAGE_ENDPOINT környezeti változó beállításához cserélje le your-endpoint az erőforrás végpontját.

Fontos

HA API-kulcsot használ, biztonságosan tárolja valahol máshol, például az Azure Key Vaultban. Ne foglalja bele közvetlenül az API-kulcsot a kódba, és soha ne tegye közzé nyilvánosan.

Az AI-szolgáltatások biztonságáról további információt az Azure AI-szolgáltatásokhoz érkező kérelmek hitelesítése című témakörben talál.

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_kpe_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": "KeyPhraseExtraction",
    "parameters": {
        "modelVersion": "latest"
    },
    "analysisInput":{
        "documents":[
            {
                "id":"1",
                "language":"en",
                "text": "Dr. Smith has a very modern medical office, and she has great staff."
            }
        ]
    }
}

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

Kulcskifejezés-kinyeré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_kpe_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_kpe_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_kpe_payload.json"

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