BYO 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 specifici per il dominio.
Gli LSP con motori client personalizzati o stack di IA preferiti.
Organizzazioni con politiche interne che richiedono l'uso 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 usa quel profilo per la pre-traduzione da progetti Phrase TMS, Phrase Portal, progetti Phrase Strings, Phrase Studio e Phrase Language AI tramite API.

Configurare un BYO Engine

Creazione dell'adattatore

L'organizzazione deve creare e testare un adattatore API leggero. Questo adattatore consente 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, il 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, fare clic su Connetti motori MT.

Viene visualizzata la pagina Connetti motore MT.
Selezionare Bring Your Own (BYO) Engine.

Si apre la pagina di configurazione del BYO Engine.
Inserire l'URL del motore di base.
Fornire le credenziali a seconda del Metodo di autenticazione (intestazione HTTP o credenziali client (OAuth 2.0)).
Selezionare se Utilizzare la cache di traduzione. Abilitato per impostazione predefinita

Riduce il traffico e velocizza 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. Mantenere abilitato per impostazione predefinita, disabilitare solo mentre l'adattatore del motore sottostante è in fase di sviluppo attivo.
Se necessario, fornire ulteriori informazioni per il motore in Etichette personalizzate.
Fare clic su Convalida connessione per verificare se l'integrazione del motore funziona.
Fai clic su Aggiungi.

Il motore è ora disponibile per l'abilitazione 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.

Modifica di un BYO Engine

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

Elimina un BYO Engine

Per eliminare un BYO Engine:

Fai clic sull'icona di modifica nel riquadro del motore.
Fai clic su Rimuovi BYO Engine.

DOMANDE FREQUENTI

Q:	Perché la richiesta di stato è necessaria? Viene inviata da Phrase al motore, o si prevede che sia gestita dal cliente?
A	Phrase invia la richiesta per verificare se il motore funziona o meno.
Q:	Una richiesta può contenere 500 `maxItems` in `segments`. Ciò implica che 500 frasi sorgente debbano essere tradotte in tempo reale?
A	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 eseguiamo automaticamente il fallback 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, tentativi e limiti di tempo), consulta la guida BYO Engine.
Q:	Tutti i termini di un glossario vengono inviati in una richiesta, o solo un sottoinsieme?
A	Vengono inviati tutti i termini del glossario.
Q:	È possibile collegare un LLM?
A	Dovrebbe essere possibile con un wrapper. Finché il motore restituisce segmenti come definito nello schema, Phrase non richiede uno specifico motore o LLM.
Q:	È possibile una valutazione della qualità (QE) personalizzata?
A	La QE di terze parti non è supportata.
Q:	Come vengono gestiti i tag?
A	Il contenuto che Phrase riceve viene pre-elaborato. I tag HTML vengono convertiti in contrassegni e tali contrassegni vengono trasmessi così come sono.
Q:	Possiamo implementare solo l'approccio asincrono? Funzionerà correttamente in tutte le aree di Phrase (pre-traduzione, Editor, ecc.)?
A	No, devono essere implementati entrambi gli approcci (idealmente tutti gli endpoint). L'endpoint sincrono viene utilizzato, ad esempio, dall'Editor, mentre quello asincrono viene utilizzato in aree come la pre-traduzione.
Q:	Cosa succede quando il motore riceve più richieste contemporaneamente?
A	Il motore deve essere in grado di gestirlo. Assicurati una corretta gestione della concorrenza e della sicurezza dei thread in tutti gli endpoint, in particolare quelli asincroni.
Q:	Come funzionano i Metadati della Richiesta?
A	Devono rimanere statici, come definito durante la configurazione del motore.
Q:	Come funzionano i Metadati del Segmento?
A	Attualmente, devono far parte dello schema.
Q:	Durante l'elaborazione MT, BYOE utilizza la RAG per recuperare il contesto?
A	No, BYOE non utilizza RAG. Gli utenti possono sfruttare le TM per determinare quali segmenti vengono tradotti, ma non vengono utilizzate all'interno del processo di MT stesso. Questo perché i motori di MT devono essere progettati specificamente per incorporare i dati delle TM tramite RAG e, negli scenari BYOE, non vi è alcun controllo su come i motori vengono costruiti 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 o not_ok. Esempio: { "status": "ok" }
POST /languages deve restituire un array languagePairs (camelCase), con ogni voce contenente 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) che 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 utilizzando uno dei tre valori enum: running per un lavoro ancora in elaborazione, done per un lavoro completato con successo, o failed per un lavoro non riuscito. Per un lavoro non riuscito, un campo opzionale detail può descrivere il fallimento. Valori di esempio: { "status": "running" }, { "status": "done" }, { "status": "failed", "detail": "Descrizione dell’errore di traduzione" }