Kontext dovedností a jazyk pro zadávání poznámek

Tento článek je referenční dokumentace pro kontext dovedností a syntaxi vstupu. Jedná se o úplný popis jazyka výrazů, který slouží k vytváření cest k uzlům v rozšířeném dokumentu.

Dovednosti Azure AI Vyhledávač můžou využívat a rozšiřovat data pocházející ze zdroje dat a z výstupu dalších dovedností. Pracovní sada dat, která představuje aktuální stav práce indexeru pro aktuální dokument, začíná z nezpracovaných dat pocházejících ze zdroje dat a postupně se rozšiřuje o výstupní data jednotlivých dovedností. Tato data jsou interně uspořádaná ve stromové struktuře, která se dá dotazovat, aby se použila jako vstupy dovedností nebo aby se přidala do indexu. Uzly ve stromu mohou být jednoduché hodnoty, jako jsou řetězce a čísla, pole nebo složité objekty a dokonce binární soubory. Dokonce i jednoduché hodnoty lze rozšířit o strukturovanější informace. Řetězec může být například opatřen poznámkami s dalšími informacemi, které jsou pod ním uloženy ve stromu rozšiřování. Výrazy používané k dotazování na tuto interní strukturu používají bohatou syntaxi, která je podrobně popsána v tomto článku. Rozšířenou datovou strukturu je možné zkontrolovat z ladicích relací. Výrazy dotazující se na strukturu je možné testovat také z ladicích relací.

V celém článku jako příklad používáme následující rozšířená data. Tato data jsou typická pro typ struktury, kterou byste získali při rozšiřování dokumentu pomocí sady dovedností pomocí OCR, extrakce klíčových frází, překladu textu, rozpoznávání jazyka a dovedností rozpoznávání entit a dovednosti vlastního tokenizátoru.

Kořenový adresář dokumentu

Data jsou pod jedním kořenovým prvkem a cesta je "/document". Kořenový prvek je výchozím kontextem dovedností.

Jednoduché cesty

Jednoduché cesty prostřednictvím interního rozšířeného dokumentu lze vyjádřit jednoduchými tokeny oddělenými lomítky. Tato syntaxe se podobá specifikaci ukazatele JSON.

Vlastnosti objektu

Vlastnosti uzlů, které představují objekty, přidávají své hodnoty do stromu pod názvem vlastnosti. Tyto hodnoty lze získat připojením názvu vlastnosti jako tokenu odděleného lomítkem:

U tokenů názvů vlastností se rozlišují malá a velká písmena.

Index položky pole

Na konkrétní prvky pole lze odkazovat pomocí jejich číselného indexu, jako je název vlastnosti:

Escape sekvence

Existuje několik znaků, které mají zvláštní význam a musí být speciálně zpracovány, pokud mají být interpretovány doslova místo jako prvek syntaxe. Mezi tyto znaky patří #, /a ~ mimo jiné.

Výčet polí

Pole hodnot lze získat pomocí tokenu '*' :

Token '*' nemusí být na konci cesty. Je možné vytvořit výčet všech uzlů odpovídající cestě s hvězdičkou uprostřed nebo několika hvězdičkami:

Tento příklad vrátí plochý seznam všech odpovídajících uzlů.

Je možné zachovat větší strukturu a získat samostatné pole pro slova každé stránky pomocí '#' tokenu místo druhého '*' tokenu:

Token '#' vyjadřuje, že pole by mělo být považováno za jednu hodnotu, nikoli jako výčet.

Výčet polí v kontextu

Často je užitečné zpracovat každý prvek pole izolovaně a mít pro každý z nich jinou sadu vstupů dovedností a výstupů. Tento osvědčený postup lze provést nastavením kontextu dovednosti na výčet místo výchozího "/document".

V následujícím příkladu použijeme jeden ze vstupních výrazů, které jsme použili dříve, ale s jiným kontextem, který změní výslednou hodnotu.

Pro tuto kombinaci kontextu a vstupu se dovednost provede jednou pro každý normalizovaný obrázek: jednou pro "/document/normalized_images/0" a jednou pro "/document/normalized_images/1". Dva vstupní hodnoty odpovídající jednotlivým spuštěním dovedností jsou podrobně popsány ve sloupci hodnot.

Při vytváření výčtu pole v kontextu se všechny výstupy, které dovednost vytváří, přidají do dokumentu jako obohacení kontextu. V předchozím příkladu jsou hodnoty výstupu s názvem "out" pro každé spuštění přidány do dokumentu pod "/document/normalized_images/0/out" a "/document/normalized_images/1/out".

Literální hodnoty

Vstupy dovedností mohou jako vstupy přijímat literály místo dynamických hodnot dotazovaných z existujícího dokumentu. Tento osvědčený postup lze dosáhnout předponou hodnoty symbolem rovná se. Hodnoty můžou být čísla, řetězce nebo logická hodnota. Řetězcové hodnoty mohou být uzavřeny v jednoduchých ' nebo dvojitých " uvozovkách.

V řádcích polí

Pokud určitý vstup dovednosti vyžaduje pole dat, ale data jsou reprezentována jako jedna hodnota v současné době nebo potřebujete zkombinovat více různých jednoduchých hodnot do pole pole, pak můžete vytvořit maticovou hodnotu vloženou jako součást vstupního výrazu dovednosti tak, že zabalíte čárkami oddělený seznam výrazů v hranatých závorkách ([ a ]). Hodnota pole může být kombinací cest výrazů nebo literálových hodnot podle potřeby. Tímto způsobem můžete také vytvořit vnořená pole v rámci polí.

Pokud má dovednost kontext, který vysvětluje spuštění dovednosti pro vstup pole (to znamená, jak to znamená, že "context": "/document/pages/*" dovednost se spouští jednou za "stránku" v pages) a předání této hodnoty jako výrazu jako vstupu do řádku používá jednu z těchto hodnot najednou.

Příklad s našimi ukázkovými obohacenými daty, pokud je context vaše dovednost /document/merged_content/keyphrases/* a pak vytvoříte vložené pole následujícího =['key phrase', $(/document/merged_content/keyphrases/*)] na vstupu této dovednosti, pak se dovednost provede třikrát, jednou s hodnotou ["klíčové fráze", "Studie BMN"], další s hodnotou ["klíčové fráze", další s hodnotou ["klíčové fráze", "Syndrom"] a nakonec s hodnotou ["klíčové fráze", "Pediatrii pacienti"]. Hodnota literálu "klíčová fráze" zůstává vždy stejná, ale hodnota cesty výrazu se mění při každém provádění dovedností.

Složené výrazy

Hodnoty je možné kombinovat pomocí unárních, binárních a ternárních operátorů. Operátory mohou kombinovat hodnoty literálů a hodnoty vyplývající z vyhodnocení cesty. Při použití uvnitř výrazu by měly být cesty uzavřeny mezi "$(" a ")".

Logická hodnota není '!'

Negativní '-'

Sčítání '+'

Odčítání '-'

Násobení '*'

Dělení '/'

Modulo '%'

Zřetězení řetězců '+'

Menší než, menší než nebo rovno, větší než a větší než nebo rovno '<''<=''>''>='

Rovnost a nerovnost '==''!='

Logické operace a nebo výhradní nebo '&&''||''^'

Ternární operátor '?:'

Je možné zadat různé hodnoty na základě vyhodnocení logického výrazu pomocí ternárního operátoru.

Priorita závorek a operátorů

Operátory se vyhodnocují s prioritami, které odpovídají obvyklým konvencím: unární operátory, pak násobení, dělení a modulo, následné sčítání a odčítání, pak porovnání, pak rovnost a logické operátory. Platí také běžná pravidla asociativity.

Závorky lze použít ke změně nebo nejednoznačnosti pořadí vyhodnocení.

Viz také

• Vytvoření sady dovedností ve službě Azure AI Vyhledávač
• Referenční rozšiřování v sadě dovedností Azure AI Vyhledávač