Veraltete kognitive Fähigkeiten in Foundry IQ (Azure KI-Suche)

Hinweis

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.

Dieses Dokument beschreibt kognitive Fähigkeiten, die als veraltet (im Ruhestand) gelten. Verwenden Sie für den Inhalt die folgende Anleitung:

  • Fähigkeitsname: Der Name der Fähigkeit, die überholt werden soll; sie wird dem @odata.type-Attribut zugeordnet.
  • Letzte verfügbare API-Version: Die letzte Version der öffentlichen Azure KI-Suche-API, über die Skillsets mit den entsprechenden veralteten Fähigkeiten erstellt/aktualisiert werden können. Indexer mit angefügten Skillsets, deren Skills auch in zukünftigen API-Versionen bis zum Ende des Supports ausgeführt werden, ab diesem Datum dann aber zu Fehlern führen.
  • Ende des Supports: Der Tag, nach dem der entsprechende Skill als nicht mehr unterstützt gilt und nicht mehr funktioniert. Vorher erstellte Qualifikationsgruppen sollten funktionsfähig bleiben. Benutzern wird jedoch empfohlen, von der als veraltet markierten Qualifikation zu einer anderen zu migrieren.
  • Empfehlungen: Migrationspfad zur Verwendung einer unterstützten Fähigkeit. Benutzern wird empfohlen, den Empfehlungen zu folgen, um weiterhin Support zu erhalten.

Wenn Sie Microsoft.Skills.Text.EntityRecognitionSkill (kognitiver Skill zur Entitätserkennung (v2)) verwenden, hilft Ihnen dieser Artikel dabei, Ihr Skillset zu aktualisieren, um Microsoft.Skills.Text.V3.EntityRecognitionSkill zu verwenden, das allgemein verfügbar ist und neue Features einführt.

Wenn Sie Microsoft.Skills.Text.SentimentSkill (kognitiver Stimmungsskill (v2)) verwenden, hilft Ihnen dieser Artikel dabei, Ihr Skillset zu aktualisieren, um Microsoft.Skills.Text.V3.SentimentSkill zu verwenden, das allgemein verfügbar ist und neue Features einführt.

Wenn Sie Microsoft.Skills.Text.NamedEntityRecognitionSkill (kognitiver Skill zur Erkennung benannter Entitäten (v2)) verwenden, hilft Ihnen dieser Artikel dabei, Ihr Skillset zu aktualisieren, um Microsoft.Skills.Text.V3.EntityRecognitionSkill zu verwenden, das allgemein verfügbar ist und neue Features einführt.

Microsoft.Skills.Text.EntityRecognitionSkill

Letzte verfügbare API-Version

2021-04-30-Preview

Ende des Supports

31. August 2024

Empfehlungen

Verwenden Sie stattdessen Microsoft.Skills.Text.V3.EntityRecognitionSkill. Dieser Skill enthält die meisten Funktionen von EntityRecognitionSkill, jedoch mit höherer Qualität. Die komplexen Ausgabefelder enthalten zudem umfangreichere Informationen.

Um zu Microsoft.Skills.Text.V3.EntityRecognitionSkill zu migrieren, müssen Sie eine oder mehrere der folgenden Änderungen an Ihrer Skilldefinition vornehmen. Ein Update der Qualifikationsdefinition können Sie mit der API zum Aktualisieren von Qualifikationsgruppen vornehmen.

  1. (Erforderlich) Ändern Sie den @odata.type Von "#Microsoft.Skills.Text.EntityRecognitionSkill" in "#Microsoft.Skills.Text.V3.EntityRecognitionSkill".

  2. (Optional) Der includeTypelessEntities Parameter wird nicht mehr unterstützt, da die neue Fähigkeit nur Entitäten mit bekannten Typen zurückgibt. Wenn also ihre vorherige Qualifikationsdefinition darauf verweist, sollte sie jetzt entfernt werden.

  3. (Optional) Wenn Sie die namedEntities Ausgabe verwenden, gibt es einige kleinere Änderungen an den Eigenschaftennamen.

    1. value wird umbenannt in text
    2. confidence wird umbenannt in confidenceScore

    Wenn Sie genau die gleichen Eigenschaftennamen generieren müssen, fügen Sie einen ShaperSkill hinzu, um die Ausgabe mit den erforderlichen Namen umzugestalten. Beispielsweise benennt dieser ShaperSkill die Eigenschaften in ihre alten Werte um.

    {
        "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
        "name": "NamedEntitiesShaper",
        "description": "NamedEntitiesShaper",
        "context": "/document/namedEntitiesV3",
        "inputs": [
            {
                "name": "old_format",
                "sourceContext": "/document/namedEntitiesV3/*",
                "inputs": [
                    {
                        "name": "value",
                        "source": "/document/namedEntitiesV3/*/text"
                    },
                    {
                        "name": "offset",
                        "source": "/document/namedEntitiesV3/*/offset"
                    },
                    {
                        "name": "category",
                        "source": "/document/namedEntitiesV3/*/category"
                    },
                    {
                        "name": "confidence",
                        "source": "/document/namedEntitiesV3/*/confidenceScore"
                    }
                ]
            }
        ],
        "outputs": [
            {
                "name": "output",
                "targetName": "namedEntities"
            }
        ]
    }
    
  4. (Optional) Wenn Sie die entities Ausgabe verwenden, um Entitäten mit bekannten Entitäten zu verknüpfen, ist dieses Feature jetzt eine neue Fähigkeit, die Microsoft. Skills.Text.V3.EntityLinkingSkill. Fügen Sie Ihrem Skillset den Skill zur Entitätsverknüpfung hinzu, um die verknüpften Entitäten zu generieren. Es gibt auch einige geringfügige Änderungen an den Eigenschaftennamen der Ausgabe entities zwischen EntityRecognitionSkill und dem neuen EntityLinkingSkill.

    1. wikipediaId wird umbenannt in id
    2. wikipediaLanguage wird umbenannt in language
    3. wikipediaUrl wird umbenannt in url
    4. Die Eigenschaften type und subtype werden nicht mehr zurückgegeben.

    Wenn Sie genau die gleichen Eigenschaftennamen generieren müssen, fügen Sie einen ShaperSkill hinzu, um die Ausgabe mit den erforderlichen Namen umzugestalten. Beispielsweise benennt dieser ShaperSkill die Eigenschaften in ihre alten Werte um.

    {
        "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
        "name": "LinkedEntitiesShaper",
        "description": "LinkedEntitiesShaper",
        "context": "/document/linkedEntitiesV3",
        "inputs": [
            {
                "name": "old_format",
                "sourceContext": "/document/linkedEntitiesV3/*",
                "inputs": [
                    {
                        "name": "name",
                        "source": "/document/linkedEntitiesV3/*/name"
                    },
                    {
                        "name": "wikipediaId",
                        "source": "/document/linkedEntitiesV3/*/id"
                    },
                    {
                        "name": "wikipediaLanguage",
                        "source": "/document/linkedEntitiesV3/*/language"
                    },
                    {
                        "name": "wikipediaUrl",
                        "source": "/document/linkedEntitiesV3/*/url"
                    },
                    {
                        "name": "bingId",
                        "source": "/document/linkedEntitiesV3/*/bingId"
                    },
                    {
                        "name": "matches",
                        "source": "/document/linkedEntitiesV3/*/matches"
                    }
                ]
            }
        ],
        "outputs": [
            {
                "name": "output",
                "targetName": "entities"
            }
        ]
    }
    
  5. (Optional) Wenn Sie den categoriesWert nicht explizit angeben, kann der EntityRecognitionSkill V3 unterschiedliche Typ von Kategorien zusätzlich zu den Kategorien zurückgegeben werden, die von der EntityRecognitionSkillBetreffenden unterstützt wurden. Wenn dieses Verhalten nicht erwünscht ist, müssen Sie den Parameter categories explizit auf ["Person", "Location", "Organization", "Quantity", "Datetime", "URL", "Email"] festlegen.

    Beispielmigrationsdefinitionen

    • Einfache Migration

      (Vorher) EntityRecognition-Qualifikationsdefinition

      {   
          "@odata.type": "#Microsoft.Skills.Text.EntityRecognitionSkill",
          "categories": [ "Person" ],
          "defaultLanguageCode": "en",
          "inputs": [
              {
                  "name": "text",
                  "source": "/document/content"
              }
          ],
          "outputs": [
              {
                  "name": "persons",
                  "targetName": "people"
              }
          ]
      }
      

      (Nach) EntityRecognition Skill V3-Definition

      {
          "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
          "categories": [ "Person" ],
          "defaultLanguageCode": "en",
          "inputs": [
              {
                  "name": "text",
                  "source": "/document/content"
              }
          ],
          "outputs": [
              {
                  "name": "persons",
                  "targetName": "people"
              }
          ]
      }
      
    • Komplizierte Migration

      (Vorher) EntityRecognition-Qualifikationsdefinition

      {
          "@odata.type": "#Microsoft.Skills.Text.EntityRecognitionSkill",
          "categories": [ "Person", "Location", "Organization" ],
          "defaultLanguageCode": "en",
          "minimumPrecision": 0.1,
          "includeTypelessEntities": true,
          "inputs": [
              {
                  "name": "text",
                  "source": "/document/content"
              }
          ],
          "outputs": [
              {
                  "name": "persons",
                  "targetName": "people"
              },
              {
                  "name": "namedEntities",
                  "targetName": "namedEntities"
              },
              {
                  "name": "entities",
                  "targetName": "entities"
              }
          ]
      }
      

      (Nach) EntityRecognition Skill V3-Definition

      {
          "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
          "categories": [ "Person", "Location", "Organization" ],
          "defaultLanguageCode": "en",
          "minimumPrecision": 0.1,
          "inputs": [
              {
                  "name": "text",
                  "source": "/document/content"
              }
          ],
          "outputs": [
              {
                  "name": "persons",
                  "targetName": "people"
              },
              {
                  "name": "namedEntities",
                  "targetName": "namedEntitiesV3"
              }
          ]
      },
      {
          "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
          "name": "NamedEntitiesShaper",
          "description": "NamedEntitiesShaper",
          "context": "/document/namedEntitiesV3",
          "inputs": [
              {
                  "name": "old_format",
                  "sourceContext": "/document/namedEntitiesV3/*",
                  "inputs": [
                      {
                          "name": "value",
                          "source": "/document/namedEntitiesV3/*/text"
                      },
                      {
                          "name": "offset",
                          "source": "/document/namedEntitiesV3/*/offset"
                      },
                      {
                          "name": "category",
                          "source": "/document/namedEntitiesV3/*/category"
                      },
                      {
                          "name": "confidence",
                          "source": "/document/namedEntitiesV3/*/confidenceScore"
                      }
                  ]
              }
          ],
          "outputs": [
              {
                  "name": "output",
                  "targetName": "namedEntities"
              }
          ]
      },
      {
          "@odata.type": "#Microsoft.Skills.Text.V3.EntityLinkingSkill",
          "defaultLanguageCode": "en",
          "minimumPrecision": 0.1,
          "inputs": [
              {
                  "name": "text",
                  "source": "/document/content"
              }
          ],
          "outputs": [
              {
                  "name": "entities",
                  "targetName": "linkedEntities"
              }
          ]
      },
      {
          "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
          "name": "LinkedEntitiesShaper",
          "description": "LinkedEntitiesShaper",
          "context": "/document/linkedEntitiesV3",
          "inputs": [
              {
                  "name": "old_format",
                  "sourceContext": "/document/linkedEntitiesV3/*",
                  "inputs": [
                      {
                          "name": "name",
                          "source": "/document/linkedEntitiesV3/*/name"
                      },
                      {
                          "name": "wikipediaId",
                          "source": "/document/linkedEntitiesV3/*/id"
                      },
                      {
                          "name": "wikipediaLanguage",
                          "source": "/document/linkedEntitiesV3/*/language"
                      },
                      {
                          "name": "wikipediaUrl",
                          "source": "/document/linkedEntitiesV3/*/url"
                      },
                      {
                          "name": "bingId",
                          "source": "/document/linkedEntitiesV3/*/bingId"
                      },
                      {
                          "name": "matches",
                          "source": "/document/linkedEntitiesV3/*/matches"
                      }
                  ]
              }
          ],
          "outputs": [
              {
                  "name": "output",
                  "targetName": "entities"
              }
          ]
      }
      

Microsoft.Skills.Text.SentimentSkill

Letzte verfügbare API-Version

2021-04-30-Preview

Ende des Supports

31. August 2024

Empfehlungen

Verwenden Sie stattdessen Microsoft.Skills.Text.V3.SentimentSkill. Er bietet ein verbessertes Modell und die Möglichkeit, Opinion Mining oder eine aspektbasierte Stimmung hinzuzufügen. Da der Skill erheblich komplexer ist, unterscheiden sich auch die Ausgaben stark.

Um zu Microsoft.Skills.Text.V3.SentimentSkill zu migrieren, müssen Sie eine oder mehrere der folgenden Änderungen an Ihrer Skilldefinition vornehmen. Ein Update der Qualifikationsdefinition können Sie mit der API zum Aktualisieren von Qualifikationsgruppen vornehmen.

Hinweis

Die Skillausgaben für „V3.SentimentSkill“ sind nicht mit der Indexdefinition kompatibel, die auf „SentimentSkill“ basiert. Sie müssen an der Indexdefinition, dem Skillset (spätere Skilleingaben und/oder Wissensspeicherprojektionen) und den Feldzuordnungen der Indexerausgabe Änderungen vornehmen, um den Stimmungsskill durch die neue Version zu ersetzen.

  1. (Erforderlich) Ändern Sie den @odata.type Von "#Microsoft.Skills.Text.SentimentSkill" in "#Microsoft.Skills.Text.V3.SentimentSkill".

  2. (Erforderlich) Der Sentiment Skill V3 bietet einen positive, neutralund negative eine Punktzahl für den Gesamttext und die gleichen Punkte für jeden Satz im Gesamttext, während der vorherige SentimentSkill nur einen einzigen Doppelwert bereitgestellt hat, der zwischen 0,0 (negativ) und 1,0 (positiv) für den Gesamttext reicht. Sie müssen Ihre Indexdefinition aktualisieren, um die drei doppelten Werte anstelle einer einzelnen Bewertung zu akzeptieren, und stellen Sie sicher, dass alle nachgeschalteten Eingaben, Wissensspeicherprojektionen und Ausgabefeldzuordnungen mit den Benennungsänderungen übereinstimmen.

Es wird empfohlen, den alten „SentimentSkill“ vollständig durch „V3.SentimentSkill“ zu ersetzen, Ihre Downstream-Skilleingaben, Wissensspeicherprojektionen, Feldzuordnungen der Indexerausgabe und Indexdefinitionen so zu aktualisieren, dass sie dem neuen Ausgabeformat entsprechen, und den Indexer zurückzusetzen, damit alle Ihre Dokumente in Zukunft konsistente Stimmungsergebnisse erhalten.

Hinweis

Wenn Sie weitere Hilfe beim Aktualisieren Ihrer Anreicherungspipeline benötigen, um die neueste Version der Sentiment-Analysetechnologie zu verwenden, oder wenn das Zurücksetzen Ihres Indexers keine Option für Sie ist, öffnen Sie eine neue Supportanfrage, in der wir direkt mit Ihnen zusammenarbeiten können.

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Letzte verfügbare API-Version

Vorschauversion vom 11.11.2017

Ende des Supports

31. August 2024

Empfehlungen

Verwenden Sie stattdessen Microsoft.Skills.Text.V3.EntityRecognitionSkill. Diese Qualifikation enthält die meisten Funktionen von „NamedEntityRecognitionSkill“, jedoch mit höherer Qualität. Die komplexen Ausgabefelder enthalten zudem umfangreichere Informationen.

Um zu Microsoft.Skills.Text.V3.EntityRecognitionSkill zu migrieren, müssen Sie eine oder mehrere der folgenden Änderungen an Ihrer Skilldefinition vornehmen. Ein Update der Qualifikationsdefinition können Sie mit der API zum Aktualisieren von Qualifikationsgruppen vornehmen.

  1. (Erforderlich) Ändern Sie den @odata.type Von "#Microsoft.Skills.Text.NamedEntityRecognitionSkill" in "#Microsoft.Skills.Text.V3.EntityRecognitionSkill".

  2. (Optional) Wenn Sie die entities Ausgabe verwenden, verwenden Sie stattdessen die namedEntities komplexe Sammlungsausgabe EntityRecognitionSkill V3 . Es gibt auch einige geringfügige Änderungen an den Eigenschaftennamen der neuen komplexen Ausgabe von namedEntities:

    1. value wird umbenannt in text
    2. confidence wird umbenannt in confidenceScore

    Wenn Sie genau die gleichen Eigenschaftennamen generieren müssen, fügen Sie einen ShaperSkill hinzu, um die Ausgabe mit den erforderlichen Namen umzugestalten. Beispielsweise benennt dieser ShaperSkill die Eigenschaften in ihre alten Werte um.

    {
        "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
        "name": "NamedEntitiesShaper",
        "description": "NamedEntitiesShaper",
        "context": "/document/namedEntities",
        "inputs": [
            {
                "name": "old_format",
                "sourceContext": "/document/namedEntities/*",
                "inputs": [
                    {
                        "name": "value",
                        "source": "/document/namedEntities/*/text"
                    },
                    {
                        "name": "offset",
                        "source": "/document/namedEntities/*/offset"
                    },
                    {
                        "name": "category",
                        "source": "/document/namedEntities/*/category"
                    },
                    {
                        "name": "confidence",
                        "source": "/document/namedEntities/*/confidenceScore"
                    }
                ]
            }
        ],
        "outputs": [
            {
                "name": "output",
                "targetName": "entities"
            }
        ]
    }
    
  3. (Optional) Wenn Sie den categoriesWert nicht explizit angeben, kann dies EntityRecognitionSkill V3 einen anderen Typ von Kategorie als diejenigen zurückgeben, die von der NamedEntityRecognitionSkill. Wenn dieses Verhalten nicht erwünscht ist, müssen Sie den Parameter categories explizit auf ["Person", "Location", "Organization"] festlegen.

    Beispielmigrationsdefinitionen

    • Einfache Migration

      (Vorher) NamedEntityRecognition Qualifikationsdefinition

      {
          "@odata.type": "#Microsoft.Skills.Text.NamedEntityRecognitionSkill",
          "categories": [ "Person" ],
          "defaultLanguageCode": "en",
          "inputs": [
              {
                  "name": "text",
                  "source": "/document/content"
              }
          ],
          "outputs": [
              {
                  "name": "persons",
                  "targetName": "people"
              }
          ]
      }
      

      (Nach) EntityRecognition Skill V3-Definition

      {
          "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
          "categories": [ "Person" ],
          "defaultLanguageCode": "en",
          "inputs": [
              {
                  "name": "text",
                  "source": "/document/content"
              }
          ],
          "outputs": [
              {
                  "name": "persons",
                  "targetName": "people"
              }
          ]
      }
      
    • Etwas kompliziertere Migration

      (Vorher) NamedEntityRecognition Qualifikationsdefinition

      {
          "@odata.type": "#Microsoft.Skills.Text.NamedEntityRecognitionSkill",
          "defaultLanguageCode": "en",
          "minimumPrecision": 0.1,
          "inputs": [
              {
                  "name": "text",
                  "source": "/document/content"
              }
          ],
          "outputs": [
              {
                  "name": "persons",
                  "targetName": "people"
              },
              {
                  "name": "entities"
              }
          ]
      }
      

      (Nach) EntityRecognition Skill V3-Definition

      {
          "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
          "categories": [ "Person", "Location", "Organization" ],
          "defaultLanguageCode": "en",
          "minimumPrecision": 0.1,
          "inputs": [
              {
                  "name": "text",
                  "source": "/document/content"
              }
          ],
          "outputs": [
              {
                  "name": "persons",
                  "targetName": "people"
              },
              {
                  "name": "namedEntities"
              }
          ]
      },
      {
          "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
          "name": "NamedEntitiesShaper",
          "description": "NamedEntitiesShaper",
          "context": "/document/namedEntities",
          "inputs": [
              {
                  "name": "old_format",
                  "sourceContext": "/document/namedEntities/*",
                  "inputs": [
                      {
                          "name": "value",
                          "source": "/document/namedEntities/*/text"
                      },
                      {
                          "name": "offset",
                          "source": "/document/namedEntities/*/offset"
                      },
                      {
                          "name": "category",
                          "source": "/document/namedEntities/*/category"
                      },
                      {
                          "name": "confidence",
                          "source": "/document/namedEntities/*/confidenceScore"
                      }
                  ]
              }
          ],
          "outputs": [
              {
                  "name": "output",
                  "targetName": "entities"
              }
          ]
      }
      

Weitere Informationen