Esempio: come estrarre frasi chiave usando Analisi del testoExample: How to extract key phrases using Text Analytics

L'API Estrazione frasi chiave valuta il testo non strutturato e restituisce un elenco di espressioni chiave per ogni documento JSON.The Key Phrase Extraction API evaluates unstructured text, and for each JSON document, returns a list of key phrases.

Questa funzionalità è utile se è necessario identificare rapidamente i punti rilevanti in una raccolta di documenti.This capability is useful if you need to quickly identify the main points in a collection of documents. Ad esempio, dato il testo di input "Il cibo era delizioso e il personale era meraviglioso", il servizio restituisce i punti rilevanti del discorso, ovvero "cibo" e "personale meraviglioso".For example, given input text "The food was delicious and there were wonderful staff", the service returns the main talking points: "food" and "wonderful staff".

Per altre informazioni, vedere Linguaggi supportati.For more information, see Supported languages.

Suggerimento

Analisi del testo offre anche un'immagine del contenitore Docker basata su Linux per l'estrazione delle frasi chiave, di conseguenza è possibile installare ed eseguire il contenitore di Analisi del testo vicino ai dati.Text Analytics also provides a Linux-based Docker container image for key phrase extraction, so you can install and run the Text Analytics container close to your data.

Operazioni preliminariPreparation

L'estrazione di frasi chiave risulta più efficiente quando si elaborano grandi quantità di testo,Key phrase extraction works best when you give it bigger amounts of text to work on. diversamente dall'analisi del sentiment, che offre prestazioni migliori con quantità minori di testo.This is opposite from sentiment analysis, which performs better on smaller amounts of text. Per ottenere risultati ottimali da entrambe le operazioni, provare a ristrutturare gli input di conseguenza.To get the best results from both operations, consider restructuring the inputs accordingly.

È necessario disporre di documenti JSON nel formato seguente: ID, testo, linguaYou must have JSON documents in this format: ID, text, language

Le dimensioni dei documenti devono essere inferiori a 5.120 caratteri per documento e ogni raccolta può contenere fino a 1.000 elementi (ID).Document size must be 5,120 or fewer characters per document, and you can have up to 1,000 items (IDs) per collection. La raccolta viene inviata nel corpo della richiesta.The collection is submitted in the body of the request. L'esempio seguente illustra il contenuto che è possibile inviare per l'estrazione di espressioni chiave.The following example is an illustration of content you might submit for key phrase extraction.

    {
        "documents": [
            {
                "language": "en",
                "id": "1",
                "text": "We love this trail and make the trip every year. The views are breathtaking and well worth the hike!"
            },
            {
                "language": "en",
                "id": "2",
                "text": "Poorly marked trails! I thought we were goners. Worst hike ever."
            },
            {
                "language": "en",
                "id": "3",
                "text": "Everyone in my family liked the trail but thought it was too challenging for the less athletic among us. Not necessarily recommended for small children."
            },
            {
                "language": "en",
                "id": "4",
                "text": "It was foggy so we missed the spectacular views, but the trail was ok. Worth checking out if you are in the area."
            },
            {
                "language": "en",
                "id": "5",
                "text": "This is my favorite trail. It has beautiful views and many places to stop and rest"
            }
        ]
    }

Passaggio 1: Strutturare la richiestaStep 1: Structure the request

Per informazioni sulla definizione della richiesta, vedere Come chiamare l'API Analisi del testo.For information about request definition, see How to call the Text Analytics API. Per comodità si ridefiniscono i punti seguenti:The following points are restated for convenience:

  • Creare una richiesta POST.Create a POST request. Vedere la documentazione dell'API per questa richiesta: API frasi chiave.Review the API documentation for this request: Key Phrases API.

  • Impostare l'endpoint HTTP per l'estrazione delle frasi chiave usando una risorsa di Analisi del testo in Azure oppure un'istanza di un contenitore di Analisi del testo.Set the HTTP endpoint for key phrase extraction by using either a Text Analytics resource on Azure or an instantiated Text Analytics container. È necessario includere /text/analytics/v2.1/keyPhrases nell'URL.You must include /text/analytics/v2.1/keyPhrases in the URL. Ad esempio: https://<your-custom-subdomain>.api.cognitiveservices.azure.com/text/analytics/v2.1/keyPhrases.For example: https://<your-custom-subdomain>.api.cognitiveservices.azure.com/text/analytics/v2.1/keyPhrases.

  • Impostare un'intestazione della richiesta in modo da includere la chiave di accesso per le operazioni di Analisi del testo.Set a request header to include the access key for Text Analytics operations.

  • Nel corpo della richiesta specificare la raccolta di documenti JSON preparata per l'analisi.In the request body, provide the JSON documents collection you prepared for this analysis.

Suggerimento

Usare Postman oppure aprire la console di test dell'API nella documentazione per strutturare una richiesta e inviarla tramite POST al servizio.Use Postman or open the API testing console in the documentation to structure a request and POST it to the service.

Passaggio 2: Pubblicare la richiestaStep 2: Post the request

Al momento della ricezione della richiesta viene eseguita l'analisi.Analysis is performed upon receipt of the request. Per informazioni sulle dimensioni e sul numero delle richieste che è possibile inviare al minuto e al secondo, vedere la sezione Limiti dei dati nella panoramica.For information about the size and number of requests you can send per minute or per second, see the data limits section in the overview .

Tenere presente che il servizio è senza stato.Recall that the service is stateless. Nessun dato viene archiviato nell'account.No data is stored in your account. I risultati vengono restituiti immediatamente nella risposta.Results are returned immediately in the response.

Passaggio 3: Visualizzare i risultatiStep 3: View results

Tutte le richieste POST restituiscono una risposta JSON formattata con gli ID e le proprietà rilevate.All POST requests return a JSON formatted response with the IDs and detected properties. L'ordine delle frasi chiave restituite viene determinato internamente dal modello.The order of the returned key phrases is determined internally, by the model.

L'output viene restituito immediatamente.Output is returned immediately. Si possono trasmettere i risultati a un'applicazione che accetta JSON o salvare l'output in un file nel sistema locale e quindi importarlo in un'applicazione che consente di ordinare, cercare e modificare i dati.You can stream the results to an application that accepts JSON or save the output to a file on the local system, and then import it into an application that allows you to sort, search, and manipulate the data.

Di seguito è illustrato un esempio dell'output di estrazione di frasi chiave:An example of the output for key phrase extraction is shown here:

    {
        "documents": [
            {
                "keyPhrases": [
                    "year",
                    "trail",
                    "trip",
                    "views"
                ],
                "id": "1"
            },
            {
                "keyPhrases": [
                    "marked trails",
                    "Worst hike",
                    "goners"
                ],
                "id": "2"
            },
            {
                "keyPhrases": [
                    "trail",
                    "small children",
                    "family"
                ],
                "id": "3"
            },
            {
                "keyPhrases": [
                    "spectacular views",
                    "trail",
                    "area"
                ],
                "id": "4"
            },
            {
                "keyPhrases": [
                    "places",
                    "beautiful views",
                    "favorite trail"
                ],
                "id": "5"
            }
        ],
        "errors": []
    }

Come indicato, l'analizzatore trova e rimuove le parole non essenziali e mantiene singoli termini o frasi che sembrano essere il soggetto o l'oggetto di una frase.As noted, the analyzer finds and discards non-essential words, and it keeps single terms or phrases that appear to be the subject or object of a sentence.

SummarySummary

In questo articolo si sono appresi i concetti e il flusso di lavoro per l'estrazione di frasi chiave tramite Analisi del testo in Servizi cognitivi.In this article, you learned concepts and workflow for key phrase extraction by using Text Analytics in Cognitive Services. In sintesi:In summary:

  • L'API Estrazione frasi chiave è disponibile per le lingue selezionate.Key phrase extraction API is available for selected languages.
  • I documenti JSON nel corpo della richiesta includono un ID, il testo e il codice della lingua.JSON documents in the request body include an ID, text, and language code.
  • La richiesta POST viene indirizzata a un endpoint /keyphrases usando una chiave di accesso personalizzata e un endpoint valido per la sottoscrizione.POST request is to a /keyphrases endpoint, using a personalized access key and an endpoint that is valid for your subscription.
  • L'output di risposta, costituito da parole o frasi chiave per ogni ID documento, può essere trasmesso a qualsiasi app che accetta JSON, tra cui Microsoft Office Excel e Power BI, solo per citarne alcune.Response output, which consists of key words and phrases for each document ID, can be streamed to any app that accepts JSON, including Microsoft Office Excel and Power BI, to name a few.

Vedi ancheSee also

Panoramica di Analisi del testo Domande frequentiText Analytics overview Frequently asked questions (FAQ)
Pagina del prodotto Analisi del testoText Analytics product page

Passaggi successiviNext steps