Entitetstyper och taggar

Använd den här artikeln om du vill få en översikt över de nya API-ändringarna från och med version 2024-11-01. Den här API-ändringen introducerar främst två nya begrepp (entity types och entity tags) som ersätter fälten category och subcategory i det aktuella allmänt tillgängliga API:et. En detaljerad översikt över varje API-parameter och de API-versioner som stöds finns på [Skill Parameters][.. Sidan /how-to/skill-parameters.md].

Eftersom en entitet som "Seattle" kan klassificeras som en stad, GPE (geo politisk entitet) och en plats type , används attributet för att definiera den mest detaljerade klassificeringen, i det här fallet City. Attributet tags i tjänstutdata är en lista över alla möjliga klassificeringar (Stad, GPE och Plats) och deras respektive konfidenspoäng. En fullständig mappning av möjliga taggar för varje typ finns nedan. Attributen metadata i tjänstutdata innehåller ytterligare information om entiteten, till exempel det heltalsvärde som är associerat med entiteten.

Entitetstyper

Entitetstyper representerar den lägsta (eller finaste) kornigheten där entiteten har identifierats och kan anses vara den basklass som har identifierats.

Entitetstaggar

Entitetstaggar används för att ytterligare identifiera en entitet där en identifierad entitet taggas av entitetstypen och ytterligare taggar för att särskilja den identifierade entiteten. Listan med entitetstaggar kan anses innehålla kategorier, underkategorier, underkategorier och så vidare.

Ändringar från versioner 2022-05-01 och 2023-04-01 till versions-API 2024-11-01

Ändringarna ger bättre flexibilitet för den namngivna entitetsigenkänningstjänsten, inklusive:

Uppdateringar av strukturen för indataformat: • Inkluderingslista • Exkluderingslista • Överlappningsprincip

Uppdateringar av hanteringen av utdataformat:

• Fler detaljerade entitetsigenkänningsutdata genom att introducera listan med taggar där en entitet kan taggas av mer än en entitetstagg.
• Överlappande entiteter där entiteter kan identifieras som mer än en entitetstyp och i så fall returneras den här entiteten två gånger. Om en entitet identifierades tillhöra två entitetstaggar under samma entitetstyp returneras båda entitetstaggar i listan med taggar.
• Om du filtrerar entiteter med hjälp av entitetstaggar kan du lära dig mer om detta genom att gå till den här artikeln.
• Metadataobjekt som innehåller ytterligare information om entiteten men som för närvarande endast fungerar som omslutning för den befintliga entitetsmatchningsfunktionen. Du kan läsa mer om den här nya funktionen här.

Versioner 2022-05-01 och 2023-04-01 till api-entitetsmappningar för aktuell version

Du kan se en jämförelse av strukturen för entitetskategorier och typer i artikeln Stödda kategorier och typer för namngiven entitetsigenkänning (NER). Nedan visas en tabell som beskriver mappningarna mellan de resultat som du förväntar dig att se från versioner 2022-05-01 och 2023-04-01 och det aktuella versions-API:et.