Come usare l'estrazione di frasi chiave
La funzionalità di estrazione di 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 seguirel’articolo nella guida introduttiva 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 e non elaborato per l’analisi e gestire l’output dell'API nell'applicazione. L'analisi viene eseguita così come è, senza alcuna personalizzazione aggiuntiva del 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 usando i propri dati quando si effettua l'iscrizione. Per altre informazioni, vedere il sito Web di Language Studio o la guida introduttiva di Language Studio. |
| API REST o libreria client (SDK di Azure) | 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 l’articolo sull’estrazione di frasi chiave nella guida introduttiva. |
| 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 per altri motivi. |
Determinare come elaborare i dati (facoltativo)
Specificare il modello di estrazione delle frasi chiave
Per impostazione predefinita, l'estrazione di frasi chiave userà il modello di intelligenza artificiale più recente disponibile 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 sono scritte. Se non si specifica una lingua, per impostazione predefinita le frasi chiave verranno estratte in 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, sono necessari un endpoint della risorsa Lingua e una chiave.
Nota
È possibile trovare la chiave e l'endpoint della risorsa lingua nel portale di Azure Si trovano 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 di frasi chiave in modo sincrono è 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 ciò viene indicato nella risposta. Dopo questo periodo di tempo, i risultati vengono rimossi e non sono più disponibili per il recupero.
Ottenere i 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 al servizio e ai dati
Vedere l'articolo sui limiti del servizio per informazioni sulle dimensioni e il numero di richieste che è possibile inviare al minuto e al secondo.