--- title: Corrigir com IA sidebarTitle: Corrigir com IA description: Revise e aplique correções sugeridas por IA para links quebrados e descrições de páginas ausentes no dashboard de build do Jamdesk, com commits no 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. Quando um build termina com links quebrados ou páginas sem descrição, o Jamdesk pode corrigir muitos deles para você. O botão **Fix with AI** lê os avisos do build, propõe uma edição concreta para cada um e faz commit das correções aprovadas no seu repositório GitHub conectado, iniciando um novo build. Esta página é destinada a qualquer pessoa que mantenha um site Jamdesk e queira eliminar avisos de build sem editar MDX manualmente. As capturas de tela mostram a interface em inglês. Para uma versão local da mesma ideia executada no terminal, consulte o [comando `jamdesk fix` da CLI](/pt/cli/fix-broken-links). O fluxo do dashboard faz o commit por você; a CLI grava na sua cópia de trabalho e deixa o commit por sua conta. ## O que ele corrige O Fix with AI funciona com três tipos de aviso de build: - **Links internos quebrados.** Um fragmento de link que aponta para um título que não existe mais na página de destino, como um erro de digitação (`#instalation` → `#installation`), ou uma página traduzida cujo título foi renomeado. - **Descrições de página ausentes.** Uma página sem `description` no frontmatter. O Jamdesk escreve um breve resumo com base no conteúdo da página para você revisar. - **Títulos de página ausentes.** Uma página sem título recebe um título sugerido, extraído do conteúdo da página, para você revisar. Ele só propõe uma alteração quando consegue resolver o destino com segurança. Tudo que for ambíguo permanece inalterado e é listado separadamente para que você possa corrigir manualmente. A quantidade de itens corrigíveis não é igual à quantidade de avisos. Um build pode mostrar cinco avisos enquanto o Fix with AI oferece reparar três deles, porque os outros dois não têm uma correção inequívoca. O banner sempre reflete o que pode ser corrigido de fato. ## Pré-requisitos - Um [repositório GitHub conectado](/pt/integrations/github) ao projeto. - Acesso de gravação para o aplicativo GitHub do Jamdesk, para que ele possa fazer commit das correções. Se o acesso estiver ausente, o modal exibirá um link **Grant access** que levará você ao GitHub para adicioná-lo. - Um build concluído que contenha avisos de links quebrados ou descrições ausentes. ## Encontre o banner Abra seu projeto e role até **Build History** na página Project Home. Quando o build mais recente tiver problemas corrigíveis, um banner aparecerá acima da lista de builds com uma contagem e um botão **Fix with AI**. Um painel de histórico de builds com um banner destacado informando que 3 problemas neste build podem ser corrigidos com IA, ao lado de um botão Fix with AI. A linha do build mais recente mostra um status de sucesso com um selo de aviso de 5. O banner aparece somente no build concluído mais recente. Os builds anteriores do histórico não o exibem, porque as correções sempre se aplicam ao estado atual da sua documentação. ## Revise e aplique as correções Clique em **Fix with AI**. O modal será aberto e o agente de IA analisará sua documentação para criar um plano de correção. Isso leva alguns segundos. As correções são agrupadas por tipo. **Broken links** mostra cada âncora reescrita, **Missing descriptions** mostra o resumo sugerido para cada página e **Missing titles** mostra o título proposto. Desmarque a caixa de seleção de qualquer item que preferir ignorar desta vez ou use o botão de ignorar para [silenciar uma recomendação permanentemente](#ignorar-recomendações). Os problemas sem uma correção clara aparecem em **Can't be fixed automatically** e ficam para você resolver manualmente. O modal Fix with AI. Uma seção Broken links lista três correções marcadas, cada uma mostrando a âncora antiga riscada e a âncora corrigida. Uma seção Can't be fixed automatically lista dois problemas para correção manual, acima dos botões Cancel e Apply 3 fixes. Clique em **Apply fixes**. O Jamdesk fará commit das alterações selecionadas no seu branch conectado com a mensagem `docs: apply AI-suggested fixes (via Jamdesk)` e iniciará um novo build. Acompanhe o novo build em [Build History](/pt/builds/monitoring). Quando ele entrar no ar, os avisos corrigidos terão desaparecido. Tudo o que restar será um aviso que o Fix with AI não conseguiu resolver ou um novo problema decorrente do conteúdo mais recente. A aplicação grava um commit real no seu repositório, portanto a alteração fica registrada no histórico do Git e você pode revisá-la ou revertê-la no GitHub como qualquer outro commit. ## Quando alguns problemas não podem ser corrigidos Se um aviso não tiver uma correção clara, o modal o listará sob um título separado e não fará alterações. Motivos comuns: - Um link quebrado cujo destino ou título não existe em lugar algum, portanto não há para onde apontá-lo. - Uma entrada de navegação sem um arquivo de origem correspondente. - Uma página para a qual o agente não conseguiu gerar uma descrição automaticamente. Esses casos exigem uma edição manual. Abra a página no [editor](/pt/development/local-preview) ou no seu editor de código, corrija o link ou adicione a descrição e faça push para iniciar um novo build. ## Ignorar recomendações Alguns avisos não justificam uma ação: um link que você quebrou de propósito ou uma página provisória que não precisa de descrição. Desmarcar uma correção apenas a ignora uma vez. Ignorar remove o item da contagem até que você faça o contrário. Todas as linhas do modal, corrigíveis ou não, têm um botão de ignorar. Clique nele para mover o item para uma seção **Ignored** recolhida na parte inferior. Depois que você fechar o modal, a contagem do banner na página Project Home diminuirá para corresponder, e os avisos correspondentes desaparecerão do Build History, no build atual e em todos os builds posteriores. **Ignore all** faz o mesmo com tudo o que ainda estiver listado. Como os itens ignorados funcionam: - **Compartilhados e persistentes.** Os itens ignorados se aplicam ao projeto inteiro, portanto todos os membros veem a mesma lista, que permanece entre os builds. O Jamdesk identifica cada aviso pelo conteúdo, e não pelo número da linha, portanto editar outras partes da página não fará um item ignorado reaparecer. - **Restauração.** Expanda a seção **Ignored** e clique em **Restore** em qualquer item. Se você ignorar tudo em um build, o banner desaparecerá e um pequeno link `"N ignored recommendations"` abaixo de Build History reabrirá o modal. - **Avisos alterados reaparecem.** Se o problema subjacente mudar, por exemplo, se o link quebrado passar a apontar para outro lugar, ele deixará de corresponder à entrada ignorada e aparecerá novamente como uma nova recomendação. ## Fix with AI vs. a CLI As duas ferramentas corrigem âncoras de links quebrados. Elas diferem em onde são executadas e em como a alteração é aplicada. | | Fix with AI (dashboard) | [`jamdesk fix`](/pt/cli/fix-broken-links) (CLI) | |---|---|---| | Executa | No dashboard, em um build | No seu terminal, em arquivos locais | | Corrige | Links quebrados e descrições ausentes | Âncoras de links quebrados | | Commit | Faz commit no seu branch por você | Grava arquivos locais; você faz o commit | | Acionamento | Um clique no banner do build | `jamdesk fix` | Use o fluxo do dashboard para uma correção rápida sem sair do Jamdesk. Use a CLI quando quiser primeiro aplicar as alterações na sua cópia de trabalho, por exemplo, para agrupá-las com outras edições. ## O que vem a seguir? Acompanhe o status dos builds e leia avisos e sugestões Corrija links quebrados automaticamente no terminal