Bring Your Own Engine

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

La funzionalità Bring Your Own Engine (BYO Engine) consente l'integrazione di motori di traduzione automatica (MT) esterni in Phrase, da utilizzare nei flussi di lavoro di traduzione come qualsiasi altro provider MT.

BYO Engine è adatto per:

Aziende con modelli MT specializzati in determinati ambiti.
LSP con motori client personalizzati o stack di IA preferiti.
Organizzazioni con politiche interne che richiedono l'utilizzo di motori specifici (ad es. Gemini, LLM interni, ecc.).

È possibile utilizzare motori addestrati su misura o instradare le traduzioni verso LLM o provider MT interni per mantenere il pieno controllo su qualità, privacy e costi, continuando a beneficiare delle memorie di traduzione (TM), dei glossari, di QPS e dell'editor CAT di Phrase.

Dove può essere utilizzato un BYO Engine

Una volta integrato, un BYO Engine è disponibile per la pre-traduzione. Configuralo in un profilo Phrase Language AI e utilizza tale profilo per la pre-traduzione da progetti Phrase TMS, Phrase Portal, progetti Phrase Strings, Phrase Studio e Phrase Language AI tramite API.

Configurare un Bring Your Own Engine

Creazione dell'adattatore

L'organizzazione deve creare e testare un adattatore API leggero. Questo adattatore abilita la comunicazione tra Phrase e il motore.

L'adattatore deve supportare:
- Richieste di traduzione
- Supporto per coppie linguistiche
- Controllo dello stato del motore (Phrase invia una richiesta di stato)
L'infrastruttura di supporto (motore MT o LLM) deve essere ospitata e gestita dall'organizzazione.
Phrase richiede le autorizzazioni per connettersi a tale infrastruttura.
L'adattatore deve restituire traduzioni con lo stesso numero di segmenti e lo stesso ordine.

Integrazione del motore in un profilo MT

Una volta implementato e distribuito l'adattatore API, BYO Engine diventa disponibile in Phrase Language AI per la selezione nei profili MT e può essere assegnato ai progetti.

Per connettere un BYO Engine a un profilo MT:

Dalla pagina del profilo MT di Phrase Language AI, fai clic su Connetti motori MT.

Viene visualizzata la pagina Connetti motore MT.
Seleziona Motore Bring Your Own (BYO).

Si apre la pagina di configurazione del motore BYO.
Inserisci l'URL di base del motore.
Fornisci le credenziali in base al metodo di autenticazione (intestazione HTTP o credenziali client (OAuth 2.0)).
Scegli se utilizzare la cache di traduzione. Abilitata per impostazione predefinita.

Riduce il traffico e accelera la risposta di traduzione riutilizzando i segmenti tradotti negli ultimi 30 giorni. Si tratta solo di un'ottimizzazione delle prestazioni delle chiamate; non riduce il costo della traduzione. Lasciala abilitata per impostazione predefinita e disabilitala solo durante lo sviluppo dell'adattatore del motore sottostante.
Se necessario, fornisci ulteriori informazioni sul motore nella sezione Etichette personalizzate.
Fai clic su Convalida connessione per verificare che l'integrazione del motore funzioni.
Fai clic su Aggiungi.

Il motore è ora disponibile per essere abilitato nel profilo.

Consiglio

Quando si utilizza un BYO Engine, non abilitare nessun altro motore nel profilo MT. Ciò garantisce che il BYO Engine venga selezionato per la pre-traduzione.

Modificare un Bring Your Own Engine

Per modificare un BYO Engine, fai clic sull'icona di modifica nel riquadro del motore.

Eliminare un Bring Your Own Engine

Per eliminare un BYO Engine:

Fai clic sull'icona di modifica nel riquadro del motore.
Fai clic su Rimuovi motore Bring Your Own.

FAQ

D:	Perché la richiesta di stato è obbligatoria? Viene inviata da Phrase al motore o deve essere gestita dal cliente?
R:	Phrase invia la richiesta per verificare se il motore funziona o meno.
D:	Una richiesta può contenere 500 `maxItems` in `segmenti`. Ciò implica che 500 frasi sorgente debbano essere tradotte in tempo reale?
R:	Le chiamate sincrone e asincrone accettano entrambe da 1 a 500 segmenti. In pratica, le chiamate sincrone dall'editor contengono un singolo segmento, mentre i flussi di lavoro API e batch (pre-traduzione, analisi) possono inviarne molti, fino a 500. Il flusso asincrono utilizza lo stesso limite e separa solo l'invio del lavoro dal recupero del risultato. Il timeout asincrono è di circa 30 minuti. Non passiamo automaticamente da sincrono ad asincrono se il tuo adattatore rifiuta una richiesta. Per ulteriori dettagli su cosa aspettarsi da Phrase (conteggio dei segmenti, test di convalida del motore, nuovi tentativi e limiti di tempo), consulta la guida a BYO Engine.
D:	Tutti i termini di un glossario vengono inviati in una richiesta, o solo un sottoinsieme?
R:	Vengono inviati tutti i termini del glossario.
D:	È possibile collegare un LLM?
R:	Dovrebbe essere possibile con un wrapper. Finché il motore restituisce segmenti come definito nello schema, Phrase non richiede un motore o un LLM specifico.
D:	È possibile una valutazione della qualità (QE) personalizzata?
R:	La QE di terze parti non è supportata.
D:	Come vengono gestiti i tag?
R:	Il contenuto che Phrase riceve viene pre-elaborato. I tag HTML vengono convertiti in contrassegni e tali contrassegni vengono trasmessi così come sono.
D:	Possiamo implementare solo l'approccio asincrono? Funzionerà correttamente in tutte le aree di Phrase (pre-traduzione, Editor, ecc.)?
R:	No, entrambi gli approcci (idealmente tutti gli endpoint) devono essere implementati. L'endpoint sincrono viene utilizzato, ad esempio, dall'Editor, mentre quello asincrono viene utilizzato in aree come la pre-traduzione.
D:	Cosa succede quando il motore riceve più richieste contemporaneamente?
R:	Il motore deve essere in grado di gestire questa situazione. Assicurati che tutti gli endpoint gestiscano correttamente le richieste simultanee e la sicurezza dei thread, in particolare gli endpoint asincroni.
D:	Come funzionano i metadati della richiesta?
R:	I metadati della richiesta, configurati come etichette personalizzate nella configurazione di BYO Engine, supportano segnaposto dinamici che vengono risolti prima che la richiesta raggiunga l'adattatore: `{project_uid}`, `{job_uid}` e `{idm_organization_uid}`. Ad esempio, un'etichetta personalizzata con chiave `project_uid` e valore `{project_uid}` invia l'effettivo UID del progetto Phrase TMS all'adattatore. La risoluzione dei segnaposto si applica solo all'interno dei valori di testo. Un segnaposto sconosciuto viene inviato all'adattatore così com'è, senza risoluzione.
D:	Come funzionano i metadati del segmento?
R:	Attualmente, deve far parte dello schema.
D:	Durante l'elaborazione MT, BYOE utilizza RAG per recuperare il contesto?
R:	No, BYOE non utilizza RAG. Gli utenti possono sfruttare le TM per determinare quali segmenti sono tradotti, ma non vengono utilizzate all'interno del processo MT stesso. Questo perché i motori MT devono essere progettati appositamente per integrare i dati delle TM tramite RAG e, negli scenari BYOE, non è possibile controllare come vengono sviluppati o configurati.

Riferimento allo schema dell'adattatore

L'adattatore deve restituire risposte che corrispondano esattamente ai seguenti nomi di campo e valori enum. Una mancata corrispondenza comporta un generico INTERNAL_ERROR da parte di Phrase, anche quando l'adattatore stesso restituisce una risposta 200 OK.

POST /status deve restituire un campo status con un valore enum rigorosamente in minuscolo, pari a ok oppure not_ok. Esempio: { "status": "ok" }
POST /languages deve restituire un array languagePairs (camelCase), in cui ogni voce contiene un campo sourceLanguage e un campo targetLanguage. Esempio: { "languagePairs": [ { "sourceLanguage": "en", "targetLanguage": "es" } ] }
POST /translate e GET /translateAsyncResult/{id} devono restituire campi sourceLanguage e targetLanguage di primo livello, oltre a un array segments in cui ogni segmento include sia un campo text (il testo sorgente riportato) sia un campo translatedText. Restituire solo translatedText, o utilizzare un nome di chiave diverso, causa un errore di deserializzazione.
POST /translateAsync richiede solo un campo id nella sua risposta. Un campo status non fa parte di questo schema di risposta e viene ignorato se presente.
GET /translateAsyncStatus/{id} deve restituire un campo status con uno dei tre valori enum: running per un'attività ancora in corso, done per un'attività completata correttamente oppure failed per un'attività non riuscita. Per un'attività non riuscita, il campo facoltativo detail può descrivere l'errore. Valori di esempio: { "status": "running" }, { "status": "done" }, { "status": "failed", "detail": "Descrizione dell'errore di traduzione" }