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 per essere utilizzati nei flussi di lavoro di traduzione come qualsiasi altro fornitore MT.

Il BYO Engine è adatto per:

Aziende con modelli MT specifici per il dominio.
LSP con motori personalizzati del cliente o stack IA preferiti.
Organizzazioni con politiche interne che richiedono l'uso di motori specifici (ad es. Gemini, LLM interni, ecc.).

È possibile utilizzare motori personalizzati oppure instradare le traduzioni verso LLM interni o fornitori MT per mantenere il pieno controllo su qualità, privacy e costi, continuando a beneficiare delle memorie di traduzione (TM), glossari, QPS e del CAT Editor di Phrase.

Dove può essere utilizzato un BYO Engine

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

Configura 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 la combinazione linguistica
- 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 le traduzioni con lo stesso conteggio di segmento e ordine.

Integrazione del motore in un profilo MT

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

Per connettere un motore BYO 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 motore BYO.
Inserire l'URL del motore di base.
Fornire le credenziali a seconda del metodo di autenticazione (intestazione HTTP o credenziali cliente (OAuth 2.0)).
Selezionare se usare 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. Questa è solo un'ottimizzazione delle prestazioni delle chiamate, non riduce il costo di traduzione. Mantenere abilitato per impostazione predefinita, disabilitare solo mentre l'adattatore del motore sottostante è in fase di sviluppo attivo.
Se richiesto, fornire eventuali informazioni aggiuntive per il motore sotto etichette personalizzate.
Fare clic su Convalida connessione per verificare se l'integrazione del motore funziona.
Fare clic su Aggiungi.

Il motore è ora disponibile per l'abilitazione nel profilo.

Consiglio

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

Modifica un motore Bring Your Own Engine

Per modificare un motore BYO, fare clic sull'icona di modifica sul riquadro del motore.

Elimina un motore Bring Your Own Engine

Per eliminare un motore BYO:

Fare clic sull'icona di modifica sul riquadro del motore.
Fare clic su Remove Bring Your Own Engine.

FAQ

Q:	Perché la richiesta di stato è obbligatoria? Viene inviata da Phrase al motore o deve essere gestita dal cliente?
A:	Phrase invia la richiesta per verificare se il motore funziona o meno.
Q:	Una richiesta può contenere 500 `maxItems` in `segmenti`. Ciò implica che 500 frasi di origine debbano essere tradotte in tempo reale?
A:	Le chiamate sincrone includono solo fino a 5 segmenti, mentre le chiamate asincrone possono includerne di più, fino a 500. Inoltre, il timeout asincrono è di circa 30 minuti.
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 un motore o un LLM specifico.
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, entrambi gli approcci (idealmente tutti gli endpoint) devono essere implementati. L'endpoint sincrono viene usato, ad esempio, dall'editor, mentre quello asincrono viene usato in aree come la pre-traduzione.
Q:	Cosa succede quando il motore riceve più richieste contemporaneamente?
A:	Il motore deve essere in grado di gestire questo aspetto. Assicurati una corretta gestione della concorrenza e della sicurezza dei thread in tutti gli endpoint, in particolare quelli asincroni.
Q:	Come funziona Request Metadata?
A:	Deve rimanere statico, come definito durante la configurazione del motore.
Q:	Come funziona Segment Metadata?
A:	Attualmente, deve far parte dello schema.
Q:	Durante l'elaborazione MT, BYOE usa RAG per recuperare il contesto?
A:	No, BYOE non usa RAG. Gli utenti possono sfruttare le TM per determinare quali segmenti sono tradotti, ma non vengono utilizzate all'interno del processo di MT stesso. Questo perché i motori di MT devono essere specificamente progettati per incorporare i dati TM tramite RAG e, negli scenari BYOE, non vi è alcun controllo su come i motori vengono costruiti o configurati.

Riferimento schema adattatore

L'adattatore deve restituire risposte che corrispondano esattamente ai seguenti nomi di campo e valori enum. Una mancata corrispondenza comporta un INTERNAL_ERROR generico da 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 di 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, più un array segments in cui ogni segmento include sia un campo text (il testo di origine 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 fallito. Per un lavoro fallito, un campo detail opzionale può descrivere il fallimento. Valori di esempio: { "status": "running" }, { "status": "done" }, { "status": "failed", "detail": "Description of translation failure" }