Kognitiver Skill „Bedingt“

Artikel
10/26/2023

Der Skill Bedingt ermöglicht Azure KI Suchszenarios, die eine boolesche Operation erfordern, um zu bestimmen, welche Daten einer Ausgabe zugewiesen werden. Zu diesen Szenarios gehören die Filterung, die Zuweisung eines Standardwerts und das Zusammenführung von Daten auf der Grundlage einer Bedingung.

Der folgende Pseudocode veranschaulicht, wozu die Funktion „Bedingt“ dient:

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

Hinweis

Dieser Skill ist nicht an Azure KI Services gebunden. Er ist nicht gebührenpflichtig und weist keine Azure KI Services-Schlüsselanforderungen auf.

@odata.type

Microsoft.Skills.Util.ConditionalSkill

Ausgewertete Felder

Diese Qualifikation stellt einen Sonderfall dar, da ihre Eingaben ausgewertete Felder sind.

Die folgenden Elemente sind gültige Werte eines Ausdrucks:

Anmerkungspfade (Pfade in Ausdrücken müssen mit „$(“ und „)“ abgegrenzt werden.)
Beispiele:
```
    "= $(/document)"
    "= $(/document/content)"
```

Literale (Zeichenfolgen, Zahlen, TRUE, FALSE, NULL)
Beispiele:

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

Ausdrücke, die Vergleichsoperatoren verwenden (==, !=, >=, >, <=, <)
Beispiele:

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

Ausdrücke, die boolesche Operatoren (&&&, ||, !, ^) verwenden
Beispiele:

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

Ausdrücke, die numerische Operatoren verwenden (+, -, *, /, %)
Beispiele:

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

Da die Funktion „Bedingt“ die Auswertung unterstützt, können Sie diese in kleineren Transformationsszenarios verwenden. Ein Beispiel hierfür finden Sie in der Funktionsdefinition 4.

Skilleingaben

Bei Eingaben muss die Groß-/Kleinschreibung beachtet werden.

Eingabe	Beschreibung
Bedingung	Diese Eingabe ist ein ausgewertetes Feld, das die auszuwertende Bedingung darstellt. Diese Bedingung sollte in einen booleschen Wert ausgewertet werden (true oder false). Beispiele: "= true" "= $(/document/language) =='fr'" "= $(/document/pages/*/language) == $(/document/expectedLanguage)"
whenTrue	Diese Eingabe ist ein ausgewertetes Feld, das den zurückzugebenden Wert darstellt, wenn die Bedingung mit true ausgewertet wird. Konstante Zeichenfolgen sollten in einfachen Anführungszeichen (' ') zurückgegeben werden. Beispielwerte: "= 'contract'" "= $(/document/contractType)" "= $(/document/entities/*)"
whenFalse	Diese Eingabe ist ein ausgewertetes Feld, das den zurückzugebenden Wert darstellt, wenn die Bedingung mit false ausgewertet wird. Beispielwerte: "= 'contract'" "= $(/document/contractType)" "= $(/document/entities/*)"

Skillausgaben

Es gibt eine einzelne Ausgabe, die einfach nur als „Ausgabe“ benannt ist. Diese gibt entweder den Wert von whenFalse zurück, wenn die Bedingung „false“ ist, oder sie gibt whenTrue zurück, wenn die Bedingung „true“ ist.

Beispiele

Beispieldefinition einer Qualifikation 1: Filtern von Dokumenten, sodass nur französische Dokumente zurückgegeben werden

Die folgende Ausgabe gibt ein Array von Sätzen („/document/frenchSentences“) zurück, wenn die Sprache des Dokuments Französisch ist. Wenn die Sprache nicht Französisch ist, wird der Wert auf null festgelegt.

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

Wenn „/document/frenchSentences“ als Kontext einer anderen Funktion verwendet wird, wird diese nur ausgeführt, wenn „/document/frenchSentences“ nicht auf null festgelegt ist.

Beispieldefinition einer Qualifikation 2: Festlegen eines Standardwerts für einen nicht vorhandenen Wert

Die folgende Ausgabe erstellt eine Anmerkung („/document/languageWithDefault“), die entweder auf die Sprache des Dokuments oder auf „es“ bei nicht festgelegter Sprache festgelegt wird.

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

Beispieldefinition einer Qualifikation 3: Zusammenführen von Werten aus zwei Feldern in ein Feld

In diesem Beispiel haben einige Sätze eine frenchSentiment-Eigenschaft. Wenn die frenchSentiment-Eigenschaft „null“ ist, soll der Wert englishSentiment verwendet werden. Wir weisen die Ausgabe einem Member mit der Bezeichnung sentiment zu ("/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" } ]
}

Transformation-Beispiel

Beispieldefinition einer Qualifikation 4: Datentransformation für ein einzelnes Feld

In diesem Beispiel erhalten wir eine Stimmung, die zwischen 0 und 1 liegt. Nach der Transformation soll die Stimmung zwischen –1 und 1 liegen. Die Funktion „Bedingt“ kann für diese geringfügige Transformation verwendet werden.

In diesem Beispiel verwenden wir nicht den bedingten Aspekt der Funktion, da die Bedingung immer true ist.

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

Besondere Überlegungen

Einige Parameter werden ausgewertet. Daher müssen Sie das dokumentierte Muster besonders sorgfältig befolgen. Ausdrücke müssen mit einem Gleichheitszeichen („=“) beginnen. Ein Pfad muss durch „$(“ und „)“ begrenzt sein. Stellen Sie sicher, dass die Zeichenfolgen in einfache Anführungszeichen eingeschlossen werden (" und "). Dies hilft bei der Auswertung, zwischen Zeichenfolgen und tatsächlichen Pfaden und Operatoren zu unterscheiden. Stellen Sie auch sicher, dass Sie vor und nach Operatoren Leerzeichen verwenden (z. B. bedeutet ein „*“ in einem Pfad etwas anderes als Multiplizieren).