Come usare il collegamento delle entità

La funzionalità di collegamento delle entità può essere usata per identificare e disambiguare l'identità di un'entità trovata nel testo (ad esempio, per determinare se una 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 delle entità, 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 il collegamento delle 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 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 (Azure SDK) Integrare il collegamento delle entità nelle applicazioni usando l'API REST o la libreria client disponibile in un'ampia gamma di lingue. Per altre informazioni, vedere l’argomento collegamento delle entità nella guida introduttiva.

Determinare come elaborare i dati (facoltativo)

Specificare il modello di collegamento delle entità

Per impostazione predefinita, il collegamento delle 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 delle entità, è possibile specificare le lingue supportate in cui sono scritte. Se non si specifica una lingua, per impostazione predefinita il collegamento delle entità verrà impostato sull'inglese. A causa del supporto multilingue ed emoji, la risposta può contenere offset di testo.

Invio di dati

Il collegamento delle entità produce un risultato di qualità superiore quando si assegna una quantità minore di testo su cui lavorare, a differenza di alcune funzionalità, come 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, 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 del collegamento delle 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 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 del collegamento delle entità

È 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.

Vedi anche