Modifiche apportate all’API di anteprima
Usare questo articolo per ottenere una panoramica delle nuove modifiche API introdotte a partire dalla versione 2024-11-01. Questa modifica API introduce principalmente due nuovi concetti (entity types e entity tags) sostituendo i campi category e subcategory nell'API attualmente disponibile a livello generale. Una panoramica dettagliata di ogni parametro API e delle versioni API supportate a cui corrisponde è disponibile nella pagina [Parametri competenza][../how-to/skill-parameters.md]
Tipi di entità
I tipi di entità rappresentano la granularità minima (o migliore) in base alla quale l'entità è stata rilevata e possono quindi essere considerati la classe di base rilevata.
Tag di entità
I tag di entità vengono usati per identificare ulteriormente un'entità; un'entità rilevata viene contrassegnata dal tipo di entità e da tag aggiuntivi per distinguere l'entità identificata. L'elenco di tag di entità deve generalmente includere categorie, sottocategorie e così via.
Modifiche dalle versioni 2022-05-01 e 2023-04-01 all'API della versione 2024-11-01
Le modifiche rendono più flessibile il servizio di riconoscimento delle entità denominate, tra cui:
Aggiornamenti alla struttura dei formati di input: • InclusionList • ExclusionList • Criteri di sovrapposizione
Aggiornamenti alla gestione dei formati di output:
- Riconoscimento più granulare degli output di riconoscimento delle entità tramite l'introduzione dell'elenco di tag in cui un'entità può essere contrassegnata da più tag di entità.
- Entità sovrapposte in cui le entità possono essere riconosciute come più tipi di entità e, in tal caso, tale entità viene restituita due volte. Se un'entità è stata riconosciuta come appartenente a due tag di entità nello stesso tipo di entità, nell’elenco dei tag vengono restituiti entrambi i tag di entità.
- Filtrare le entità usando i tag di entità. Per altre informazioni, passare a questo articolo.
- Oggetti metadati che contengono informazioni aggiuntive sull'entità, ma che attualmente fungono solo da wrapper per la funzionalità di risoluzione delle entità esistente. Altre informazioni su questa nuova funzionalità sono disponibili qui.
Versioni 2022-05-01 e 2023-04-01 mapping delle entità dell'API versione corrente
È possibile visualizzare un confronto tra la struttura delle categorie o i tipi di entità nell'articolo Categorie di entità e tipi di entità di Riconoscimento entità denominata supportati. Di seguito è riportata una tabella che descrive i mapping tra i risultati previsti per le versioni 2022-05-01 e 2023-04-01 l'API della versione corrente.
| Type | Tag |
|---|---|
| Data | Temporal, Date |
| DateRange | Temporal, DateRange |
| Data/Ora | Temporal, DateTime |
| DateTimeRange | Temporal, DateTimeRange |
| Durata | Temporal, Duration |
| SetTemporal | Temporal, SetTemporal |
| Ora | Temporal, Time |
| Intervallo di tempo | Temporal, TimeRange |
| Città | GPE, Location, City |
| Provincia | GPE, Location, State |
| CountryRegion | GPE, Location, CountryRegion |
| Continente | GPE, Location, Continent |
| GPE | Location, GPE |
| Ufficio | Ufficio |
| Airport | Structural, Location |
| Structural | Location, Structural |
| Geological | Location, Geological |
| Età | Numeric, Age |
| Valuta | Numeric, Currency |
| Numero | Numeric, Number |
| PhoneNumber | PhoneNumber |
| NumberRange | Numeric, NumberRange |
| Percentuale | Numeric, Percentage |
| Ordinale | Numeric, Ordinal |
| Temperatura | Numeric, Dimension, Temperature |
| Velocità | Numeric, Dimension, Speed |
| Peso | Numeric, Dimension, Weight |
| Altezza | Numeric, Dimension, Height |
| Length | Numeric, Dimension, Length |
| Volume | Numeric, Dimension, Volume |
| Area | Numeric, Dimension, Area |
| Informazioni | Numeric, Dimension, Information |
| Address | Address |
| Persona | Persona |
| PersonType | PersonType |
| Organizzazione | Organizzazione |
| Prodotto | Prodotto |
| ComputingProduct | Product, ComputingProduct |
| IP | IP |
| URL | URL |
| Competenza | Competenza |
| Event | Event |
| CulturalEvent | Event, CulturalEvent |
| SportsEvent | Event, SportsEvent |
| NaturalEvent | Event, NaturalEvent |