Nastavení pipeline

Nastavte, které fáze pipeline se mají spouštět, ve dvou vrstvách: jako výchozí nastavení na enginu a jako nepovinné přepsání pro konkrétní požadavek.

Už jste se rozhodli, které fáze chcete kolem základního kroku překladu. Teď zbývají dvě otázky: kde tohle rozhodnutí žije a co uděláte, když jedna úloha potřebuje něco jiného než všechny ostatní? Odpovědí jsou dvě vrstvy. Engine nese výchozí nastavení, které dědí každá async úloha. Objekt pipelineConfig u jednoho odeslání toto výchozí nastavení přepíše, ale jen pro něj. Fáze, které v přepsání vynecháte, se převezmou z enginu, takže požadavek uvádí jen to, co se liší.

Jste v pipeline noví? Začněte na stránce Přehled pipeline, kde najdete, co jednotlivé fáze dělají. Tahle stránka je o tom, jak je zapínat a přepisovat – ne o tom, co dělají, když jsou aktivní.

Výchozí nastavení na úrovni enginu#

V dashboardu otevřete u enginu kartu Pipeline a každou fázi zapínejte nezávisle. Tato konfigurace je pro engine výchozí: každá async úloha směrovaná do něj poběží s těmito fázemi, pokud je požadavek nepřepíše. Nastavíte ji jednou a nemusíte pipeline znovu uvádět při každém volání.

Každá fáze kromě Lokalizace má vlastní přepínač a změna se uloží hned po přepnutí. Můžete zapnout libovolnou kombinaci – žádnou, všechny nebo cokoli mezi tím. Úloha spouští fáze v tomto pořadí:

• Předúprava – vyčistí zdrojový text před překladem.
• Lokalizace – hlavní krok překladu. Je označená jako Vždy zapnuto a nemá přepínač.
• Přeformulování – upraví text tak, aby zněl přirozeně. Je nezávislé na ostatních fázích.
• Lidská kontrola – odešle obsah do interní nebo externí kontroly. Tlačítko nastavení tohoto kroku otevře položky Poskytovatel, Časový limit a Práh kvality.
• Následná úprava – sladí lidskou úpravu s pravidly vašeho engine. Nelze ji zapnout, dokud není zapnutá Lidská kontrola, a když Lidskou kontrolu vypnete, vypne se i ona.
• Délka obsahu – udrží překlad v rámci šířkového limitu měřeného ve sloupcích zobrazení, ne ve znacích. Tlačítko nastavení tohoto kroku otevře Rozpočet: Zůstat pod pevným limitem (s hodnotou Maximální délka), Ne delší než originál nebo Odpovídat délce originálu (s hodnotou Povolený rozdíl v procentech).
• Zpětný překlad – ověří, že se při převodu tam a zpět zachoval význam. Je nezávislý na ostatních fázích.

Fáze, kterou váš tarif nezahrnuje, má štítek Enterprise a nelze ji zapnout.

Výchozí nastavení dědí každá úloha, takže konfigurace enginu je základ, do kterého se slučuje přepsání pipelineConfig. Každá fáze má vlastní klíč:

{
  "preEdit": { "enabled": true },
  "humanEdit": {
    "enabled": true,
    "provider": "internal",
    "tier": "standard",
    "timeoutHours": 48,
    "qualityThreshold": 85
  },
  "postEdit": { "enabled": false },
  "rephrase": { "enabled": false },
  "contentLength": {
    "enabled": true,
    "mode": { "_tag": "fixedCap", "maxColumns": 40 }
  },
  "backTranslation": { "enabled": true }
}

Co jednotlivá pole řídí – který poskytovatel kontroly se použije, které překlady kontrolu přeskočí a jak dlouho se čeká – je zdokumentované na samostatné stránce dané fáze. Tato stránka vysvětluje, kde konfiguraci najdete a jak se obě vrstvy kombinují.

Přepsání pro konkrétní požadavek#

Většina úloh by měla běžet s výchozím nastavením enginu. Výjimkou je jedno odeslání, které potřebuje jinou pipeline – třeba jednorázová dávka marketingových textů, která chce fázi přeformulování, již váš engine běžně nechává vypnutou, nebo právní payload, který by ji měl naopak přeskočit. Upravovat engine kvůli jedné dávce by změnilo i všechny ostatní úlohy.

Proto v požadavku pošlete jen rozdíl. Do těla pipelineConfig``POST /jobs/localization přidejte objekt a ten přepíše výchozí nastavení enginu jen pro toto odeslání. Na enginu se nic nemění; další úloha bez přepsání zase poběží podle výchozího nastavení.

{
  "sourceLocale": "en",
  "targetLocales": ["de", "fr"],
  "data": { "headline": "Ship in every language." },
  "pipelineConfig": {
    "rephrase": { "enabled": true },
    "backTranslation": { "enabled": false }
  }
}

Tohle je pravidlo dědičnosti a právě díky němu zůstává přepsání malé: fáze, kterou uvedete, se přepíše; fáze, kterou vynecháte, převezme výchozí nastavení z engine. Výše uvedený požadavek pro tuto jedinou úlohu zapíná rephrase a vypíná backTranslation. preEdit, humanEdit, postEdit a contentLength uvedené nejsou, takže poběží přesně podle konfigurace v engine. Uvádíte jen to, co se liší.

Ještě dvě věci, které přepsání nedělá – říkáme je napřímo, protože právě tahle část vypadá, jako by zvládla všechno:

• Mění jen toto odeslání. Nezapisuje se zpět do enginu, takže takto neprovedete trvalou změnu konfigurace – od toho je karta Pipeline. Přepsání použijte pro jednorázový případ, kartu pro nové výchozí nastavení.
• Nemění to vlastní běhová pravidla dané fáze. Následná úprava se spustí jen tehdy, když lidská kontrola vytvořila výstup, takže zapnutí postEdit nic nezmění u úlohy, která nemá lidskou fázi, s níž by se dalo sladit – bez ohledu na to, ve které vrstvě jste ji zapnuli.

Ověřte, co se spustilo#

Konfigurace určuje, které fáze by se měly spustit; záznam samotné úlohy vám řekne, které se skutečně spustily. Úloha obsahuje pole steps[] a právě podle něj ověříte, že přepsání pro konkrétní požadavek opravdu zabralo – ne jen že jste ho odeslali.

Jak tyto záznamy číst – stepId u každé fáze, co znamená krok skipped a kde se zobrazují nekritická selhání – řeší samostatná stránka.

Další kroky#

Výchozí nastavení můžete nastavit na enginu a pak ho přepsat v požadavku. Odtud můžete odeslat úlohu s přepsáním nebo si zpětně projít kroky a ověřit, které fáze se spustily.