Zapojte lidskou kontrolu do úloh API

Směrujte překlady ke kontrolorům, sledujte jejich rozhodnutí a získejte výsledné dokumenty.

Zařaďte lidskou kontrolu tam, kde překlad před předáním vyžaduje lidský úsudek. Engine směruje každý dokument a cílový jazyk do rozhodovací skupiny. Kontroloři schválí nebo upraví jednotky, které lze kontrolovat, a pipeline pak pokračuje až k vytvoření souboru ke stažení.

Začněte s funkčním překladem přes API. Potřebujete také plán s funkcemi pro lidskou kontrolu, rozhodovací skupinu a kontrolora s přístupem k překladům daného engine.

Nastavte kontrolu před spuštěním #

Otevřete kartu Pipeline daného engine a zapněte Lidskou kontrolu. Vyberte rozhodovací skupinu, jazyky a případně omezte rozsah na určité adresáře. Směrování podle adresářů se řídí hodnotou key, kterou posíláte pro každý dokument. Používejte proto stabilní cesty, například emails/order-confirmation.json.

Chcete-li kontrolovat veškerý nově přeložený obsah v dané trase, zvolte Vše. Brána kvality tak zůstane vypnutá. Chcete-li kontrolovat jen vybrané překlady, zvolte Přísná, Střední nebo Mírná. Brána uvádí chyby včetně jejich závažnosti a kategorií. Zvolená úroveň určuje, které stupně závažnosti vyžadují kontrolu. Ke kontrole se odešle i překlad, který brána nedokázala prověřit. Popisy najdete v části úrovně brány kvality. Opětovně použité překlady slouží jako kontext pouze pro čtení a automaticky se nezařazují k nové kontrole.

Zvolte časový limit, který vyhovuje týmu kontrolorů. Lhůta začíná běžet, jakmile je cílový překlad připraven. Po jejím uplynutí mohou jednotky bez rozhodnutí pokračovat s předchozími překlady. Pokud každý publikovaný překlad vyžaduje rozhodnutí člověka, musí splnění tohoto požadavku zajistit kontrola před publikováním ve vaší aplikaci.

Pokud je nastavení engine součástí vaší aplikace, nakonfigurujte pipeline přes API.

Odešlete obsah #

Vytvořte úlohu, nahrajte chybějící artefakty a zavolejte /start. Uložte ID úlohy spolu s revizí zdroje a zamýšlenými pravidly kontroly. Konfigurace pipeline daného engine se zaznamená při spuštění. Pozdější změny pravidla kontroly běžící úlohy neovlivní.

Načtěte ID dokumentů úlohy a cílové jazyky. Hodnota humanEdit v přehledu průběhu fází cílového překladu označuje práci ke kontrole, zatímco API pro kontrolu poskytuje samotné jednotky a rozhodnutí. Během práce kontrolorů může úloha zůstat ve stavu Running.

Poskytněte kontrolorovi potřebný kontext #

Kontroloři mohou na řídicím panelu přejít do Fronta → Druh → Lidská kontrola, kde se vedle překladu zobrazují zjištění brány kvality. Překlady mohou schválit beze změn nebo je před odesláním upravit. Zajistěte, aby měl kontrolor na očích zdroj, cílový jazyk, zástupné symboly a požadovanou terminologii.

Pokud má vaše aplikace vlastní rozhraní pro kontrolu, načtěte seznam otevřených kontrol pomocí GET /v2/organizations/:orgId/localization/reviews a poté načtěte kontrolu pro vybraný dokument a jazyk. Při odesílání rozhodnutí se ověřujte jako kontrolor pomocí osobního klíče nebo uživatelské relace, nikoli pomocí klíče organizace používaného službou na pozadí.

Pro povinné jednotky odešlete rozhodnutí Approved nebo Edited. U interních kontrol lze rozhodnutí odesílat po částech. Při převzetí externí kontroly je nutné najednou odeslat rozhodnutí pro všechny zbývající povinné jednotky. Poskytovatel si přitom stále může účtovat poplatek. Přesné formáty dat a chyby najdete v části Reference pro kontrolu.

Získejte a ověřte konečný výsledek #

Jakmile kontrolor odešle rozhodnutí, pokračujte v načítání lokalizační úlohy. Cílový soubor stáhněte teprve tehdy, až bude jeho stav Completed. Dokončení kontroly a dokončení souboru jsou samostatné kroky, protože ještě mohou probíhat následné úpravy, úpravy délky nebo zpětný překlad.

Pokud požadujete přesné znění schválené člověkem, vypněte pozdější fáze přeformulování a zkontrolujte konečný výstup. Pokud potřebujete doložit schválení, ověřte rozhodnutí z kontroly a jednotky s vypršeným časovým limitem. Dokončenou fázi nepovažujte za důkaz, že člověk schválil každou jednotku.

Publikujte pouze tehdy, pokud revize zdroje stále odpovídá a byla dodržena požadovaná pravidla kontroly. Opožděný překlad nesmí nahradit výstup pro novější revizi zdroje.

Obnovte zpracování po přerušení #

Po vypršení časového limitu klienta zachovejte původní identifikátory úlohy a kontroly. Nová úloha spustí samostatný proces překladu a kontroly. Pokud se odpověď na odeslané rozhodnutí ztratí, načtěte kontrolu a ověřte uložená rozhodnutí a ID kontrolorů. Tentýž kontrolor může zopakovat totožné rozhodnutí, dokud cílový překlad přijímá rozhodnutí. U dokončeného cílového překladu se ale může vrátit kód 409, i když první odeslání proběhlo úspěšně. Úspěšně uložená rozhodnutí jsou konečná.

Po uplynutí lhůty pro kontrolu prověřte přijatá rozhodnutí, jednotky bez rozhodnutí a výsledný soubor. Zachovejte dokončenou práci a uváženě zvolte další postup: pozastavte publikování, zajistěte další kontrolu nebo přijměte výslovně definovaný náhradní postup.