Come usare il collegamento di entità
La funzionalità di collegamento delle entità può essere usata per identificare e disambiguare l'identità di un'entità trovata nel testo (ad esempio, determinare se un'occorrenza della parola "Marte" si riferisce al pianeta o al dio romano della guerra). Restituirà le entità nel testo con collegamenti a Wikipedia come knowledge base.
Opzioni di sviluppo
Per usare il collegamento di entità, 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 il collegamento di entità:
| 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 il collegamento di entità alle applicazioni usando l'API REST o la libreria client disponibile in un'ampia gamma di lingue. Per altre informazioni, vedere l'avvio rapido sul collegamento di entità. |
Determinare come elaborare i dati (facoltativo)
Specificare il modello di collegamento delle entità
Per impostazione predefinita, il collegamento di entità 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 il collegamento di entità, è possibile specificare le lingue supportate in cui sono scritte. se non si specifica una lingua, per impostazione predefinita il collegamento di entità verrà visualizzato in inglese. A causa del supporto multilingue ed emoji, la risposta può contenere offset di testo.
Invio di dati
Il collegamento di entità produce un risultato di qualità superiore quando si assegna una quantità minore di testo su cui lavorare. Ciò è opposto da alcune funzionalità, ad esempio l'estrazione di frasi chiave, che offre prestazioni migliori su blocchi di testo più grandi. Per ottenere risultati ottimali da entrambe le operazioni, provare a ristrutturare gli input di conseguenza.
Per inviare una richiesta API, è necessario un endpoint della risorsa lingua e una 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 del collegamento di entità 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 viene indicata nella risposta. Dopo questo periodo di tempo, i risultati vengono eliminati e non sono più disponibili per il recupero.
Ottenere i risultati del collegamento di entità
È 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 .