条件认知技能

条件技能可以实现需要使用布尔运算来确定要分配到输出的数据的 Azure AI 搜索方案。 这些方案包括基于条件进行筛选、分配默认值以及合并数据。

以下伪代码演示条件技能可以实现的功能：

if (condition) 
    { output = whenTrue } 
else 
    { output = whenFalse } 

@odata.type

Microsoft.Skills.Util.ConditionalSkill

求值的字段

此技能非常特别，因为它的输入是求值的字段。

以下各项是表达式的有效值：

• 批注路径（表达式中的路径必须以“$(”和“)”分隔）
  示例：

      "= $(/document)"
      "= $(/document/content)"
  

• 文本（字符串、数字、true、false、null）
  示例：

     "= 'this is a string'"   // string (note the single quotation marks)
     "= 34"                   // number
     "= true"                 // Boolean
     "= null"                 // null value
  

• 使用比较运算符（==、!=、>=、>、<=、<）的表达式
  示例：

      "= $(/document/language) == 'en'"
      "= $(/document/sentiment) >= 0.5"
  

• 使用布尔运算符（&&、||、!、^）的表达式
  示例：

      "= $(/document/language) == 'en' && $(/document/sentiment) > 0.5"
      "= !true"
  

• 使用数字运算符（+、-、*、/、%）的表达式
  示例：

      "= $(/document/sentiment) + 0.5"         // addition
      "= $(/document/totalValue) * 1.10"       // multiplication
      "= $(/document/lengthInMeters) / 0.3049" // division
  

由于条件技能支持求值，因此可以在次要转换方案中使用它。 有关示例，请参阅技能定义 4。

技能输入

输入区分大小写。

技能输出

有一个简称为“输出”的输出。如果条件为 false，它会返回值 whenFalse；如果条件为 true，它会返回值 whenTrue。

示例

示例技能定义 1：筛选文档以仅返回法语文档

如果文档的语言为法语，则以下输出将返回句子数组 ("/document/frenchSentences")。 如果语言不是法语，值将设置为 null。

{
    "@odata.type": "#Microsoft.Skills.Util.ConditionalSkill",
    "context": "/document",
    "inputs": [
        { "name": "condition", "source": "= $(/document/language) == 'fr'" },
        { "name": "whenTrue", "source": "/document/sentences" },
        { "name": "whenFalse", "source": "= null" }
    ],
    "outputs": [ { "name": "output", "targetName": "frenchSentences" } ]
}

如果将“/document/frenchSentences”用作另一技能的上下文，仅当“/document/frenchSentences”未设置为 null 时，才运行该技能。

示例技能定义 2：为不存在的值设置默认值

以下输出创建批注 ("/document/languageWithDefault")，该批注设置为文档的语言，如果未设置该语言，则该批注将设置为“es”。

{
    "@odata.type": "#Microsoft.Skills.Util.ConditionalSkill",
    "context": "/document",
    "inputs": [
        { "name": "condition", "source": "= $(/document/language) == null" },
        { "name": "whenTrue", "source": "= 'es'" },
        { "name": "whenFalse", "source": "= $(/document/language)" }
    ],
    "outputs": [ { "name": "output", "targetName": "languageWithDefault" } ]
}

示例技能定义 3：将两个字段中的值合并为一个值

在此示例中，某些句子包含 frenchSentiment 属性。 每当 frenchSentiment 属性为 null 时，我们就要使用 englishSentiment 值。 将输出分配到名为 sentiment 的成员 ("/document/sentences/*/sentiment")。

{
    "@odata.type": "#Microsoft.Skills.Util.ConditionalSkill",
    "context": "/document/sentences/*",
    "inputs": [
        { "name": "condition", "source": "= $(/document/sentences/*/frenchSentiment) == null" },
        { "name": "whenTrue", "source": "/document/sentences/*/englishSentiment" },
        { "name": "whenFalse", "source": "/document/sentences/*/frenchSentiment" }
    ],
    "outputs": [ { "name": "output", "targetName": "sentiment" } ]
}

转换示例

示例技能定义 4：对单个字段的数据转换

在此示例中，我们将收到介于 0 和 1 之间的情绪。 我们希望将此值转换为 -1 到 1。 可以使用条件技能来实现这种次要转换。

在此示例中，我们未使用技能的条件性，因为该条件始终为 true。

{
    "@odata.type": "#Microsoft.Skills.Util.ConditionalSkill",
    "context": "/document/sentences/*",
    "inputs": [
        { "name": "condition", "source": "= true" },
        { "name": "whenTrue", "source": "= $(/document/sentences/*/sentiment) * 2 - 1" },
        { "name": "whenFalse", "source": "= 0" }
    ],
    "outputs": [ { "name": "output", "targetName": "normalizedSentiment" } ]
}

特殊注意事项

某些参数将会求值，因此需要特别谨慎地遵循阐述的模式。 表达式必须以等号开头。 路径必须以“$(”和“)”分隔。 请务必将字符串放在单引号中。 这有助于求值程序区分字符串与实际的路径和运算符。 此外，请务必在运算符的两侧添加空格（例如，在路径中使用 "*" 表示不是乘号）。

后续步骤

• 内置技能
• 如何定义技能集