A CLI do Lingo.dev liga a sua base de código a um motor de localização através de um único campo de configuração. Cada chamada lingo.dev run passa pelo seu motor, aplicando automaticamente a voz da marca, o glossário, as instruções e a configuração do modelo. Sem alterações ao código, sem novas dependências.
O que muda#
| Antes | Depois | |
|---|---|---|
| Pipeline de tradução | Pipeline predefinido do Lingo.dev | O seu motor de localização |
| Voz da marca | Nenhuma | Aplicada por idioma de destino |
| Glossário | Nenhum | Correspondência semântica por pedido |
| Instruções | Nenhuma | Incluídas por idioma de destino |
| Seleção de modelo | Predefinição do Lingo.dev | A sua configuração de modelo com fallbacks |
| avaliação por IA | Nenhuma | Os seus avaliadores de IA configurados são executados automaticamente |
Configuração#
Adicione engineId ao i18n.json (opcional)
Para apontar para um motor específico, adicione o campo engineId à sua configuração i18n.json. Encontre o ID do seu motor no dashboard — começa por eng_ (por exemplo, eng_SxjMwMsfOIsvV1wh).
{
"version": "1.15",
"locale": {
"source": "en",
"targets": ["es", "fr", "de"]
},
"buckets": {
"json": {
"include": ["[locale]/messages.json"]
}
},
"engineId": "eng_SxjMwMsfOIsvV1wh"
}Tudo o resto na sua configuração mantém-se igual — idioma de origem, destinos, buckets. Se omitir engineId, a CLI utiliza o motor predefinido da sua organização.
Defina a sua chave de API
A CLI autentica-se com a sua chave de API do Lingo.dev. Defina-a como variável de ambiente:
export LINGO_API_KEY="your-api-key"Ou guarde-a em ~/.lingodotdevrc:
[auth.vnext]
apiKey = your-api-keyGere uma chave de API na página API Keys do dashboard.
Execute traduções
lingo.dev runA CLI envia pedidos de tradução para o seu motor e escreve os resultados nos seus ficheiros de idioma, aplicando automaticamente a voz da marca, o glossário, as instruções e a configuração do modelo.
Referência de configuração#
i18n.json#
| Campo | Descrição |
|---|---|
engineId | Opcional. O ID do seu motor (eng_...). Se for omitido, é utilizado o motor predefinido da sua organização. |
Todos os outros campos i18n.json (version, locale, buckets) funcionam exatamente como na configuração padrão da CLI.
Variáveis de ambiente#
| Variável | Obrigatório | Predefinição | Descrição |
|---|---|---|---|
LINGO_API_KEY | Sim | - | A sua chave de API do Lingo.dev |
LINGO_API_URL | Não | https://api.lingo.dev | URL base personalizada da API (para self-hosted ou staging) |
O que pode esperar#
Cada tradução produzida pela CLI passa pelo pipeline completo do seu motor:
- Voz da marca define o tom e o grau de formalidade por idioma
- Itens do glossário garantem terminologia exata através de correspondência semântica
- Instruções aplicam regras linguísticas específicas do idioma
- Configurações de modelo selecionam o LLM certo com fallbacks automáticos
- Avaliadores de IA avaliam automaticamente a qualidade após cada pedido
As traduções aparecem em Reports com o tipo de gatilho api, juntamente com pedidos da API e integrações.
