Dela via


Inaktuella kognitiva kunskaper i Azure AI Search

Det här dokumentet beskriver kognitiva färdigheter som anses vara inaktuella (tillbakadragna). Använd följande guide för innehållet:

  • Kunskapsnamn: Namnet på den färdighet som kommer att bli inaktuell; den mappas till attributet @odata.type .
  • Senaste tillgängliga API-version: Den senaste versionen av det offentliga API:et för Azure AI Search genom vilken kompetensuppsättningar som innehåller motsvarande inaktuella kunskaper kan skapas/uppdateras. Indexerare med anslutna kompetensuppsättningar med dessa kunskaper fortsätter att köras även i framtida API-versioner fram till datumet då supporten upphör, då de börjar misslyckas.
  • Supporten upphör: Den dag efter vilken motsvarande kompetens betraktas som ej stödd och slutar fungera. Tidigare skapade kompetensuppsättningar bör fortfarande fortsätta att fungera, men användarna rekommenderas att migrera bort från en inaktuell färdighet.
  • Rekommendationer: Migreringsvägen framåt för att använda en kompetens som stöds. Användarna uppmanas att följa rekommendationerna för att fortsätta få support.

Om du använder Microsoft.Skills.Text.EntityRecognitionSkill (kognitiv skicklighet för entitetsigenkänning (v2)) hjälper den här artikeln dig att uppgradera din kompetensuppsättning till att använda Microsoft.Skills.Text.V3.EntityRecognitionSkill som är allmänt tillgänglig och introducerar nya funktioner.

Om du använder Microsoft.Skills.Text.SentimentSkill (Sentiment cognitive skill (v2)) hjälper den här artikeln dig att uppgradera din kompetensuppsättning till att använda Microsoft.Skills.Text.V3.SentimentSkill som är allmänt tillgänglig och introducerar nya funktioner.

Om du använder Microsoft.Skills.Text.NamedEntityRecognitionSkill (named Entity Recognition cognitive skill (v2)) hjälper den här artikeln dig att uppgradera din kompetensuppsättning till att använda Microsoft.Skills.Text.V3.EntityRecognitionSkill som är allmänt tillgänglig och introducerar nya funktioner.

Microsoft.Skills.Text.EntityRecognitionSkill

Senaste tillgängliga API-version

2021-04-30-Preview

Supporten upphör

31 augusti 2024

Rekommendationer

Använd Microsoft.Skills.Text.V3.EntityRecognitionSkill i stället. Det ger de flesta funktionerna i EntityRecognitionSkill med högre kvalitet. Den har också mer detaljerad information i sina komplexa utdatafält.

Om du vill migrera till Microsoft.Skills.Text.V3.EntityRecognitionSkill gör du en eller flera av följande ändringar i din kompetensdefinition. Du kan uppdatera kunskapsdefinitionen med api:et Update Skillset.

  1. (Krävs) @odata.type Ändra från "#Microsoft.Skills.Text.EntityRecognitionSkill" till "#Microsoft.Skills.Text.V3.EntityRecognitionSkill".

  2. (Valfritt) Parametern includeTypelessEntities stöds inte längre eftersom den nya färdigheten endast returnerar entiteter med kända typer, så om din tidigare kompetensdefinition refererade till den bör den nu tas bort.

  3. (Valfritt) Om du använder namedEntities utdata finns det några mindre ändringar i egenskapsnamnen.

    1. value har bytt namn till text
    2. confidence har bytt namn till confidenceScore

    Om du behöver generera exakt samma egenskapsnamn lägger du till en ShaperSkill för att omforma utdata med de namn som krävs. Den här ShaperSkill byter till exempel namn på egenskaperna till sina gamla värden.

    {
        "@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. (Valfritt) Om du använder entities utdata för att länka entiteter till välkända entiteter är den här funktionen nu en ny färdighet, Microsoft.Skills.Text.V3.EntityLinkingSkill. Lägg till entitetslänkningsfärdigheten till din kompetensuppsättning för att generera de länkade entiteterna. Det finns också några mindre ändringar i egenskapsnamnen för entities utdata mellan EntityRecognitionSkill och den nya EntityLinkingSkill.

    1. wikipediaId har bytt namn till id
    2. wikipediaLanguage har bytt namn till language
    3. wikipediaUrl har bytt namn till url
    4. Egenskaperna type och subtype returneras inte längre.

    Om du behöver generera exakt samma egenskapsnamn lägger du till en ShaperSkill för att omforma utdata med de namn som krävs. Den här ShaperSkill byter till exempel namn på egenskaperna till sina gamla värden.

    {
        "@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. (Valfritt) Om du inte uttryckligen anger categoriesEntityRecognitionSkill V3 kan du returnera olika typer av kategorier förutom de som stöds av EntityRecognitionSkill. Om det här beteendet är oönskat måste du uttryckligen ange parametern categories till ["Person", "Location", "Organization", "Quantity", "Datetime", "URL", "Email"].

    Exempel på migreringsdefinitioner

    • Enkel migrering

      (Före) EntityRecognition-kompetensdefinition

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

      (Efter) 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"
              }
          ]
      }
      
    • Komplicerad migrering

      (Före) EntityRecognition-kompetensdefinition

      {
          "@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"
              }
          ]
      }
      

      (Efter) 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

Senaste tillgängliga API-version

2021-04-30-Preview

Supporten upphör

31 augusti 2024

Rekommendationer

Använd Microsoft.Skills.Text.V3.SentimentSkill i stället. Det ger en förbättrad modell och innehåller alternativet att lägga till åsiktsutvinning eller aspektbaserad attityd. Eftersom färdigheten är betydligt mer komplex är utdata också mycket olika.

Om du vill migrera till Microsoft.Skills.Text.V3.SentimentSkill gör du en eller flera av följande ändringar i din kompetensdefinition. Du kan uppdatera kunskapsdefinitionen med api:et Update Skillset.

Kommentar

Kunskapsutdata för Sentiment Skill V3 är inte kompatibla med indexdefinitionen baserat på SentimentSkill. Du måste göra ändringar i indexdefinitionen, kunskapsuppsättningen (senare kunskapsindata och/eller kunskapslagerprojektioner) och indexerarens utdatafältmappningar för att ersätta attitydfärdigheten med den nya versionen.

  1. (Krävs) @odata.type Ändra från "#Microsoft.Skills.Text.SentimentSkill" till "#Microsoft.Skills.Text.V3.SentimentSkill".

  2. (Krävs) Sentiment Skill V3 ger en positive, neutraloch negative poäng för den övergripande texten och samma poäng för varje mening i den övergripande texten, medan föregående SentimentSkill endast gav en enda dubbel som varierade från 0,0 (negativ) till 1,0 (positiv) för den övergripande texten. Du måste uppdatera indexdefinitionen för att acceptera de tre dubbla värdena i stället för en enskild poäng och se till att alla dina underordnade kunskapsindata, kunskapslagerprojektioner och utdatafältmappningar överensstämmer med namnändringarna.

Vi rekommenderar att du ersätter den gamla SentimentSkill med SentimentSkill V3 helt, uppdaterar dina underordnade kunskapsindata, kunskapslagerprojektioner, indexerarens utdatafältmappningar och indexdefinitionen så att de matchar det nya utdataformatet och återställer indexeraren så att alla dokument har konsekventa sentimentresultat framöver.

Kommentar

Om du behöver ytterligare hjälp med att uppdatera din berikningspipeline för att använda den senaste versionen av attitydfärdigheten, eller om återställning av indexeraren inte är ett alternativ för dig, öppnar du en ny supportbegäran där vi kan arbeta direkt med dig.

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Senaste tillgängliga API-version

2017-11-11-Preview

Supporten upphör

31 augusti 2024

Rekommendationer

Använd Microsoft.Skills.Text.V3.EntityRecognitionSkill i stället. Det ger de flesta av funktionerna i NamedEntityRecognitionSkill med högre kvalitet. Den har också mer detaljerad information i sina komplexa utdatafält.

Om du vill migrera till Microsoft.Skills.Text.V3.EntityRecognitionSkill gör du en eller flera av följande ändringar i din kompetensdefinition. Du kan uppdatera kunskapsdefinitionen med api:et Update Skillset.

  1. (Krävs) @odata.type Ändra från "#Microsoft.Skills.Text.NamedEntityRecognitionSkill" till "#Microsoft.Skills.Text.V3.EntityRecognitionSkill".

  2. (Valfritt) Om du använder entities utdata använder du de namedEntities komplexa samlingsutdata från EntityRecognitionSkill V3 i stället. Det finns några mindre ändringar i egenskapsnamnen för de nya namedEntities komplexa utdata:

    1. value har bytt namn till text
    2. confidence har bytt namn till confidenceScore

    Om du behöver generera exakt samma egenskapsnamn lägger du till en ShaperSkill för att omforma utdata med de namn som krävs. Den här ShaperSkill byter till exempel namn på egenskaperna till sina gamla värden.

    {
        "@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. (Valfritt) Om du inte uttryckligen anger categoriesEntityRecognitionSkill V3 kan du returnera olika typer av kategorier förutom de som stöds av NamedEntityRecognitionSkill. Om det här beteendet är oönskat måste du uttryckligen ange parametern categories till ["Person", "Location", "Organization"].

    Exempel på migreringsdefinitioner

    • Enkel migrering

      (Före) NamedEntityRecognition skill definition

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

      (Efter) 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"
              }
          ]
      }
      
    • Något komplicerad migrering

      (Före) NamedEntityRecognition skill definition

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

      (Efter) 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"
              }
          ]
      }
      

Se även