已棄用的 Foundry IQ 認知技能(Azure AI 搜尋服務)

附註

Foundry IQ(Azure AI 搜尋服務)提供直接的索引與查詢 API,並搭配高階知識來源與知識庫 API 用於受控檢索。 使用 Azure 入口網站、REST API 或 Azure SDK 來設定這些功能,或將代理程式連接到 Microsoft Foundry 入口網站中的知識庫。

本文件說明已淘汰的認知技能。 請將以下指南用於這些內容:

  • 技能名稱:將被棄用的技能名稱,它會對應到@odata.type屬性。
  • 最後可用 API 版本:Azure AI 搜尋服務 公開 API 的最後版本,透過此可建立或更新包含相應棄用技能的技能集。 索引子如果有附加這些技能的技能集,仍可在未來的 API 版本繼續執行,直到「終止支援」日期為止,屆時就會開始執行失敗。
  • 終止支援:當天起,對應的技能將不再提供支援且會停止運作。 之前建立的技能集仍應可繼續運作,但建議使用者棄用淘汰的技能。
  • 建議:遷移至使用受支援的技能之路徑。 請使用者遵循建議以繼續接收支援。

如果您使用 Microsoft.Skills.Text.EntityRecognitionSkill (實體辨識認知技能 (v2)),本文可協助您升級技能集,以便使用已正式推出且引進新功能的 Microsoft.Skills.Text.V3.EntityRecognitionSkill。

如果您使用 Microsoft.Skills.Text.SentimentSkill (情感認知技能 (v2)),本文可協助您升級技能集,以便使用已正式推出且引進新功能的 Microsoft.Skills.Text.V3.SentimentSkill。

如果您使用 Microsoft.Skills.Text.NamedEntityRecognitionSkill (具名實體辨識認知技能 (v2)),本文可協助您升級技能集,以便使用已正式推出且引進新功能的 Microsoft.Skills.Text.V3.EntityRecognitionSkill。

Microsoft.Skills.Text.EntityRecognitionSkill

最後可用的 API 版本

2021-04-30-Preview

結束支援

2024 年 8 月 31 日

建議

請改用 Microsoft.Skills.Text.V3.EntityRecognitionSkill。 它以更好的品質提供 EntityRecognitionSkill 的多數功能。 它複雜的輸出欄位也提供更豐富的資訊。

若要移轉至 Microsoft.Skills.Text.V3.EntityRecognitionSkill,請對技能定義進行下列一或多項變更。 您可以使用更新技能集 API 來更新技能定義。

  1. (必填)將 從 "#Microsoft.Skills.Text.EntityRecognitionSkill" 改@odata.type為 "#Microsoft.Skills.Text.V3.EntityRecognitionSkill"。

  2. (選用)includeTypelessEntities由於新技能只回傳已知型別的實體,因此該參數已不再支援,因此如果您先前的技能定義曾引用過它,現在應該會將其移除。

  3. (選用) 如果你使用輸出, namedEntities 屬性名稱會有一些小幅變更。

    1. value 被重新命名為 text
    2. confidence 被重新命名為 confidenceScore

    如果您需要產生完全相同的屬性名稱,請新增 ShaperSkill 將輸出重新調整為所需名稱。 舉例來說,ShaperSkill 會將屬性重新命名為舊值。

    {
        "@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. (選用)如果你利用entities輸出來將實體與知名實體連結,這項功能現在已成為一項新技能,也就是 Microsoft。Skills.Text.V3.EntityLinkingSkill。 將實體連結技能新增至技能集,可產生連結的實體。 entities 輸出的屬性名稱也在 EntityRecognitionSkill 和新的 EntityLinkingSkill 之間有幾項微幅變更。

    1. wikipediaId 被重新命名為 id
    2. wikipediaLanguage 被重新命名為 language
    3. wikipediaUrl 被重新命名為 url
    4. 系統不再傳回 type 和 subtype 屬性。

    如果您需要產生完全相同的屬性名稱,請新增 ShaperSkill 將輸出重新調整為所需名稱。 舉例來說,ShaperSkill 會將屬性重新命名為舊值。

    {
        "@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. (選用) 如果您未明確指定 categories,則 EntityRecognitionSkill V3 可回傳除先前支援 EntityRecognitionSkill的類別外的不同類型。 如果您不需要此行為,請務必將 categories 參數明確設為 ["Person", "Location", "Organization", "Quantity", "Datetime", "URL", "Email"]。

    範例遷移定義

    • 簡易移轉

      (之前)EntityRecognition 技能定義

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

      (之後)EntityRecognition 技能 V3 定義

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

      (之前)EntityRecognition 技能定義

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

      (之後)EntityRecognition 技能 V3 定義

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

最後可用的 API 版本

2021-04-30-Preview

結束支援

2024 年 8 月 31 日

建議

請改用 Microsoft.Skills.Text.V3.SentimentSkill。 它提供改良的模型,且包含的選項可供您新增意見挖掘或以層面為基礎的情感。 由於技能更為複雜,輸出也大不相同。

若要移轉至 Microsoft.Skills.Text.V3.SentimentSkill,請對技能定義進行下列一或多項變更。 您可以使用更新技能集 API 來更新技能定義。

附註

Sentiment Skill V3 的技能輸出與基於 SentimentSkill 的索引定義不相容。 您需要修改索引定義、技能組(包括後續的技能輸入和/或知識庫預測)以及索引器的輸出欄位映射,以用新版本替代情感技能。

  1. (必填)將 從 "#Microsoft.Skills.Text.SentimentSkill" 改@odata.type為 "#Microsoft.Skills.Text.V3.SentimentSkill"。

  2. (必填) Sentiment Skill V3 為整體文本提供 positive、 、 neutral和 negative 的分數,且對整體文本中的每一句話給予相同的分數;而先前的 SentimentSkill 僅提供一個雙重分數,範圍從 0.0(負)到 1.0(正)不等。 你必須更新索引定義,接受三個雙重值取代單一分數,並確保所有下游技能輸入、知識庫投影和輸出欄位映射都與命名變更一致。

建議您以 SentimentSkill V3 完全取代舊的 SentimentSkill、更新下游技能輸入、知識存放區預測、索引子輸出欄位對應和索引定義,以符合新的輸出格式,並重設索引子,讓之後所有文件都有一致的情感結果。

附註

如果您需要更多協助來更新擴充管線,以便使用最新版本的情感分析功能,或者無法重設索引子,請開啟新的支援請求,讓我們直接與您合作。

Microsoft.Skills.Text.NamedEntityRecognitionSkill

最後可用的 API 版本

2017-11-11-Preview

結束支援

2024 年 8 月 31 日

建議

請改用 Microsoft.Skills.Text.V3.EntityRecognitionSkill。 它以更好的品質提供 NamedEntityRecognitionSkill 的多數功能。 它複雜的輸出欄位也提供更豐富的資訊。

若要移轉至 Microsoft.Skills.Text.V3.EntityRecognitionSkill,請對技能定義進行下列一或多項變更。 您可以使用更新技能集 API 來更新技能定義。

  1. (必填)將 從 "#Microsoft.Skills.Text.NamedEntityRecognitionSkill" 改@odata.type為 "#Microsoft.Skills.Text.V3.EntityRecognitionSkill"。

  2. (選用) 如果你使用輸出, entities 請改用 namedEntities 來自 EntityRecognitionSkill V3 Complex 集合的輸出。 新的 namedEntities 複雜輸出的屬性名稱有幾項微幅變更:

    1. value 被重新命名為 text
    2. confidence 被重新命名為 confidenceScore

    如果您需要產生完全相同的屬性名稱,請新增 ShaperSkill 將輸出重新調整為所需名稱。 舉例來說,ShaperSkill 會將屬性重新命名為舊值。

    {
        "@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. (選用) 如果您未明確指定 categories,則 EntityRecognitionSkill V3 可回傳 NamedEntityRecognitionSkill除 。 如果您不需要此行為,請務必將 categories 參數明確設為 ["Person", "Location", "Organization"]。

    範例遷移定義

    • 簡易移轉

      (之前)NamedEntityRecognition 技能定義

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

      (之後)EntityRecognition 技能 V3 定義

      {
          "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
          "categories": [ "Person" ],
          "defaultLanguageCode": "en",
          "inputs": [
              {
                  "name": "text",
                  "source": "/document/content"
              }
          ],
          "outputs": [
              {
                  "name": "persons",
                  "targetName": "people"
              }
          ]
      }
      
    • 稍微複雜的移轉

      (之前)NamedEntityRecognition 技能定義

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

      (之後)EntityRecognition 技能 V3 定義

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

另請參閱