Kognitiver Skill „Entitätsverknüpfung“ (v3)

Note

Foundry IQ (Azure KI-Suche) bietet direkte Indizierungs- und Abfrage-APIs zusammen mit Wissensquellen- und Knowledge Base-APIs auf höherer Ebene für den verwalteten Abruf. Verwenden Sie das Azure Portal, REST-APIs oder Azure SDKs, um diese Funktionen zu konfigurieren, oder verbinden Sie Agents mit Wissensdatenbanken im Microsoft Foundry-Portal.

Der Skill Entitätsverknüpfung (v3) gibt eine Liste der erkannten Entitäten mit Links zu Artikeln in einer bekannten Wissensdatenbank (Wikipedia) zurück.

Note

Diese Fähigkeit ist an die Entitätsverknüpfung von Machine Learning-Modellen in Azure Vision in Foundry Tools gebunden. Für Transaktionen, die mehr als 20 Dokumente pro Indexer pro Tag überschreiten, ist eine abrechnungsfähige Ressource erforderlich. Die Ausführung der integrierten Fähigkeiten wird zum bestehenden Foundry Tools Standard-Preis berechnet.

@odata.type

Microsoft.Skills.Text.V3.EntityLinkingSkill

Datenlimits

Die maximale Größe eines Datensatzes beträgt 50.000 Zeichen (gemessen durch String.Length). Wenn Sie Ihre Daten vor dem Senden an den Skill „Entitätsverknüpfung“ aufteilen müssen, denken Sie daran, den Skill „Textaufteilung“ zu verwenden. Wenn Sie einen Textteilungs-Skill verwenden, legen Sie die Seitenlänge auf 5000 fest, um die beste Leistung zu erzielen.

Qualifikationsparameter

Bei den Parameternamen, die alle optional sind, muss die Groß-/Kleinschreibung beachtet werden.

Parametername Description
defaultLanguageCode Sprachcode des Eingabetexts. Wenn der Standardsprachencode nicht angegeben ist, wird Englisch (en) als Standardsprachencode verwendet.
Siehe die vollständige Liste der unterstützten Sprachen.
minimumPrecision Ein Wert zwischen 0 und 1 ein. Wenn die Konfidenzbewertung (in der entities Ausgabe) niedriger als dieser Wert ist, wird die Entität nicht zurückgegeben. Der Standardwert ist 0.
modelVersion (Optional) Gibt die Version des Modells an, die beim Aufruf der Entitätsverknüpfung verwendet wird. Sie wird standardmäßig auf die neueste verfügbare Version festgelegt, wenn sie nicht angegeben ist. Es wird empfohlen, diesen Wert nicht anzugeben, es sei denn, es ist erforderlich.

Qualifikationseingaben

Eingabename Description
languageCode Eine Zeichenfolge, die die Sprache der Datensätze angibt. Wenn dieser Parameter nicht angegeben ist, wird der Standardsprachencode verwendet, um die Datensätze zu analysieren.
Siehe die vollständige Liste der unterstützten Sprachen.
text Der zu analysierende Text

Skill-Ergebnisse

Ausgabename Description
entities Ein Array mit komplexen Typen und den folgenden Feldern:
  • "name" (Der tatsächliche Entitätsname, wie er im Text angezeigt wird)
  • "id"
  • "language" (Die Sprache des Texts, die durch die Fähigkeit bestimmt wird)
  • "url" (Die verknüpfte URL mit dieser Entität)
  • „bingId“ (die Bing-ID für diese verknüpfte Entität)
  • "dataSource" (Die Datenquelle, die der URL zugeordnet ist)
  • "matches" (Ein Array komplexer Typen, die Folgendes enthalten: text, offset, length und confidenceScore)

Beispieldefinition

  {
    "@odata.type": "#Microsoft.Skills.Text.V3.EntityLinkingSkill",
    "context": "/document",
    "defaultLanguageCode": "en", 
    "minimumPrecision": 0.5, 
    "inputs": [
        {
            "name": "text", 
            "source": "/document/content"
        },
        {
            "name": "languageCode", 
            "source": "/document/language"
        }
    ],
    "outputs": [
        {
            "name": "entities", 
            "targetName": "entities" 
        }
    ]
}

Beispieleingabe

{
    "values": [
      {
        "recordId": "1",
        "data":
           {
             "text": "Microsoft is liked by many.",
             "languageCode": "en"
           }
      }
    ]
}

Beispielausgabe

{
  "values": [
    {
      "recordId": "1",
      "data" : 
      {
        "entities": [
          {
            "name": "Microsoft", 
            "id": "Microsoft",
            "language": "en", 
            "url": "https://en.wikipedia.org/wiki/Microsoft", 
            "bingId": "a093e9b9-90f5-a3d5-c4b8-5855e1b01f85", 
            "dataSource": "Wikipedia", 
            "matches": [
                {
                    "text": "Microsoft", 
                    "offset": 0, 
                    "length": 9, 
                    "confidenceScore": 0.13 
                }
            ]
          }
        ],
      }
    }
  ]
}

Die für Entitäten in der Ausgabe dieser Fähigkeit zurückgegebenen Offsets werden direkt von den Sprachdienst-APIs zurückgegeben, was bedeutet, dass Sie, wenn Sie sie zum Indizieren in die ursprüngliche Zeichenfolge verwenden, die StringInfo-Klasse in .NET verwenden, um den richtigen Inhalt zu extrahieren. Weitere Informationen finden Sie unter Mehrsprachige und Emoji-Unterstützung in Sprachdienstfeatures.

Warnungsfälle

Wird der Sprachcode für das Dokument nicht unterstützt, wird eine Warnung zurückgegeben, und es werden keine Entitäten extrahiert.

Siehe auch