A CLI do Lingo.dev conecta sua base de código a um engine de localização com um único campo de configuração. Cada chamada lingo.dev run passa pelo seu engine, aplicando automaticamente sua voz da marca, glossário, instruções e configuração de modelo. Sem alterar o código, sem novas dependências.
O que muda#
| Antes | Depois | |
|---|---|---|
| Fluxo de tradução | Fluxo padrão do Lingo.dev | Seu engine de localização |
| Voz da marca | Nenhuma | Aplicada por idioma de destino |
| Glossário | Nenhum | Correspondência semântica a cada solicitação |
| Instruções | Nenhuma | Incluídas por idioma de destino |
| Seleção de modelo | Padrão do Lingo.dev | Sua configuração de modelo com fallbacks |
| Avaliação de qualidade | Nenhuma | Seus avaliadores de IA configurados são executados automaticamente |
Configuração#
Adicione engineId ao i18n.json (opcional)
Para usar um engine específico, adicione o campo engineId à configuração do i18n.json. Você encontra o ID do seu engine no dashboard — ele começa com eng_ (por exemplo, eng_SxjMwMsfOIsvV1wh).
{
"version": "1.15",
"locale": {
"source": "en",
"targets": ["es", "fr", "de"]
},
"buckets": {
"json": {
"include": ["[locale]/messages.json"]
}
},
"engineId": "eng_SxjMwMsfOIsvV1wh"
}Todo o restante da configuração continua igual — idioma de origem, destinos, buckets. Se você omitir engineId, a CLI usará o engine padrão da sua organização.
Defina sua chave de API
A CLI se autentica com sua chave de API do Lingo.dev. Defina-a como uma variável de ambiente:
export LINGO_API_KEY="your-api-key"Ou salve-a em ~/.lingodotdevrc:
[auth.vnext]
apiKey = your-api-keyGere uma chave de API na página API Keys do dashboard.
Execute as traduções
lingo.dev runA CLI envia solicitações de tradução para o seu engine e grava os resultados de volta nos seus arquivos de idioma, aplicando automaticamente sua voz da marca, glossário, instruções e configuração de modelo.
Referência de configuração#
i18n.json#
| Campo | Descrição |
|---|---|
engineId | Opcional. O ID do seu engine (eng_...). Se omitido, o engine padrão da sua organização será usado. |
Todos os outros campos de i18n.json (version, locale, buckets) funcionam exatamente como na configuração padrão da CLI.
Variáveis de ambiente#
| Variável | Obrigatória | Padrão | Descrição |
|---|---|---|---|
LINGO_API_KEY | Sim | - | Sua chave de API do Lingo.dev |
LINGO_API_URL | Não | https://api.lingo.dev | URL base da API personalizada (para self-hosted ou staging) |
O que esperar#
Toda tradução gerada pela CLI passa pelo fluxo completo do seu engine:
- Voz da marca define o tom e o nível de formalidade por idioma
- Itens do glossário garantem a terminologia exata por meio de correspondência semântica
- Instruções aplicam regras linguísticas específicas de cada idioma
- Configurações de modelo selecionam o LLM certo com fallbacks automáticos
- Avaliadores de IA avaliam a qualidade automaticamente após cada solicitação
As traduções aparecem em Reports com o tipo de gatilho api, junto com solicitações da API e integrações.
