--- title: "Prompt para escrever um tutorial ou how-to" description: "Produza instruções com requisitos, etapas verificáveis e solução de problemas, preservando versão e evidência do procedimento." canonical: "https://tropk.ai/recursos/prompts/tutorial-how-to" last_modified: "2026-10-12T16:14:36.395Z" --- # Prompt para escrever um tutorial ou how-to Revisado em 2026-10-06. ## Prompt para adaptar e usar Permitir que uma pessoa conclua uma tarefa e reconheça o resultado de cada etapa. ### Prepare antes de começar EMPRESA E NEGÓCIO empresa: {empresa} dominio: {dominio} oferta_confirmada: {produtos_servicos_capacidades_limites_e_fontes} contexto_negocio: {mercado_regiao_diferenciais_comprovados_e_restricoes} PÚBLICO E OBJETIVO publico: {perfil_tarefa_conhecimento_inicial_e_restricoes} pergunta_principal: {pergunta_do_leitor} resultado_do_leitor: {o_que_a_pessoa_deve_conseguir_decidir_ou_fazer} objetivo_editorial: {objetivo} intencao_e_etapa: {intencao_de_busca_e_etapa_da_decisao} VOZ E CONTEXTO EDITORIAL voz: {tom_vocabulario_exemplos_de_estilo_e_termos_a_evitar} tema_e_entidades: {tema_keyword_principal_termos_e_entidades} inventario: {paginas_existentes_e_decisao_criar_atualizar_ou_consolidar} contribuicao: {exemplo_matriz_metodo_ou_dado_proprio_autorizado} cta: {proxima_acao_pertinente_e_destino_confirmado_ou_nao_aplicavel} EVIDÊNCIAS E ACESSO fontes: {id_titulo_url_autor_data_de_publicacao_consulta_e_trechos_relevantes} dados_autorizados: {dados_definicoes_periodo_metodo_e_permissoes_ou_nao_disponivel} links_internos: {url_publicada_assunto_e_funcao_do_link} acesso_pesquisa: {ferramentas_realmente_habilitadas_e_acessos_autorizados_ou_sem_navegacao} restricoes: {confidencialidade_direitos_prazos_mercado_e_escopo} tarefa: {tarefa_especifica} estado_inicial: {estado_inicial_e_pre_requisitos} resultado_final: {sinal_verificavel_de_conclusao} ambiente: {sistema_versao_idioma_conta_e_permissoes} passos_e_provas: {acoes_locais_entradas_resultados_e_documentacao_ou_teste} falhas_e_recuperacao: {sintomas_verificacoes_e_correcoes_seguras} ### Formato da entrega A. Tutorial em Markdown: objetivo, requisitos, etapas, exemplo, validação e solução de problemas. B. Tabela de passos com fonte ou prova de teste. C. Pendências de ambiente e de validação técnica. ### Critérios de revisão • Início, fim, versão e pré-requisitos estão explícitos. • Cada passo informa ação, local, entrada, resultado e conferência. • Testado e documentado são descritos conforme a evidência real. • Troubleshooting corresponde a sintomas pertinentes. • Exemplos não revelam credenciais nem escondem efeitos materiais. ### Modelo Atue como apoio de pesquisa e redação da empresa informada. Escreva em PT-BR, com clareza e voz da marca, para a tarefa do público. Produza um rascunho para revisão humana. Use o contexto completo abaixo, não apenas o tema. MÓDULO 1 — CONTEXTO A PREENCHER EMPRESA E NEGÓCIO empresa: {empresa} dominio: {dominio} oferta_confirmada: {produtos_servicos_capacidades_limites_e_fontes} contexto_negocio: {mercado_regiao_diferenciais_comprovados_e_restricoes} PÚBLICO E OBJETIVO publico: {perfil_tarefa_conhecimento_inicial_e_restricoes} pergunta_principal: {pergunta_do_leitor} resultado_do_leitor: {o_que_a_pessoa_deve_conseguir_decidir_ou_fazer} objetivo_editorial: {objetivo} intencao_e_etapa: {intencao_de_busca_e_etapa_da_decisao} VOZ E CONTEXTO EDITORIAL voz: {tom_vocabulario_exemplos_de_estilo_e_termos_a_evitar} tema_e_entidades: {tema_keyword_principal_termos_e_entidades} inventario: {paginas_existentes_e_decisao_criar_atualizar_ou_consolidar} contribuicao: {exemplo_matriz_metodo_ou_dado_proprio_autorizado} cta: {proxima_acao_pertinente_e_destino_confirmado_ou_nao_aplicavel} EVIDÊNCIAS E ACESSO fontes: {id_titulo_url_autor_data_de_publicacao_consulta_e_trechos_relevantes} dados_autorizados: {dados_definicoes_periodo_metodo_e_permissoes_ou_nao_disponivel} links_internos: {url_publicada_assunto_e_funcao_do_link} acesso_pesquisa: {ferramentas_realmente_habilitadas_e_acessos_autorizados_ou_sem_navegacao} restricoes: {confidencialidade_direitos_prazos_mercado_e_escopo} MÓDULO 2 — INSUMOS DO FORMATO Formato: tutorial ou how-to Objetivo: Permitir que uma pessoa conclua uma tarefa e reconheça o resultado de cada etapa. tarefa: {tarefa_especifica} estado_inicial: {estado_inicial_e_pre_requisitos} resultado_final: {sinal_verificavel_de_conclusao} ambiente: {sistema_versao_idioma_conta_e_permissoes} passos_e_provas: {acoes_locais_entradas_resultados_e_documentacao_ou_teste} falhas_e_recuperacao: {sintomas_verificacoes_e_correcoes_seguras} MÓDULO 3 — EVIDÊNCIA E LIMITES Leia os textos fornecidos. Se houver pesquisa habilitada e autorizada, consulte fontes primárias pertinentes e registre as páginas realmente lidas. Sem navegação, use os anexos e devolva uma lista de verificações pendentes; não diga que abriu URLs. Uma página concorrente orienta pesquisa, não comprova todos os seus claims. Não invente recursos, preços, dados, clientes, experiências, testes, credenciais, depoimentos, citações ou links. Diferencie fato documentado, observação, interpretação e exemplo hipotético. Informação ausente não é zero nem prova de que um recurso não existe. Preserve data, versão, região, plano, unidade, denominador e condições materiais. Números derivados exigem cálculo conferido com ferramenta real ou resultado já validado fornecido nas entradas. Sem isso, marque a verificação pendente; não declare que recalculou. Não exponha dados privados. Use nomes, imagens e falas apenas com autorização. Não copie a redação nem a sequência inteira de uma referência. Preserve autoria humana e indique quais validações exigem o responsável pelo assunto. MÓDULO 4 — PRODUÇÃO DO FORMATO 1. Confirme tarefa, ambiente e requisitos materiais. 2. Reconstrua a sequência com a documentação fornecida e os testes realmente realizados. 3. Redija cada etapa com ação, local, entrada, resultado esperado e conferência. 4. Apresente decisões de caminho e solução de problemas por sintoma. 5. Inclua validação final, limites e gatilho de revisão por versão. Não invente nomes de botões, comandos, telas ou compatibilidade. MÓDULO 5 — SEO, AEO E GEO Use um H1 coerente com a pergunta e o corpo; organize H2/H3 por decisões do leitor. Comece as seções com respostas diretas quando isso ajudar. Cada trecho deve manter entidade, contexto e condição suficientes para ser entendido isoladamente. Use os termos naturalmente, sem densidade fixa ou repetição artificial. Cite a fonte específica perto do fato que ela sustenta; preserve a URL fornecida. Proponha links internos apenas para destinos confirmados e úteis. Não force FAQ, quantidade de palavras ou schema especial em todo formato. Não prometa ranking ou citação. Não acrescente autoria, revisão, data de publicação, teste ou atualização que não ocorreram. CTA deve corresponder à oferta e à ação informadas, sem pitch sem relação com a tarefa. MÓDULO 6 — SAÍDA E REVISÃO A. Tutorial em Markdown: objetivo, requisitos, etapas, exemplo, validação e solução de problemas. B. Tabela de passos com fonte ou prova de teste. C. Pendências de ambiente e de validação técnica. Entregue também: H1, título SEO, descrição e slug propostos; mapa de afirmações com fonte, seção e limite; links utilizados; pendências com impacto e próxima verificação. Separe esse material do corpo publicável. Não publique nem declare o rascunho aprovado. Revise pelos critérios abaixo e marque cada um como atendido, corrigir ou não aplicável com motivo: 1. Início, fim, versão e pré-requisitos estão explícitos. 2. Cada passo informa ação, local, entrada, resultado e conferência. 3. Testado e documentado são descritos conforme a evidência real. 4. Troubleshooting corresponde a sintomas pertinentes. 5. Exemplos não revelam credenciais nem escondem efeitos materiais. Se faltar prova indispensável à promessa central, devolva somente a parte segura e diga qual entrada impede concluir. Não preencha a lacuna com uma conclusão provável. ## Quando usar este prompt Use um tutorial quando a saída é executar uma tarefa específica. O leitor precisa reconhecer um ponto inicial, seguir ações em uma ordem e conferir um resultado final. Uma explicação de conceito pode apoiar os passos, mas não substitui o procedimento. Defina a tarefa com um verbo e uma evidência de conclusão: preencher uma tabela, revisar um arquivo ou configurar uma opção na versão indicada. O ambiente faz parte da instrução. Uma sequência correta para uma interface pode estar errada em outra versão, conta ou idioma. O [prompt](/recursos/glossario/prompt) recebe esses limites e distingue passos documentados de passos testados. Não escreva “testamos” quando houve apenas leitura da documentação. Também não peça capturas imaginadas: uma imagem ilustrativa precisa ser identificada e a explicação textual deve continuar suficiente. [SEO](/recursos/glossario/seo) organiza a página para quem pesquisa; [AEO](/recursos/glossario/aeo) trabalha a clareza das respostas; [GEO](/recursos/glossario/geo) trata da descoberta em respostas generativas. Neste recurso, os três aparecem como práticas de escrita, pesquisa e revisão: responder à tarefa, nomear entidades, preservar contexto e tornar a evidência conferível. Um prompt ajuda a preparar o rascunho. Ele não comprova fatos nem garante posições, recomendações ou citações por uma IA. ## Prepare os insumos antes de escrever Reúna versão, permissões, estado inicial, materiais necessários e resultado esperado. Inclua documentação oficial e registros de execução quando existirem. Para cada passo, anote ação, local, entrada, sinal de sucesso e forma de verificar. Se uma ação depende de um acesso ainda não concedido, o tutorial pode explicar o requisito sem simular que o leitor já o possui. Trate a solução de problemas como parte da tarefa. Selecione sintomas pertinentes e sua evidência, como um campo ausente na versão ou um resultado que não corresponde à entrada. Evite uma lista genérica de erros sem relação com o procedimento. Quando uma correção tiver efeito material, informe a condição e a alternativa segura. Dados sensíveis, tokens e arquivos de clientes devem sair dos exemplos. ## Como produzir e revisar o conteúdo Peça passos numerados com verificações intermediárias. Uma instrução como “configure o relatório” deixa o trabalho oculto. A etapa deve informar onde agir, qual informação inserir e o que observar depois. Nos caminhos alternativos, explique qual condição escolhe cada um. Tempo e esforço só entram quando houver base; uma estimativa inventada não torna a orientação mais prática. Depois da redação, repita o procedimento no ambiente descrito quando houver autorização. Se não for possível, revise contra as fontes e mantenha o status documentado. Confira também a recuperação: o leitor sabe como reconhecer falha e quando interromper? O tutorial termina com uma verificação do resultado prometido e um gatilho de atualização, como mudança de versão, botão, regra ou requisito. ## Exemplo de preenchimento Exemplo de preenchimento: ensinar a preencher uma tabela de observações de [respostas de IA](/recursos/glossario/resposta-de-ia). Estado inicial: tabela vazia e definições fornecidas. Passos: registrar pergunta, interface, data, resposta e classificação; separar observações inválidas; conferir o conjunto final. Resultado: registros completos com fonte. O exemplo não precisa de uma interface fictícia nem afirma que a tabela detecta automaticamente a causa de uma ausência. ## Como usar o prompt completo Copie o prompt completo e substitua os campos entre chaves antes de enviá-lo. Anexe o conteúdo das fontes, além das URLs: um modelo sem navegação não consegue conferir um link sozinho. Use “não disponível” quando faltar um dado e explique o motivo. Execute uma primeira versão, confira as pendências e corrija os insumos antes de pedir a revisão. Mantenha o texto público separado das notas de pesquisa. ## Confira o resultado - Início, fim, versão e pré-requisitos estão explícitos. - Cada passo informa ação, local, entrada, resultado e conferência. - Testado e documentado são descritos conforme a evidência real. - Troubleshooting corresponde a sintomas pertinentes. - Exemplos não revelam credenciais nem escondem efeitos materiais. ## Fontes e referências - [Criar conteúdo útil, confiável e voltado às pessoas]() — Google Search Central - [Recursos de IA e seu site]() — Google Search Central - [Orientações sobre conteúdo criado com IA generativa]() — Google Search Central ## Continue a leitura - [Prompt para escrever um artigo de perguntas e respostas]() - [Prompt para escrever um artigo informacional]() - [Prompt para escrever um guia ou pillar page]() - [Estratégia para descoberta por IA]() - [Recursos]() ## Sobre o autor [Luiz Gardelin]() Luiz Gardelin é fundador da Tropk.ai e atua em GEO/AEO, visão de produto, estratégia e crescimento, ajudando marcas a entender e melhorar sua presença nas respostas de IA. --- [Todas as páginas em Markdown]()