Início Rápido: utilizar a biblioteca de cliente de Extração de Expressões-Chave e a API REST

Artigo
07/20/2023

Documentação de referência | Exemplos adicionais | Pacote (NuGet) | Código fonte da biblioteca

Utilize este início rápido para criar uma aplicação de extração de expressões-chave com a biblioteca de cliente para .NET. No exemplo seguinte, irá criar uma aplicação C# que pode identificar palavras-chave e expressões encontradas no texto.

Dica

Pode utilizar o Language Studio para experimentar funcionalidades do Serviço de idiomas sem ter de escrever código.

Pré-requisitos

Subscrição do Azure – Criar uma gratuitamente
O IDE do Visual Studio
Assim que tiver a sua subscrição do Azure, para criar um recurso de Idioma no portal do Azure para obter a chave e o ponto final. Depois de implementar, selecione Ir para recurso.
- Precisará da chave e do ponto final do recurso que criar para ligar a sua aplicação à API. Irá colar a chave e o ponto final no código abaixo mais tarde no início rápido.
- Pode utilizar o escalão de preço gratuito (Free F0) para experimentar o serviço e atualizar mais tarde para um escalão pago para produção.
Para utilizar a funcionalidade Analisar, precisará de um recurso de Idioma com o escalão de preço standard (S).

Configurar

Criar uma nova aplicação .NET Core

Com o IDE do Visual Studio, crie uma nova aplicação de consola .NET Core. Isto irá criar um projeto "Hello World" com um único ficheiro de origem C#: program.cs.

Instale a biblioteca de cliente ao clicar com o botão direito do rato na solução no Explorador de Soluções e selecionar Gerir Pacotes NuGet. No gestor de pacotes que abre, selecione Procurar e procure Azure.AI.TextAnalytics. Selecione a versão 5.2.0e, em seguida , Instalar. Também pode utilizar a Consola do Gestor de Pacotes.

Exemplo de código

Copie o seguinte código para o ficheiro program.cs . Lembre-se de substituir a key variável pela chave do recurso e substituir a endpoint variável pelo ponto final do recurso. Em seguida, execute o código.

Importante

Aceda ao portal do Azure. Se o recurso de Idioma que criou na secção Pré-requisitos implementado com êxito, clique no botão Ir para Recurso em Passos Seguintes. Pode encontrar a chave e o ponto final ao navegar para a página Chaves e Ponto Final do recurso, em Gestão de Recursos.

Importante

Lembre-se de remover a chave do código quando terminar e nunca a publicar publicamente. Para produção, utilize uma forma segura de armazenar e aceder às suas credenciais, como o Azure Key Vault. Veja o artigo segurança dos serviços de IA do Azure para obter mais informações.

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

    }
}

Saída

Key phrases:
    modern medical office
    Dr. Smith
    great staff

Documentação de referência | Exemplos adicionais | Pacote (Maven) | Código fonte da biblioteca

Utilize este início rápido para criar uma aplicação de extração de expressões-chave com a biblioteca de cliente para Java. No exemplo seguinte, irá criar uma aplicação Java que pode identificar palavras-chave e expressões encontradas no texto.

Dica

Pode utilizar o Language Studio para experimentar funcionalidades do Serviço de idiomas sem ter de escrever código.

Pré-requisitos

Subscrição do Azure – Criar uma gratuitamente
Java Development Kit (JDK) com a versão 8 ou superior
Assim que tiver a sua subscrição do Azure, para criar um recurso de Idioma no portal do Azure para obter a chave e o ponto final. Depois de implementar, selecione Ir para recurso.
- Precisará da chave e do ponto final do recurso que criar para ligar a sua aplicação à API. Irá colar a chave e o ponto final no código abaixo mais tarde no início rápido.
- Pode utilizar o escalão de preço gratuito (Free F0) para experimentar o serviço e atualizar mais tarde para um escalão pago para produção.
Para utilizar a funcionalidade Analisar, precisará de um recurso de Idioma com o escalão de preço standard (S).

Configurar

Adicionar a biblioteca de cliente

Crie um projeto maven no seu ambiente de desenvolvimento ou IDE preferencial. Em seguida, adicione a seguinte dependência ao ficheiro pom.xml do projeto. Pode encontrar a sintaxe de implementação para outras ferramentas de compilação online.

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

Exemplo de código

Crie um ficheiro Java com o nome Example.java. Abra o ficheiro e copie o código abaixo. Lembre-se de substituir a key variável pela chave do recurso e substituir a endpoint variável pelo ponto final do recurso. Em seguida, execute o código.

Importante

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

Saída

Recognized phrases: 

modern medical office
Dr. Smith
great staff

Documentação de referência | Exemplos adicionais | Pacote (npm) | Código fonte da biblioteca

Utilize este início rápido para criar uma aplicação de extração de expressões-chave com a biblioteca de cliente para Node.js. No exemplo seguinte, irá criar uma aplicação JavaScript que pode identificar palavras-chave e expressões encontradas no texto.

Dica

Pode utilizar o Language Studio para experimentar funcionalidades do Serviço de idiomas sem ter de escrever código.

Pré-requisitos

Subscrição do Azure – Criar uma gratuitamente
Node.js v14 LTS ou posterior
Assim que tiver a sua subscrição do Azure, para criar um recurso de Idioma no portal do Azure para obter a chave e o ponto final. Depois de implementar, selecione Ir para recurso.
- Precisará da chave e do ponto final do recurso que criar para ligar a sua aplicação à API. Irá colar a chave e o ponto final no código abaixo mais tarde no início rápido.
- Pode utilizar o escalão de preço gratuito (Free F0) para experimentar o serviço e atualizar mais tarde para um escalão pago para produção.
Para utilizar a funcionalidade Analisar, precisará de um recurso de Idioma com o escalão de preço standard (S).

Configurar

Criar uma nova aplicação Node.js

Numa janela da consola (como cmd, PowerShell ou Bash), crie um novo diretório para a sua aplicação e navegue para o mesmo.

mkdir myapp 

cd myapp

Execute o npm init comando para criar uma aplicação de nó com um package.json ficheiro.

npm init

Instalar a biblioteca de cliente

Instale o pacote npm:

npm install @azure/ai-language-text

Exemplo de código

Abra o ficheiro e copie o código abaixo. Lembre-se de substituir a key variável pela chave do recurso e substituir a endpoint variável pelo ponto final do recurso. Em seguida, execute o código.

Importante

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

Saída

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

Documentação de referência | Exemplos adicionais | Pacote (PyPi) | Código fonte da biblioteca

Utilize este início rápido para criar uma aplicação de extração de expressões-chave com a biblioteca de cliente para Python. No exemplo seguinte, irá criar uma aplicação Python que pode identificar palavras-chave e expressões encontradas no texto.

Dica

Pode utilizar o Language Studio para experimentar funcionalidades do serviço Idioma sem ter de escrever código.

Pré-requisitos

Subscrição do Azure – Criar uma gratuitamente
Python 3.7 ou posterior
Assim que tiver a sua subscrição do Azure, para criar um recurso idioma no portal do Azure para obter a sua chave e ponto final. Depois de implementar, selecione Ir para recurso.
- Precisará da chave e do ponto final do recurso que criar para ligar a sua aplicação à API. Irá colar a chave e o ponto final no código abaixo mais tarde no início rápido.
- Pode utilizar o escalão de preço gratuito (Free F0) para experimentar o serviço e atualizar mais tarde para um escalão pago para produção.
Para utilizar a funcionalidade Analisar, precisará de um recurso de Idioma com o escalão de preço padrão (S).

Configurar

Instalar a biblioteca de cliente

Depois de instalar o Python, pode instalar a biblioteca de cliente com:

pip install azure-ai-textanalytics==5.2.0

Exemplo de código

Crie um novo ficheiro Python e copie o código abaixo. Lembre-se de substituir a key variável pela chave do recurso e substituir a endpoint variável pelo ponto final do recurso. Em seguida, execute o código.

Importante

Aceda ao portal do Azure. Se o recurso Idioma que criou na secção Pré-requisitos implementado com êxito, clique no botão Ir para Recurso em Passos Seguintes. Pode encontrar a sua chave e ponto final ao navegar para a página Chaves e Ponto Final do recurso, em Gestão de Recursos.

Importante

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)

Saída

Key Phrases:
    modern medical office
    Dr. Smith
    great staff

Documentação de referência

Utilize este início rápido para enviar pedidos de extração de expressões-chave com a API REST. No exemplo seguinte, irá utilizar cURL para identificar palavras-chave e expressões encontradas no texto.

Dica

Pode utilizar o Language Studio para experimentar funcionalidades do serviço Idioma sem ter de escrever código.

Pré-requisitos

Subscrição do Azure – Criar uma gratuitamente
A versão atual do cURL.
Assim que tiver a sua subscrição do Azure, para criar um recurso idioma no portal do Azure para obter a sua chave e ponto final. Depois de implementar, selecione Ir para recurso.
- Precisará da chave e do ponto final do recurso que criar para ligar a sua aplicação à API. Irá colar a chave e o ponto final no código abaixo mais tarde no início rápido.
- Pode utilizar o escalão de preço gratuito (Free F0) para experimentar o serviço e atualizar mais tarde para um escalão pago para produção.

Nota

Os exemplos bash seguintes utilizam o caráter de continuação da \ linha. Se a consola ou o terminal utilizar um caráter de continuação de linha diferente, utilize esse caráter.
Pode encontrar exemplos específicos de idioma no GitHub.
Aceda ao portal do Azure e localize a chave e o ponto final do recurso Idioma que criou nos pré-requisitos. Estarão localizados na página de chave e ponto final do recurso, em gestão de recursos. Em seguida, substitua as cadeias no código abaixo pela sua chave e ponto final. Para chamar a API, precisa das seguintes informações:

parameter	Description
`-X POST <endpoint>`	Especifica o ponto final para aceder à API.
`-H Content-Type: application/json`	O tipo de conteúdo para enviar dados JSON.
`-H "Ocp-Apim-Subscription-Key:<key>`	Especifica a chave para aceder à API.
`-d <documents>`	O JSON que contém os documentos que pretende enviar.

Os seguintes comandos cURL são executados a partir de uma shell BASH. Edite estes comandos com o seu próprio nome de recurso, chave de recurso e valores JSON.

Extração de expressões-chave

Copie o comando para um editor de texto.
Faça as alterações seguintes ao comando, se for necessário:
1. Substitua o valor <your-language-resource-key> pela sua chave.
2. Substitua a primeira parte do URL <your-language-resource-endpoint> do pedido pelo URL do ponto final.
Abra uma janela da linha de comandos.
Cole o comando a partir do editor de texto na janela da linha de comandos e, em seguida, execute o comando.

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

Resposta JSON

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

Limpar os recursos

Se quiser limpar e remover uma subscrição dos serviços de IA do Azure, pode eliminar o recurso ou o grupo de recursos. Eliminar o grupo de recursos também elimina quaisquer outros recursos associados ao mesmo.

Passos seguintes

Descrição geral da extração de expressões-chave

Início Rápido: utilizar a biblioteca de cliente de Extração de Expressões-Chave e a API REST

Pré-requisitos

Configurar

Criar uma nova aplicação .NET Core

Exemplo de código

Saída

Pré-requisitos

Configurar

Adicionar a biblioteca de cliente

Exemplo de código

Saída

Pré-requisitos

Configurar

Criar uma nova aplicação Node.js

Instalar a biblioteca de cliente

Exemplo de código

Saída

Pré-requisitos

Configurar

Instalar a biblioteca de cliente

Exemplo de código

Saída

Pré-requisitos

Extração de expressões-chave

Resposta JSON

Limpar os recursos

Passos seguintes

Recursos adicionais

Recursos adicionais