Rozhodovací strom: Pravidla pro větvení a příklady

Rozhodovací strom je posloupnost otázek, ve kterých každá odpověď určuje další otázku nebo konečné doporučení. Použijte jej, když se správný postup skutečně mění v závislosti na skutečnostech, které čtenář může zjistit – nikoli jako dekoraci pro radu, která je pro všechny stejná.

První reakce na neúspěšný export dat

1. Zobrazuje export chybovou zprávu?
Ano → Zkopírujte přesné znění zprávy, poté přejděte k otázce 2.
Ne → Zkontrolujte, zda úloha stále zobrazuje „Zpracovává se“. Pokud ano, vyčkejte do konce uvedené doby zpracování; pokud ne, restartujte export jednou.

2. Říká zpráva, že přístup byl odepřen?
Ano → Požádejte administrátora o oprávnění k exportu. Konec.
Ne → Zmenšete rozsah dat a zkuste to jednou znovu. Pokud selže znovu, pošlete zprávu a ID exportu podpoře. Konec.

Vykreslený element demonstruje základní kontrakt: každá volba je rozlišitelná, každá cesta postupuje a každá cesta končí dalším krokem nebo eskalací.

Proč na tomto elementu záleží

„Záleží na okolnostech“ je upřímné, ale nedostatečné. Čtenář, který se s tímto souslovím setká, musí zjistit, na čem odpověď závisí, rozhodnout, které podmínky platí, a z textu rekonstruovat doporučení. Rozhodovací strom činí tyto závislosti explicitními. Přeměňuje vágní kvalifikaci na ohraničenou posloupnost: pozorujte skutečnost, vyberte jednu větev, poté jednejte podle koncového bodu.

Tím se snižuje zátěž pracovní paměti. Čtenář vyhodnocuje pouze aktuální volby, místo aby měl na paměti všechny výjimky. Zároveň je tak viditelná nejistota. Pokud osoba nemůže na uzel odpovědět, strom ji může nasměrovat na kontrolu, měření nebo odborníka, místo aby vybízel k hádání. To je obzvláště důležité pro řešení problémů, stanovení způsobilosti, výběr při nákupu a interpretaci zásad, kde sebevědomá, ale chybná větev může stát čas nebo vytvářet riziko.

Strojová extrahovatelnost znamená, že crawlingový nástroj, vyhledávací systém, systém AI odpovědí nebo nástroj pro transformaci obsahu může získat každou otázku, její povolené odpovědi a následující uzel nebo koncový bod. Souvislý text typu „pokud toto, možná tamto, pokud ne…“ tyto vztahy skrývá v gramatice. Typovaný strom je odhaluje jako záznamy se stabilními identifikátory a explicitními cíli. Stroj může zachovat cestu start → has-error → permission-denied → request-access, aniž by musel odvozovat, který odstavec modifikuje kterou podmínku.

Před použitím vzoru postupujte podle pravidel pro psaní elementů . Účel má přednost před vzhledem: posloupnost zůstává seznamem kroků, když všichni provádějí stejné akce v pořadí, a srovnání zůstává srovnáním, když čtenáři potřebují prohlížet možnosti vedle sebe. Použijte rozhodovací strom pouze tehdy, když předchozí odpověď mění to, co by se mělo stát dál.

Kdy jej použít

Použijte rozhodovací strom, pokud platí všechny tyto podmínky:

1. Alespoň jedno smysluplné doporučení závisí na odpovědi poskytnuté čtenářem nebo jeho situací.
2. Každé rozhodnutí lze vyjádřit pozorovatelnými, vzájemně se vylučujícími volbami.
3. Sledování větve odstraňuje irelevantní volby, nikoli pouze skrývá užitečný kontext.
4. Každá cesta končí akcí, závěrem, pojmenovanou záložní možností nebo eskalací.
5. Autor může vysvětlit, proč každá podmínka mění doporučení.

Silné případy použití zahrnují diagnostiku známého příznaku, výběr mezi produktovými kategoriemi, ověření použitelnosti zásad, volbu implementačního postupu a rozhodování, kdy musí být rutinní proces eskalován.

Téměř vhodné případy by měly zůstat v jednodušších formách:

• Jedno doporučení s několika důvody: použijte běžný vysvětlující text. Žádná odpověď nemění výsledek.
• Pevný postup: použijte uspořádané kroky. Větvení uvnitř každého kroku ztěžuje přehlednost hlavní cesty.
• Možnosti, které čtenáři musí porovnávat podle společných kritérií: použijte srovnávací tabulku. Strom může doporučit možnost po srovnání, ale nemůže nahradit důkazy.
• Osobnostní kvíz: preference se mohou překrývat a skórování může být kumulativní. To je model hodnocení, nikoli exkluzivní strom.
• Seznam segmentů publika: použijte přepínač person, když si čtenáři jednoduše vyberou svou roli a obdrží paralelní obsah.
• Složitý výpočet: použijte kalkulačku, když se kombinuje několik číselných vstupů. Převádění rozsahů na desítky větví ztrácí přesnost.
• Maskovaný prodejní trychtýř: pokud každá cesta doporučuje stejný produkt, strom vytváří iluzi diagnostiky. Uveďte doporučení a jeho omezení přímo.

Kam jej umístit

Umístěte strom ihned poté, co čtenář pochopí rozhodnutí, jeho rozsah a skutečnosti, které potřebuje k zodpovězení prvního uzlu. V článku o řešení problémů umístěte sdílené bezpečnostní kontroly a přesný příznak před strom. V průvodci nákupem definujte kritéria a sadu způsobilých možností před nasměrováním čtenářů do kategorie. V obsahu o zásadách uveďte autoritativní pravidlo a jurisdikci před větvením přes výjimky.

Přesná pravidla umístění:

• Uveďte strom nadpisem H2 a jednou větou pojmenovávající rozhodnutí, které řeší.
• Umístěte definice, měření a předpoklady před první uzel; nikdy nenechávejte popisek větve závislý na nedefinovaném termínu.
• Udržujte podpůrné důkazy blízko koncového bodu, který ospravedlňují, nebo propojte každý koncový bod s viditelnou sekcí důkazů na stejné stránce.
• Po dlouhém stromu umístěte shrnutí, aby si čtenáři mohli potvrdit vybraný koncový bod a pochopit, co dělat dál.
• Udržujte strom před konečnou výzvou k akci. Akce by měla následovat po závěru, nikoli přerušovat diagnostiku.

Rozhodovací strom nesmí být umístěn přímo vedle jiného rozhodovacího stromu, sady záložek pro persony nebo accordionu, který skrývá informace potřebné k výběru větve. Nesmí oddělit varování od nebezpečné podmínky, kterou kvalifikuje, přerušit uspořádaný postup bez explicitního koncového bodu „návrat ke kroku“ nebo se objevit před srovnáním, které poskytuje důkazy pro jeho doporučení. Neumisťujte propagační karty do uzlů; komerční tlak ztěžuje důvěryhodnost neutrálního směrování.

Anatomie

Anatomie má osm částí:

1. Název: pojmenovává rozhodnutí jako cíl čtenáře, například „Zvolte postup obnovy exportu“.
2. Prohlášení o rozsahu: uvádí, kterou situaci strom pokrývá a které situace vylučuje.
3. Počáteční uzel: poskytuje jeden jednoznačný vstupní bod.
4. Otázkový uzel: ptá se na jednu pozorovatelnou skutečnost, nikoli na názor obsahující několik podmínek.
5. Popisky větví: poskytují vzájemně se vylučující odpovědi ve stejné logické kategorii.
6. Propojovací prvky: mapují každou odpověď na jeden následující uzel nebo jeden koncový bod prostřednictvím stabilních ID.
7. Koncový bod: poskytuje závěr, akci, odkaz na důkazy nebo bezpečnou eskalaci a viditelně označuje cestu jako dokončenou.
8. Záložní možnost: řeší „neznámé“, „žádné neplatí“, chybějící data nebo nebezpečnou situaci, aniž by nutila k hádání.

Vizuální šipka je způsob prezentace, nikoli samotný vztah. Zdrojová data musí identifikovat cíl každé větve, i když renderer vykresluje strom vertikálně na úzké obrazovce.

Příklady provedení

Každá varianta provedení používá stejný kontrakt uzlů a cílů. Vybírejte podle struktury uvažování a zobrazovací plochy, nikoli podle vizuální novosti.

Binární diagnostický strom

Každý uzel má větve „ano“ a „ne“. Použijte jej, když je skutečnost skutečně binární: stav existuje, test prošel nebo oprávnění je přítomno. Vyhněte se záporným otázkám, protože „Ne“ je pak obtížné interpretovat.

Vícevolbový výběrový strom

Uzel nabízí tři nebo čtyři nepřekrývající se kategorie, jako je délka smlouvy, prostředí nebo primární omezení. Definujte hranice kategorií v popiscích; „malý“, „střední“ a „velký“ jsou bez rozpětí nepoužitelné.

Stupňovitý kvalifikační strom

Rané uzly odstraňují nezpůsobilé cesty; pozdější uzly upřesňují výběr mezi způsobilými možnostmi. Použijte jej pro použitelnost zásad, služeb nebo integrací. Umístěte vylučující bezpečnostní a právní podmínky jako první, protože pozdější preference je nemohou přebít.

Lineární strom s výjimečnými odbočkami

Hlavní cesta pokračuje normální posloupností, zatímco občasné větve odbočují k obnově nebo eskalaci. Použijte jej, když většina čtenářů následuje jednu cestu a výjimky jsou vzácné. Označte body návratu přesně, pokud se výjimka znovu připojuje k postupu.

Interaktivní zobrazení jedné otázky

Zobrazujte vždy jen jeden aktuální uzel pouze tehdy, když je celý strom pro zobrazovací plochu příliš hustý. Zahrňte kontext postupu, tlačítka Zpět, Začít znovu, textové shrnutí výsledku a neinteraktivní přístupné zobrazení. Kompletní zdrojový strom musí zůstat k dispozici bez načítání na straně klienta.

Parametry

Rodič vlastní identitu stromu a počáteční bod. Opakované uzly vlastní svůj text nebo obsah koncového bodu, zatímco záznamy větví vlastní popisky odpovědí a cíle.

Koncový bod nemá žádné větve. Otázka má alespoň dvě a každý cíl odkazuje na uzel ve stejném stromu. Data musí být acyklická: žádná větev nesmí vést zpět k předchůdci. Cesta obnovy, která se znovu připojuje k postupu, by měla končit „Návrat ke kroku 3“ namísto vytváření smyčky uvnitř stromu.

Syntaxe a příklady kódu

Všechny tři formy popisují stejné kanonické záznamy. Renderery mohou měnit rozvržení, ale musí zachovat pořadí zdroje, popisky, cíle, koncové body a kompletní neinteraktivní cestu čtení.

Přenosná Markdown direktiva

:::decision-tree{id=export-recovery variant=binary start=has-error}
## Choose an export recovery route

::item{id=has-error kind=question branches="yes:permission-error|no:still-processing"}
### Does the export show an error message?
Choose from the status shown in the export history.
::

::item{id=permission-error kind=question branches="yes:request-access|no:retry-smaller"}
### Does the message say permission is denied?
::

::item{id=still-processing kind=endpoint}
### Check the processing window
Wait until the stated window ends, then restart the export once.
::

::item{id=request-access kind=endpoint}
### Request export permission
Ask an administrator for access before trying again.
::

::item{id=retry-smaller kind=endpoint}
### Retry a smaller export
Reduce the date range once; if it fails, send the error and export ID to support.
::
:::

Kompaktní atribut branches používá páry label:target oddělené |. Popisky nesmí obsahovat žádný z těchto oddělovačů. Platforma s vnořenými záznamy větví může ukládat stejné hodnoty strukturálně, ale export musí reprodukovat explicitní mapování popisku na cíl.

Hugo shortcode

{{< decision-tree title="Choose an export recovery route" id="export-recovery" variant="binary" start="has-error" >}}
  {{< decision-node id="has-error" kind="question" title="Does the export show an error message?" branches="Yes:permission-error|No:still-processing" >}}
  Choose from the status shown in the export history.
  {{< /decision-node >}}
  {{< decision-node id="permission-error" kind="question" title="Does the message say permission is denied?" branches="Yes:request-access|No:retry-smaller" >}}{{< /decision-node >}}
  {{< decision-node id="still-processing" kind="endpoint" title="Check the processing window" >}}
  Wait until the stated window ends, then restart the export once.
  {{< /decision-node >}}
  {{< decision-node id="request-access" kind="endpoint" title="Request export permission" >}}
  Ask an administrator for access before trying again.
  {{< /decision-node >}}
  {{< decision-node id="retry-smaller" kind="endpoint" title="Retry a smaller export" >}}
  Reduce the date range once; if it fails, send the error and export ID to support.
  {{< /decision-node >}}
{{< /decision-tree >}}

Toto je specifikace Hugo adaptéru, nikoli instrukce k napodobení stromu pomocí libovolných vnořených seznamů. Používá pouze pojmenované parametry a vyžaduje, aby renderer odmítl chybějící cíle, duplicitní ID, cykly a otázkové uzly bez dostatečného počtu větví.

WordPress blok

<!-- wp:amicited/decision-tree {"title":"Choose an export recovery route","id":"export-recovery","variant":"binary","start":"has-error"} -->
  <!-- wp:amicited/decision-node {"id":"has-error","kind":"question","title":"Does the export show an error message?","branches":[{"label":"Yes","target":"permission-error"},{"label":"No","target":"still-processing"}]} -->
  <p>Choose from the status shown in the export history.</p>
  <!-- /wp:amicited/decision-node -->
  <!-- wp:amicited/decision-node {"id":"permission-error","kind":"question","title":"Does the message say permission is denied?","branches":[{"label":"Yes","target":"request-access"},{"label":"No","target":"retry-smaller"}]} /-->
  <!-- wp:amicited/decision-node {"id":"still-processing","kind":"endpoint","title":"Check the processing window"} -->
  <p>Wait until the stated window ends, then restart the export once.</p>
  <!-- /wp:amicited/decision-node -->
  <!-- wp:amicited/decision-node {"id":"request-access","kind":"endpoint","title":"Request export permission"} -->
  <p>Ask an administrator for access before trying again.</p>
  <!-- /wp:amicited/decision-node -->
  <!-- wp:amicited/decision-node {"id":"retry-smaller","kind":"endpoint","title":"Retry a smaller export"} -->
  <p>Reduce the date range once; if it fails, send the error and export ID to support.</p>
  <!-- /wp:amicited/decision-node -->
<!-- /wp:amicited/decision-tree -->

WordPress rodičovský blok omezuje vnitřní bloky na rozhodovací uzly, validuje cíle před publikováním a serverově renderuje úplný seznam nebo ekvivalentní přístupnou strukturu. Spojovací čáry pouze v editoru nejsou zdrojem pravdy.

Příklady

Dobrý příklad

Průvodce nákupem se ptá: „Musí zařízení fungovat bez síťového napájení?“ Ano směruje k možnostem na baterie; Ne se ptá: „Zůstane na jednom pevném místě?“ Tato odpověď směruje buď k instalovaným, nebo přenosným možnostem. Každý koncový bod pojmenovává kategorii, vysvětluje rozhodující omezení a posílá čtenáře k viditelnému srovnání způsobilých produktů. „Nejsem si jistý“ směruje k změření zamýšleného umístění a kontroly přístupu k zásuvce.

Toto funguje, protože otázky se týkají skutečností, které čtenář může pozorovat, větve se nepřekrývají a každá odpověď odstraňuje nevhodné kategorie. Strom doporučuje kategorii, nikoli předstírá, že vybírá konkrétní produkt bez srovnání ceny, funkcí a důkazů.

Špatný příklad

Softwarová stránka se ptá: „Chcete lepší výsledky?“ Obě možnosti Ano i Ještě ne směřují k „Objednat demo.“ Další otázka se ptá, zda návštěvník preferuje rychlost, kvalitu nebo úspory, ačkoli většina kupujících si cení všech tří. Každý koncový bod opakuje stejné tvrzení o produktu.

Toto selhává, protože volby nejsou vzájemně se vylučující ani nemění rozhodnutí. Otázky sbírají souhlas spíše než diagnostikují potřeby a větve skrývají jedinou výzvu k akci. Nahraďte to přímou hodnotovou nabídkou a důkazy. Pokud různé implementace skutečně vyhovují různým omezením, ptejte se na tato měřitelná omezení a umožněte upřímný koncový bod, například „Tento produkt není vhodný.“

Schema markup a přístupnost

Schema.org nemá typ DecisionTree. Neoznačujte element jako HowTo, pokud stránka samostatně neobsahuje jeden uspořádaný postup, a neoznačujte otázkové uzly jako FAQPage, když jejich odpovědi jsou pouze ovládacími prvky větvení. Strom může pomoci generovat interní data obsahu – uzly, volby, cíle a doporučení koncových bodů – ale standardně neposkytuje žádnou veřejnou vlastnost schema.

Pro přístupnost použijte nadpis pro název stromu a uspořádaný nebo vnořený seznam pro úplnou statickou formu. Každá otázka a koncový bod potřebuje viditelný text; propojovací prvky se nesmí spoléhat pouze na barvu, směr čáry nebo prostorové umístění. Zopakujte popisek odpovědi ve vztahu, například „Pokud ano, pokračujte ke kontrole oprávnění.“ Čtečka obrazovky by měla pochopit cestu bez interpretace diagramu.

Pokud je strom interaktivní, použijte pro volby nativní tlačítka. Zpřístupněte aktuální otázku v označené oblasti, přesuňte fokus na novou otázku nebo ji oznamte pomocí zdrženlivé živé oblasti a poskytněte ovládací prvky Zpět a Začít znovu. Nezakazujte přiblížení prohlížeče, nezachycujte fokus a neměňte volbu při fokusu. Uchovejte vybranou cestu v textu u koncového bodu, aby si čtenář mohl ověřit, jak bylo výsledku dosaženo.

Všechny uzly a koncové body by měly být dodány v serverově renderovaném HTML, i když jsou neaktivní uzly vizuálně skryty. Pokud je to z výkonnostních důvodů nepraktické pro velmi rozsáhlý expertní systém, publikujte úplnou přístupnou alternativu a považujte interaktivní aplikaci za samostatný nástroj, nikoli za tento obsahový element.

Pravidla psaní

Cílem je nejkratší obhajitelná cesta, nikoli zdání sofistikovanosti.

• Napište název jako rozhodnutí: „Zvolte…“, „Zkontrolujte, zda…“ nebo „Najděte správný…“. Udržte jej na 3–12 slovech.
• Ptejte se na jednu skutečnost na otázku v 5–18 slovech. Rozdělte podmínky spojené „a“ nebo „nebo“, pokud nemají vždy stejnou pozorovatelnou odpověď.
• Použijte dvě až čtyři větve na otázku a maximálně pět úrovní rozhodování. Větší hloubka způsobí, že čtenáři ztratí přehled o cestě a mobilní diagramy se stanou nepřehlednými.
• Dbejte, aby sourozenecké větve byly vzájemně se vylučující a společně dostačující pro zamýšlený rozsah. Přidejte „Nejsem si jistý“ nebo „Žádná z těchto“, když je nejistota realistická.
• Používejte paralelní popisky z jedné kategorie: vše ano/ne, vše rozsahy, vše prostředí nebo vše uvedená omezení.
• Uvádějte číselné hranice přesně. Použijte „Méně než 50 poboček“ místo „malá firma“. Vyhněte se překrývajícím se rozsahům u hraničních hodnot.
• Každému koncovému bodu dejte akční název o 2–10 slovech a až 80 slov vysvětlujících, proč následuje, co dělat a kdy eskalovat.
• Umístěte nejbezpečnější a nejlevnější rozlišovací kontrolu brzy. Nevyžadujte odborná měření před viditelnou kontrolou stavu nebo oprávnění, která již určuje cestu.
• Udržujte důkazy, omezení a důsledky viditelné. Strom organizuje rozhodnutí; neprokazuje, že doporučení je správné.
• Otestujte každou cestu nahlas jako větu: „Protože odpověď byla X, pokračujte k Y.“ Pokud tato věta nedává smysl, větev je chybná.

Nikdy nevkládejte do uzlu důvěrné osobní údaje, nekvalifikovanou lékařskou nebo právní diagnózu, skrytou cenu, bezpečnostní varování, formulář s více poli nebo nevratnou akci. Nikdy nevytvářejte slepou uličku, neoznačený propojovací prvek, koncový bod, který říká pouze „Záleží na okolnostech“, nebo cyklus, který nutí čtenáře opakovat otázky donekonečna.

Typy příspěvků, které jej používají

Frontmatter postTypes definuje podporovanou sadu. Přítomnost v této tabulce znamená, že typ příspěvku může použít strom, když se jeho obsah skutečně větví; nečiní element povinným na každé stránce.

Kontrolní seznam QA

• Stránka obsahuje skutečnou závislost: alespoň jedna odpověď mění další otázku nebo koncový bod.
• Název a prohlášení o rozsahu přesně uvádějí, které rozhodnutí strom řeší a které vylučuje.
• Existuje jeden počáteční uzel, každá otázka má dvě až čtyři větve a každý cíl existuje.
• Sourozenecké volby jsou vzájemně se vylučující, používají paralelní popisky a pokrývají realistickou nejistotu.
• Každá cesta končí akcí, závěrem, záložní možností nebo eskalací do pěti úrovní.
• Žádný koncový bod není osiřelý, žádný uzel neodkazuje sám na sebe nebo na předchůdce a žádný čtenář se nemůže zacyklit donekonečna.
• Každý koncový bod vysvětluje, proč následuje, a uchovává důkazy nebo omezení k dispozici.
• Strom nenahrazuje pevný postup, srovnání vedle sebe, výpočet, varování nebo přímé doporučení.
• Veškerý text a vztahy jsou přítomny v serverově renderovaném HTML a jsou srozumitelné bez spojovacích čar.
• Uživatelé klávesnice mohou vybírat, vracet se zpět, restartovat a dosáhnout výsledku s viditelným fokusem.
• Změny fokusu a stavu jsou oznamovány bez zachycení fokusu nebo opakovaného přerušování čtečky obrazovky.
• Zobrazení na úzké obrazovce zachovává pořadí zdroje, popisuje každý propojovací prvek a nevyžaduje horizontální posouvání.
• Statická záložní verze a interaktivní výsledek produkují stejné koncové body pro stejné odpovědi.
• Recenzent prošel každou cestu, otestoval hraniční hodnoty a zpochybnil jakoukoli větev, která vede ke stejnému výsledku.

Často kladené otázky

Níže uvedené otázky pokrývají implementační volby, které se často objevují až po napsání stromu. Základní test zůstává jednoduchý: větve musí představovat skutečnosti, které mění výsledek, a každá cesta musí bezpečně končit.