Come usare l'estrazione di frasi chiave

La funzionalità di estrazione frasi chiave può valutare il testo non strutturato e, per ogni documento, restituire un elenco di frasi chiave.

Questa funzionalità è utile se è necessario identificare rapidamente i punti principali in una raccolta di documenti. Ad esempio, dato il testo di input "Il cibo era delizioso e il personale era meraviglioso", il servizio restituisce gli argomenti principali: "cibo" e "personale meraviglioso".

Suggerimento

Per iniziare a usare questa funzionalità, è possibile seguire l'articolo di avvio rapido per iniziare. È anche possibile effettuare richieste di esempio usando Language Studio senza dover scrivere codice.

Opzioni di sviluppo

Per usare l'estrazione di frasi chiave, inviare testo non strutturato non elaborato per l'analisi e gestire l'output dell'API nell'applicazione. L'analisi viene eseguita così come è, senza alcuna personalizzazione aggiuntiva per il modello usato sui dati. Esistono due modi per usare l'estrazione di frasi chiave:

Opzione di sviluppo	Descrizione
Language Studio	Language Studio è una piattaforma basata sul Web che consente di provare a collegare entità con esempi di testo senza un account Azure e i propri dati quando si esegue l'iscrizione. Per altre informazioni, vedere il sito Web di Language Studio o la guida introduttiva di Language Studio.
API REST o libreria client (Azure SDK)	Integrare l'estrazione di frasi chiave nelle applicazioni usando l'API REST o la libreria client disponibile in un'ampia gamma di lingue. Per altre informazioni, vedere la guida introduttiva all'estrazione di frasi chiave.
Contenitore Docker	Usare il contenitore Docker disponibile per distribuire questa funzionalità in locale. Questi contenitori Docker consentono di avvicinare il servizio ai dati per motivi di conformità, sicurezza o altri motivi operativi.

Determinare come elaborare i dati (facoltativo)

Specificare il modello di estrazione frasi chiave

Per impostazione predefinita, l'estrazione di frasi chiave userà il modello di intelligenza artificiale disponibile più recente nel testo. È anche possibile configurare le richieste API per l'uso di una versione del modello specifica.

Lingue di input

Quando si inviano documenti da elaborare tramite l'estrazione di frasi chiave, è possibile specificare le lingue supportate in cui vengono scritte. se non si specifica una lingua, per impostazione predefinita l'estrazione di frasi chiave sarà inglese. L'API può restituire offset nella risposta per supportare diverse codifiche multilingue ed emoji.

Invio di dati

L'estrazione di frasi chiave risulta più efficiente quando si elaborano grandi quantità di testo, diversamente dall'analisi del sentiment, che offre prestazioni migliori con quantità minori di testo. Per ottenere risultati ottimali da entrambe le operazioni, provare a ristrutturare gli input di conseguenza.

Per inviare una richiesta API, è necessario l'endpoint della risorsa lingua e la chiave.

Nota

È possibile trovare la chiave e l'endpoint per la risorsa Lingua nel portale di Azure. Si troveranno nella pagina Chiave ed endpoint della risorsa, in Gestione risorse.

Al momento della ricezione della richiesta viene eseguita l'analisi. L'uso della funzionalità di estrazione sincrona delle frasi chiave è senza stato. Non vengono archiviati dati nell'account e i risultati vengono restituiti immediatamente nella risposta.

Quando si usa questa funzionalità in modo asincrono, i risultati dell'API sono disponibili per 24 ore dal momento in cui la richiesta è stata inserita e viene indicata nella risposta. Dopo questo periodo di tempo, i risultati vengono eliminati e non sono più disponibili per il recupero.

Recupero dei risultati dell'estrazione di frasi chiave

Quando si ricevono risultati dall'API, l'ordine delle frasi chiave restituite viene determinato internamente dal modello. È possibile trasmettere i risultati a un'applicazione o salvare l'output in un file nel sistema locale.

Limiti relativi a servizi e dati

Per informazioni sulle dimensioni e sul numero di richieste che è possibile inviare al minuto e al secondo, vedere l'articolo sui limiti del servizio .

Passaggi successivi

Panoramica dell'estrazione di frasi chiave