Modelos e alternativas
Selecione modelos para pares de idiomas e entenda qual candidato é usado na próxima tentativa quando outro não consegue concluir a solicitação.
A configuração de modelos de um engine de localização responde a duas perguntas: qual modelo deve traduzir um par de idiomas e qual deve ser tentado se esse modelo não conseguir concluir a solicitação? Os modelos alternativos entram em ação em caso de falhas de execução. Eles não geram várias traduções para escolher a que tem a maior pontuação de qualidade.
Por padrão, o formulário de criação do aplicativo web define um modelo principal recomendado e um alternativo para todos os pares de idiomas. Você pode manter essa cobertura ampla ou escolher uma configuração mais específica durante a criação ou depois.
Escolha o modelo e sua cobertura #
Consulte o catálogo de modelos compatíveis na interface de configuração ou o MCP da conta para obter os identificadores e limites de contexto atuais. A disponibilidade muda, e uma lista copiada pode ficar desatualizada. Com uma chave da Mistral AI, a interface de configuração também oferece modelos de chat acessíveis com sua chave que não estão no catálogo; consulte modelos além do catálogo.
Um identificador exato de modelo indica uma seleção específica. Um alias variável pode apontar para outro modelo no futuro. Fixar o identificador facilita explicar a escolha, mas não torna o resultado determinístico nem garante que o modelo seja adequado ao seu conteúdo.
Configure o par de idiomas de origem e destino. Use uma cobertura com curinga para definir um padrão geral e idiomas específicos quando o par precisar de outro candidato. Confirme que os pares importantes têm uma configuração aplicável; tentar novamente não resolve a falta de configuração de modelo.
Entenda a ordem das tentativas #
O engine de localização ordena os candidatos por:
- Nível de correspondência do idioma de destino.
- Nível de correspondência do idioma de origem.
- Especificidade do idioma de destino.
- Especificidade do idioma de origem.
- Prioridade configurada.
Uma prioridade de valor um não prevalece sobre uma correspondência de idioma melhor. Por exemplo, uma configuração específica de inglês para de-CH pode vir antes de uma configuração ampla com curinga, mesmo que esta tenha sido inserida primeiro. Resolução de idiomas explica quais idiomas se aplicam a uma solicitação, como um idioma sem região especificada representa sua região padrão e como os níveis de correspondência os classificam.
As tentativas têm um prazo de execução. Se um candidato falhar ou exceder o tempo limite, o próximo poderá ser tentado. Se todas as opções da sequência se esgotarem, a solicitação falhará. Um modelo alternativo reduz a dependência de um único modelo, mas não supre a falta de cobertura nem garante sucesso quando todos os candidatos falham.
Compare a qualidade separadamente da confiabilidade #
Use as evidências da solicitação para identificar qual modelo foi de fato usado e se um modelo alternativo foi acionado. Uma recusa do provedor, um erro de configuração e uma tradução concluída, mas inadequada, exigem soluções diferentes.
Para executar os modelos de um provedor com a chave da própria organização, consulte BYOK. Uma chave de API da Lingo.dev e uma credencial de um provedor externo autorizam o acesso a serviços diferentes; selecionar um modelo não estabelece uma conexão por credenciais.
A referência da API de tradução aborda os campos de conteúdo JSON e de contexto. Cada tarefa exige um engineId. Confirme que o engine selecionado está habilitado e tem cobertura de modelos para cada par de idiomas solicitado. Examine as tentativas de execução dos modelos na tarefa para identificar qual modelo de fato processou cada lote.