Bring Your Own Engine

O conteúdo de toda a Central de Ajuda é traduzido automaticamente de inglês pelo Phrase Language AI.

O recurso Bring Your Own Engine (BYO Engine) permite integrar mecanismos de tradução automática (MT) externos ao Phrase para uso em fluxos de trabalho de tradução, como qualquer outro provedor de MT.

O BYO Engine é adequado para:

Empresas com modelos de MT específicos para um domínio.
Provedores de serviços linguísticos com mecanismos personalizados para clientes ou conjuntos de ferramentas de IA de sua preferência.
Organizações com políticas internas que exigem o uso de mecanismos específicos (por exemplo, o Gemini, LLMs internos, etc.).

É possível usar mecanismos treinados de forma personalizada ou encaminhar as traduções para LLMs internos ou provedores de MT, mantendo controle total sobre a qualidade, a privacidade e os custos e continuando a aproveitar as memórias de tradução (TM), os glossários, o QPS e o editor CAT do Phrase.

Onde um BYO Engine pode ser usado

Uma vez integrado, um BYO Engine fica disponível para pré-tradução. Configure-o em um perfil do Phrase Language AI e use esse perfil para fazer a pré-tradução de projetos do Phrase TMS, do Phrase Portal, de projetos do Phrase Strings, do Phrase Studio e do Phrase Language AI via API.

Configurar o Bring Your Own Engine

Como criar o adaptador

A organização deve construir e testar um adaptador de API leve. Este adaptador permite a comunicação entre o Phrase e o mecanismo.

O adaptador deve oferecer suporte a:
- Solicitações de tradução
- Suporte a pares de idiomas
- Verificação de status do mecanismo (o Phrase envia uma solicitação de status)
A infraestrutura de suporte (mecanismo de MT ou LLM) deve ser hospedada e mantida pela organização.
O Phrase requer permissões para se conectar a essa infraestrutura.
O adaptador deve retornar traduções com a mesma contagem e ordem de segmentos.

Integrar o mecanismo a um perfil de MT

Após a implementação e implantação do adaptador de API, o BYO Engine fica disponível no Phrase Language AI para seleção em perfis de MT e pode ser atribuído a projetos.

Para conectar um BYO Engine a um perfil de MT:

Na página do perfil de MT do Phrase Language AI, clique em Conectar mecanismos de MT.

A página Conectar mecanismo de MT é exibida.
Selecione Bring Your Own (BYO) Engine.

A página de configuração do BYO Engine é aberta.
Insira a URL base do mecanismo.
Forneça as credenciais dependendo do Método de autenticação (cabeçalho HTTP ou credenciais de cliente (OAuth 2.0)).
Selecione se deseja Usar cache de tradução. Habilitado por padrão.

Reduz o tráfego e acelera a resposta da tradução reutilizando segmentos traduzidos nos últimos 30 dias. Esta é apenas uma otimização do desempenho das chamadas; não reduz o custo da tradução. Mantenha habilitado por padrão; desabilite apenas enquanto o adaptador do mecanismo subjacente estiver em desenvolvimento ativo.
Se necessário, forneça qualquer informação adicional para o mecanismo em Rótulos personalizados.
Clique em Validar conexão para verificar se a integração do mecanismo funciona.
Clique em Adicionar.

O mecanismo agora está disponível para ser habilitado no perfil.

Dica

Ao usar um BYO Engine, não habilite nenhum outro mecanismo no perfil de MT. Isso garante que o BYO Engine seja selecionado para a pré-tradução.

Editar um Bring Your Own Engine

Para editar um BYO Engine, clique no ícone de edição no bloco do mecanismo.

Excluir um Bring Your Own Engine

Para excluir um BYO Engine:

Clique no ícone de edição no bloco do mecanismo.
Clique em Remover Bring Your Own Engine.

Perguntas frequentes

P:	Por que a solicitação de status é necessária? Ela é enviada pelo Phrase ao mecanismo ou espera-se que seja tratada pelo cliente?
R:	O Phrase envia a solicitação para verificar se o mecanismo funciona ou não.
P:	Uma solicitação pode conter 500 `maxItems` em `segments`. Isso implica que 500 frases de origem devem ser traduzidas em tempo real?
R:	Chamadas síncronas e assíncronas aceitam de 1 a 500 segmentos. Na prática, chamadas síncronas do editor contêm um único segmento, enquanto fluxos de trabalho de API e em lote (pré-tradução, análise) podem enviar muitos, até 500. O fluxo assíncrono usa o mesmo limite e apenas separa o envio do trabalho da obtenção do resultado. O tempo limite assíncrono é de cerca de 30 minutos. Não alternamos automaticamente do modo síncrono para o assíncrono se o seu adaptador rejeitar uma solicitação. Para obter mais detalhes sobre o que esperar do Phrase (contagens de segmentos, teste de validação do mecanismo, novas tentativas e limites de tempo), consulte o guia do BYO Engine.
P:	Todos os termos de um glossário são enviados em uma solicitação ou apenas um subconjunto?
R:	Todos os termos do glossário são enviados.
P:	É possível conectar um LLM?
R:	Deve ser possível com um wrapper. Desde que o mecanismo retorne segmentos conforme definido no esquema, o Phrase não exige um mecanismo ou LLM específico.
P:	É possível realizar uma avaliação de qualidade (QE) personalizada?
R:	A QE de terceiros não é suportada.
P:	Como as tags são tratadas?
R:	O conteúdo que o Phrase recebe é pré-processado. As tags HTML são convertidas em marcas, e essas marcas são transmitidas como estão.
P:	Podemos implementar apenas a abordagem assíncrona? Funcionará corretamente em todas as áreas do Phrase (pré-tradução, Editor, etc.)?
R:	Não, ambas as abordagens (idealmente todos os endpoints) devem ser implementadas. O endpoint síncrono é usado, por exemplo, pelo Editor, enquanto o assíncrono é usado em áreas como a pré-tradução.
P:	O que acontece quando o mecanismo recebe várias solicitações ao mesmo tempo?
R:	O mecanismo deve ser capaz de lidar com isso. Garanta o tratamento adequado da concorrência e da segurança de threads em todos os endpoints, particularmente nos assíncronos.
P:	Como funcionam os metadados da solicitação?
R:	Os metadados da solicitação, configurados como Rótulos personalizados na configuração do BYO Engine, suportam espaços reservados dinâmicos que são resolvidos antes que a solicitação chegue ao adaptador: `{project_uid}`, `{job_uid}` e `{idm_organization_uid}`. Por exemplo, um Rótulo personalizado com a chave `project_uid` e o valor `{project_uid}` envia o UID real do projeto do Phrase TMS para o adaptador. A resolução de espaços reservados só se aplica dentro de valores de texto. Um espaço reservado desconhecido é enviado ao adaptador como escrito, sem resolução.
P:	Como funcionam os metadados de segmento?
R:	Atualmente, os metadados de segmento precisam fazer parte do esquema.
P:	Durante o processamento de MT, o BYOE usa RAG para recuperar contexto?
R:	Não, o BYOE não usa RAG. Os usuários podem usar memórias de tradução (TMs) para determinar quais segmentos são traduzidos, mas elas não são usadas no próprio processo de MT. Isso ocorre porque os mecanismos de MT precisam ser projetados especificamente para incorporar dados de memórias de tradução via RAG e, em cenários de BYOE, não há controle sobre como esses mecanismos são desenvolvidos ou configurados.

Referência do esquema do adaptador

O adaptador deve retornar respostas que correspondam exatamente aos seguintes nomes de campo e valores de enumeração. Uma incompatibilidade resulta em um INTERNAL_ERROR genérico do Phrase, mesmo quando o próprio adaptador retorna uma resposta 200 OK.

POST /status deve retornar um campo status com um dos seguintes valores de enumeração, escritos exatamente em letras minúsculas: ok ou not_ok. Exemplo: { "status": "ok" }
POST /languages deve retornar um array languagePairs (camelCase), com cada entrada contendo um campo sourceLanguage e um campo targetLanguage. Exemplo: { "languagePairs": [ { "sourceLanguage": "en", "targetLanguage": "es" } ] }
POST /translate e GET /translateAsyncResult/{id} devem retornar os campos sourceLanguage e targetLanguage no nível superior, além de um array segments em que cada segmento inclui um campo text (o texto de origem retornado sem alterações) e um campo translatedText. Retornar apenas translatedText ou usar um nome de chave diferente causa uma falha de desserialização.
POST /translateAsync requer apenas um campo id em sua resposta. Um campo status não faz parte deste esquema de resposta e é ignorado se estiver presente.
GET /translateAsyncStatus/{id} deve retornar um campo status usando um dos três valores de enumeração: running para um trabalho ainda em processamento, done para um trabalho concluído com sucesso ou failed para um trabalho com falha. Para um trabalho com falha, um campo opcional detail pode descrever a falha. Valores de exemplo: { "status": "running" }, { "status": "done" }, { "status": "failed", "detail": "Descrição da falha de tradução" }