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:

  1. Nível de correspondência do idioma de destino.
  2. Nível de correspondência do idioma de origem.
  3. Especificidade do idioma de destino.
  4. Especificidade do idioma de origem.
  5. 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.