Nastavení překladové pipeline
Před spuštěním úlohy uložte nastavení fází engine a ověřte, které fáze se skutečně spustí.
Lokalizační úloha používá konfiguraci pipeline daného engine uloženou v okamžiku spuštění. Nastavte engine ještě před voláním /start. Pozdější úpravy engine ovlivní až budoucí spuštění, nikoli uloženou konfiguraci již běžící úlohy.
V rozhraní Studio otevřete kartu Pipeline daného engine nebo aktualizujte pipelineConfig prostřednictvím PATCH /v2/engines/:id. Volající potřebuje oprávnění k úpravám engine. Organizace musí mít přístup k funkcím, které vyžadují fáze, které se mohou spustit. Viz přístup k funkcím a ceník.
Uložení úplné konfigurace #
Před změnou stávající konfigurace načtěte engine pomocí GET /v2/engines/:id. Odesláním pipelineConfig tuto konfiguraci nahradíte; vynechané fáze dostanou výchozí nastavení. Ponechte proto všechna nastavení, která chcete zachovat.
Tento požadavek nastavuje překlad s následným přeformulováním. Nepovinné fáze, které v něm nejsou uvedené, jsou neaktivní:
PATCH /v2/engines/:id
Content-Type: application/json
X-API-Key: YOUR_API_KEY{
"pipelineConfig": {
"localize": { "enabled": true },
"rephrase": { "enabled": true }
}
}Pokud aplikace potřebuje pro určitou skupinu úloh jiná pravidla, použijte samostatný engine. Nastavte jeho modely a pokyny a při vytváření těchto úloh vyberte jeho ID.
Nastavení fází #
Pole v pipelineConfig | Nastavení |
|---|---|
localize | enabled: true. Překlad je povinný. |
preEdit, rephrase, postEdit, backTranslation | enabled typu boolean. Výchozí hodnota je false. |
qualityGate | enabled (logická hodnota) a strictness: "strict", "medium" nebo "lax" (výchozí hodnota "medium"). |
humanEdit | enabled, kladné celé číslo timeoutHours (výchozí hodnota 48) a routes pro kontrolu. |
contentLength | enabled a níže popsané mode. |
Následná úprava vyžaduje lidskou kontrolu. Pracuje s výstupem od člověka; při obejití kontroly nebo vypršení časového limitu nemusí být k dispozici žádný takový výstup k doladění.
Režimy délky obsahu jsou { "_tag": "noLongerThanSource" } (výchozí), { "_tag": "fixedCap", "maxColumns": 40 } nebo { "_tag": "matchSource", "tolerancePct": 10 }. Číselné hodnoty musí být kladná celá čísla. Jde o cílový počet zobrazovacích sloupců, nikoli o limity v bajtech nebo záruku, že se text vejde do uživatelského rozhraní.
Směrování lidské kontroly #
Nejprve vytvořte nebo vyberte rozhodovací skupiny. Každá položka humanEdit.routes určuje skupinu a její rozsah podle jazyka a adresáře. Tato konfigurace odesílá veškerý nově přeložený obsah do jedné skupiny:
{
"pipelineConfig": {
"localize": { "enabled": true },
"humanEdit": {
"enabled": true,
"timeoutHours": 48,
"routes": [
{
"pool": "YOUR_DECISION_POOL_ID",
"match": { "locales": [] }
}
]
}
}
}Prázdné pole locales zahrnuje všechny jazyky. Chcete-li zahrnout dokumenty v daném adresáři, přidejte "path": ["emails/**"] do match; shoda se ověřuje podle hodnoty key dokumentu. Cesty obsahují přesné názvy adresářů následované /**. Trasa bez path platí pro všechny adresáře. Konkrétnější shody adresáře a jazyka mají přednost; konfliktní trasy se odmítnou.
Chcete-li kontrolovat jen vybrané překlady, zapněte lidskou kontrolu a přidejte trasu, která tyto překlady zahrnuje. Vložte qualityGate do pipelineConfig a ostatní nastavení ponechte beze změny:
{
"qualityGate": { "enabled": true, "strictness": "medium" }
}Aktivní qualityGate můžete uložit, i když je humanEdit.enabled nastaveno na false. Studio uložené nastavení zachová i po vypnutí a opětovném zapnutí lidské kontroly. Při použití API zahrňte qualityGate do každého náhradního pipelineConfig, aby se nastavení zachovalo. Kontrolní brána se spustí pouze tehdy, když je lidská kontrola aktivní ve výsledné pipeline dané úlohy.
Brána ukládá nálezy pro každou jednotku. "strict" vyžaduje kontrolu při jakémkoli nálezu, "medium" při závažných nebo kritických nálezech a "lax" pouze při kritických nálezech. Kontrolu vyžaduje i překlad, který brána nedokázala prověřit. Pro možnost Vše nastavte qualityGate.enabled na false. Ke kontrole se tak odešle každý nový překlad, na který se vztahuje některá trasa. Opětovně použité překlady se znovu ke kontrole neposílají.
Samotné posouzení nezávisí na přísnosti; nastavená úroveň se uplatňuje až na nálezy. Změna úrovně v engine ovlivní budoucí spuštění úloh, nikoli uloženou konfiguraci již běžící úlohy. Popisy úrovní a definice závažnosti najdete v části úrovně brány kvality.
Starší API pro asynchronní lokalizaci stále přijímá humanEdit.qualityThreshold, ale ignoruje jej. Každý překlad v jazyce vybraném pro lidskou kontrolu se předá hodnotiteli. Chcete-li v aktuální pipeline kontrolovat jen vybrané překlady, nastavte Úroveň kontroly v nastavení Lidská kontrola daného engine.
Dostupnost kontroly závisí na plánu organizace a připojení skupiny k poskytovateli. Při spuštění úlohy se nedostupné funkce fází vypnou spolu s fázemi, které na nich závisejí. Skutečně použité workflow ověřte načtením cílových fází úlohy. Pokud publikování vyžaduje rozhodnutí člověka, zajistěte dodržení tohoto pravidla ještě před předáním staženého výstupu.
Kontrola výsledku #
Fáze brány kvality ukládá pro každou zkontrolovanou jednotku tento výstup:
{
"findings": [
{
"span": "Pay €20",
"reason": "The translation changes the source amount from €10 to €20.",
"category": "accuracy",
"severity": "critical"
}
]
}span je doslovná citace z překladu, který brána posuzovala. reason je jedna věta v angličtině. Kategorie jsou accuracy, terminology, guidance, fluency a style; stupně závažnosti jsou critical, major a minor. Prázdné pole findings znamená, že brána nenašla žádné chyby. Jednotky ke kontrole vracejí tento výstup jako quality; viz lidská kontrola. Hodnotitelé vidí nálezy vedle překladu ve Frontě.
Průběh fází rozlišuje dokončené, přeskočené a neúspěšné kroky i kroky s varováním. Lidská kontrola popisuje rozhodnutí a termíny. Průvodce pipeline vysvětluje, k čemu mohou být jednotlivé fáze užitečné a jak mohou pozdější fáze měnit text z předchozích fází.