---
title: Tradução com IA
sidebarTitle: Tradução com IA
description: Ative os idiomas desejados e faça com que o Jamdesk traduza sua documentação após cada build, enviando as páginas traduzidas ao seu próprio repositório GitHub.
---
> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.
O Jamdesk pode traduzir sua documentação para você. Escolha os idiomas desejados nas configurações do projeto e, após cada build, o Jamdesk traduz suas páginas em inglês e envia os resultados ao seu próprio repositório GitHub, em diretórios com prefixo de idioma. As traduções são suas: ficam no seu repositório e no seu histórico do Git, e você pode editá-las como qualquer outro arquivo.
As capturas de tela mostram a interface em inglês.
Esta página é para quem quer que sua documentação seja lida em mais de um idioma sem contratar um serviço de tradução ou executar um script próprio. Para saber como funcionam a navegação por localidade e o seletor de idioma, consulte [Suporte a vários idiomas](/pt/setup/languages) — essa configuração se aplica independentemente de as traduções virem do Jamdesk, dos seus próprios tradutores ou de outra ferramenta.
## Pré-requisitos
- Um [repositório GitHub conectado](/pt/setup/connecting-github) ao projeto. As páginas traduzidas são enviadas de volta ao seu repositório, portanto um projeto implantado pela CLI ou a partir de um tarball não pode usar esse recurso.
- Acesso de gravação para o GitHub App do Jamdesk, para que ele possa criar esse commit. Se o acesso estiver faltando, o painel Translations informa isso e inclui um link para que um administrador do GitHub conceda a permissão. Essa é uma etapa única por conta do GitHub.
A tradução automática está incluída em todos os planos, inclusive nos períodos de avaliação. Não há cobrança por palavra nem créditos para comprar.
## Ativar
Acesse seu projeto no [dashboard do Jamdesk](https://dashboard.jamdesk.com), abra **Settings** e role até **Translations**.
Ative **Translate my documentation** e marque os idiomas desejados. Cada um é listado pelo nome nativo, com o nome em inglês ao lado.
A tradução é executada depois que um build termina. Na primeira execução, todas as páginas são traduzidas e os arquivos traduzidos são enviados ao seu repositório, onde você pode revisá-los como qualquer outro commit.
## Limites
Aplicam-se dois limites, ambos por projeto:
| Limite | Valor |
|-------|-------|
| Idiomas por projeto | Até 5 |
| Páginas traduzidas por mês | 10.000 |
Como somente as páginas alteradas são traduzidas novamente após a primeira execução, um site estável usa apenas uma pequena fração da cota mensal.
## Somente o que mudou
Na primeira execução, tudo é traduzido. Depois disso, o Jamdesk traduz novamente apenas as páginas cuja fonte em inglês realmente mudou; assim, corrigir um erro de digitação em uma página custa uma página, e não o site inteiro.
## Traduções que o Jamdesk não altera
Dois tipos de tradução são considerados escritos por você, e o Jamdesk nunca substitui nenhum deles por conta própria:
- **Traduções que você já tinha.** Se o seu repositório já contiver páginas traduzidas quando você ativar o recurso, o Jamdesk as adotará em vez de sobrescrevê-las. O trabalho que você fez ou contratou de um serviço de tradução é mantido exatamente como está.
- **Traduções que você edita.** Altere uma página traduzida manualmente e o Jamdesk perceberá, para que seu texto seja preservado em todas as execuções posteriores.
Ambas são registradas da mesma forma, e isso cria um bloqueio permanente: essas páginas nunca mais são traduzidas automaticamente, nem mesmo depois que a fonte em inglês mudar. Quando o inglês muda, elas aparecem no painel Translations em **Edited by hand**.
Cada página listada ali tem um botão **Replace with AI translation**. Ele devolve a página à IA — sua versão é descartada e a página é traduzida novamente no próximo build, portanto nada muda no momento em que você clica. Esse botão é a única forma de remover o bloqueio.
É por isso que "Somente o que mudou" não se aplica a essas páginas. Uma página traduzida pelo Jamdesk é atualizada quando sua fonte em inglês muda; uma página escrita ou editada por você espera que você solicite a atualização.
## Desativar um idioma
Desmarcar um idioma impede que o Jamdesk faça traduções para ele. Nada é excluído: as páginas já enviadas permanecem no seu repositório, exatamente como estavam.
## E agora?
Navegação por localidade, seletor de idioma e estilos RTL
Instale o GitHub App e conceda o acesso necessário para a tradução