Conecte seu engine

A CLI da Lingo.dev conecta sua base de código a um engine de localização pela configuração do seu projeto. Cada lingo push passa pelo seu engine — aplicando automaticamente sua voz da marca, glossário, regras e configuração do modelo. Sem alterações no código, sem novas dependências.

O que muda#

	Antes	Depois
Pipeline de tradução	Pipeline 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 em cada solicitação
Regras	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#

Conecte ao seu engine

Execute lingo link na raiz do projeto:

bash

lingo link

Escolha (ou crie) uma organização e um engine de localização. link grava orgId e engineId em .lingo/config.json — faça commit para que todas as execuções usem o mesmo engine. Você também pode encontrar o ID de um engine no dashboard; ele começa com eng_ (por exemplo, eng_SxjMwMsfOIsvV1wh).

Autenticação

bash

lingo login

Abre o navegador para autenticar e salva uma sessão. Para CI ou uso não interativo, passe uma chave de API:

bash

lingo login --api-key lk_...

…ou defina-a como variável de ambiente:

bash

export LINGO_API_KEY="lk_..."

Gere uma chave de API na página API Keys do dashboard.

Push

bash

lingo push

A CLI envia os arquivos de origem para o seu engine e grava os resultados traduzidos de volta no disco — aplicando automaticamente sua voz da marca, glossário, regras e configuração do modelo.

Referência de configuração#

`.lingo/config.json`#

Campo	Descrição
`orgId`	Organização proprietária do engine. Definida por `lingo link`.
`engineId`	Engine que faz a tradução (`eng_...`). Definido por `lingo link`.

sourceLocale, targetLocales e files funcionam da mesma forma que em qualquer projeto — consulte Configuration.

Variáveis de ambiente#

Variável	Obrigatória	Padrão	Descrição
`LINGO_API_KEY`	Para CI	-	Sua chave de API do Lingo.dev (em vez de `lingo login`)
`LINGO_API_URL`	Não	`https://api.lingo.dev`	URL base personalizada da API (para self-hosted ou staging)

O que esperar#

Toda tradução gerada pela CLI passa pelo pipeline 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
Regras aplicam regras linguísticas específicas de cada localidade
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 das solicitações da API e das integrações.