Ao encontrar um erro, não substitua o arquivo inteiro pela primeira sugestão de uma IA. Use o DeepSeek como tutor: descreva o comportamento esperado, mostre um trecho mínimo, peça uma hipótese e confira a resposta no editor e na documentação da linguagem.

O chat do DeepSeek e a API para desenvolvedores são fluxos diferentes. Recursos e modelos do chat podem variar por conta; na API, os identificadores disponíveis mudam. Este roteiro não pressupõe que uma função ou versão específica esteja liberada para todos.

Prepare um exemplo mínimo

Antes de abrir a conversa, anote quatro itens: o que você queria que acontecesse, o que aconteceu, a mensagem de erro completa e a versão da linguagem ou engine. Compartilhe somente o trecho necessário para reproduzir o problema. Remova senhas, tokens, dados de clientes, arquivos privados e caminhos pessoais.

Para um projeto Godot, por exemplo, informe a versão principal e diga se o código é GDScript. O artigo sobre aprender GDScript com IA traz outro roteiro de estudo para iniciantes.

Peça explicação antes de pedir uma correção

Comece com uma pergunta que permita conferir o raciocínio:

Explique este trecho em português, sem reescrevê-lo. O que cada parte faz? Separe fatos de hipóteses, diga qual informação ainda falta e indique um teste pequeno que possa confirmar a causa. Estou usando [linguagem e versão]. O resultado esperado é [resultado]. O resultado atual é [resultado/erro]. Use somente este trecho: [código mínimo].

Depois compare a explicação com a documentação oficial da versão instalada. Se houver nomes de funções, classes ou opções, pesquise cada um antes de usar. Uma resposta bem escrita ainda pode misturar versões ou inventar uma API.

Investigue uma hipótese de cada vez

1. Reproduza o erro numa cópia ou branch de teste.

2. Peça ao DeepSeek uma causa provável e a evidência necessária para distingui-la de outras causas.

3. Faça uma única alteração pequena.

4. Rode a cena, o comando ou o teste relevante e compare o resultado esperado com o obtido.

5. Revise o diff e mantenha a mudança apenas se você entender o que ela faz.

Se a primeira hipótese falhar, reverta e registre o resultado antes de tentar outra. Isso facilita identificar a causa real e transforma a conversa em aprendizado, não em uma sequência de alterações às cegas.

Se for usar a API, confira os nomes atuais

A API não é o mesmo que escolher um modelo no chat. Na revisão de 27/10/2026, o catálogo oficial listava os identificadores deepseek-flash e deepseek-v4-pro; a documentação informa que os nomes antigos deepseek-chat e deepseek-reasoner foram descontinuados em julho de 2026. Como o catálogo pode mudar, consulte o endpoint de modelos e o histórico oficial de versões no dia em que configurar uma integração.

Uma chave da API nunca deve ser colocada em JavaScript entregue ao navegador, num repositório público ou num arquivo enviado a outra pessoa. Mantenha o segredo no servidor, seguindo uma solução como secrets de Cloudflare Workers, e revise autenticação e limites de consumo antes de disponibilizar a integração.

Privacidade: escolha o que pode sair do seu computador

A política do serviço web do DeepSeek, atualizada em 10/02/2026, descreve a coleta de entradas, arquivos e histórico de conversas e informa que dados pessoais são processados e armazenados na China. Essa política e as regras da API podem ter escopos diferentes; leia os termos da modalidade que você usa. Não envie código proprietário, dados de clientes, credenciais nem informações pessoais sem autorização e avaliação de privacidade.

Se a sugestão alterar login, pagamento, permissões, banco de dados, rede ou arquivos reais, pare para revisar o impacto com uma pessoa responsável. Compilar sem erro não prova que a mudança é segura nem que resolve o problema.

Quando a pergunta exigir investigar o comportamento de um programa inteiro, e não apenas explicar um trecho, veja também o guia de análise de software com REA para desenvolvedores. É um fluxo diferente: reunir evidências sobre o programa em vez de depender só da explicação de uma IA.