Traga seu próprio mecanismo

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

O recurso Traga seu próprio mecanismo (BYO Engine) permite a integração de mecanismos de tradução automática (tradução automática) externos ao Phrase para serem usados em fluxos de trabalho de tradução como qualquer outro responsável de tradução automática.

O BYO Engine é adequado para:

Empresas com modelos de tradução automática específicos de domínio.
LSPs com mecanismos de cliente personalizado ou pilhas de IA preferenciais.
Organizações com políticas internas que exigem o uso de mecanismos específicos (por exemplo, Gemini, LLMs internos, etc.).

Mecanismos de treinamento personalizado podem ser usados ou as traduções podem ser roteadas para LLMs internos ou responsáveis de tradução automática para manter controle total sobre qualidade, privacidade e custo, enquanto continua a se beneficiar das memórias de tradução (TM), glossários, QPS e do CAT Editor do Phrase.

Onde um BYO Engine pode ser usado

Uma vez integrado, um BYO Engine está disponível para pré-traduzir. Configure-o em um perfil de Language AI do Phrase e use esse perfil para pré-traduzir a partir de projetos do Phrase TMS, Phrase Portal, projetos do Phrase Strings, Phrase Studio e Language AI do Phrase via API.

Configurar um Traga seu próprio mecanismo

Construindo 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 suportar:
- Solicitações de tradução
- Suporte a par de idiomas
- Verificação de estado do mecanismo (o Phrase envia uma solicitação de estado)
A infraestrutura de suporte (mecanismo de tradução automática 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 de segmento e pedido.

Integrando o mecanismo em um perfil de tradução automática

Assim que o adaptador da API for implementado e implantado, o BYO Engine torna-se disponível no Phrase Language AI para seleção em perfis de tradução automática e pode ser atribuído a projetos.

Para conectar um BYO Engine a um perfil de tradução automática:

Na página de perfil de tradução automática do Phrase Language AI, clique em Conectar mecanismos de tradução automática.

A página Conectar mecanismo de tradução automática é exibida.
Selecione Bring Your Own (BYO) Engine.

A página de configuração do BYO Engine abre.
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. Ativado 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 de desempenho de chamada, não reduz o custo da tradução. Mantenha ativado 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 Ativar no perfil.

Dica

Ao usar um BYO Engine, não ative nenhum outro mecanismo no perfil de tradução automática. 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 editar no bloco do mecanismo.

Excluir um Bring Your Own Engine

Para excluir um BYO Engine:

Clique no ícone editar no bloco do mecanismo.
Clique em Remover Bring Your Own Engine.

FAQ

P:	Por que a solicitação de estado é necessária? Ela é enviada pelo Phrase ao mecanismo, ou espera-se que seja tratada pelo cliente?
A:	O Phrase envia a solicitação para verificar se o mecanismo funciona ou não.
P:	Uma solicitação pode conter 500 `maxItems` em `segmentos`. Isso implica que 500 frases do texto original devem ser traduzidas em tempo real?
A:	Chamadas síncronas incluem apenas até 5 segmentos, enquanto chamadas assíncronas podem incluir mais, até 500. Além disso, o tempo limite assíncrono é de cerca de 30 minutos.
P:	Todos os termos de um glossário são enviados em uma solicitação, ou apenas um subconjunto?
A:	Todos os termos do glossário são enviados.
P:	É possível conectar um LLM?
A:	Deve ser possível com um wrapper. Desde que o mecanismo retorne segmentos conforme definido no esquema, o Phrase não requer um mecanismo ou LLM específico.
P:	É possível realizar uma avaliação de qualidade (QE) Personalizada?
A:	A QE de terceiros não é suportada.
P:	Como as tags são tratadas?
A:	O conteúdo que o Phrase recebe é pré-processado. As tags HTML são convertidas em marcas, e essas marcas são passadas como estão.
P:	Podemos implementar apenas a abordagem assíncrona? Isso funcionará corretamente em todas as áreas do Phrase (pré-tradução, editor, etc.)?
A:	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?
A:	O mecanismo deve ser capaz de lidar com isso. Garanta o tratamento adequado de simultaneidade e segurança de thread em todos os endpoints, particularmente os assíncronos.
P:	Como funciona o Request Metadata?
A:	Ele deve permanecer estático, conforme definido durante a configuração do mecanismo.
P:	Como funciona o Segment Metadata?
A:	Atualmente, ele precisa fazer parte do esquema.
P:	Durante o processamento de tradução automática, o BYOE usa RAG para recuperar contexto?
A:	Não, o BYOE não usa RAG. Os usuários podem aproveitar memórias de tradução para determinar quais segmentos estão traduzidos, mas elas não são usadas dentro do processo de tradução automática em si. Isso ocorre porque os motores de tradução automática devem ser projetados especificamente para incorporar dados de memória de tradução via RAG, e em cenários BYOE não há controle sobre como os motores são construídos ou configurados.

Referência de Esquema de Adaptador

O adaptador deve retornar respostas que correspondam exatamente aos seguintes nomes de campo e valores de enum. 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 valor de enum estrito em minúsculas de 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. Example: { "languagePairs": [ { "sourceLanguage": "en", "targetLanguage": "es" } ] }
POST /translate e GET /translateAsyncResult/{id} devem retornar campos de nível superior sourceLanguage e targetLanguage, além de um array segments onde cada segmento inclui tanto um campo text (o texto original ecoado) quanto 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 enum: running para um trabalho ainda em processamento, done para um trabalho concluído com sucesso, ou failed para um trabalho que falhou. Para um trabalho que falhou, um campo opcional detail pode descrever a falha. Valores de exemplo: { \"status\": \"running\" }, { \"status\": \"done\" }, { \"status\": \"failed\", \"detail\": \"Description of translation failure\" }