条件认知技能

项目
02/01/2024

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

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

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

注意

此技能不会绑定到 Azure AI 服务。它不可计费，并且没有 Azure AI 服务密钥要求。

@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。

技能输入

输入区分大小写。

输入	说明
condition	此输入是一个求值字段，表示要求值的条件。此条件应求值为布尔值（true 或 false）。示例： "= true" "= $(/document/language) =='fr'" "= $(/document/pages/*/language) == $(/document/expectedLanguage)"
whenTrue	此输入是一个求值字段，表示当条件求值为 true 时要返回的值。常量字符串应括在单引号（' 和 '）中返回。示例值： "= 'contract'" "= $(/document/contractType)" "= $(/document/entities/*)"
whenFalse	此输入是一个求值字段，表示当条件求值为 false 时要返回的值。示例值： "= 'contract'" "= $(/document/contractType)" "= $(/document/entities/*)"

技能输出

有一个简称为“输出”的输出。如果条件为 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" } ]
}

特殊注意事项

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

通过