# Resolver dificuldades

Identifique a etapa que precisa de revisão e reúna evidências úteis sem expor dados ou repetir ações de risco.

Fonte: https://guides.adapta.org/guias/maestro/ajuda-e-novidades/solucao-de-problemas/

**TL;DR** · Separe erro de conteúdo, dificuldade com arquivo e falta de acesso. Compare o resultado com o pedido e registre a etapa afetada. Não reenvie ações externas, amplie permissões ou reinstale recursos para tentar corrigir um problema cuja causa ainda não conhece.

## A tarefa terminou, mas a resposta não está correta

**Processo concluído** indica o fim de uma execução, não a aprovação do conteúdo. Na [Primeira entrega](https://guides.adapta.org/guias/maestro/comece-aqui/primeira-entrega/), o pacote exigiu uma revisão específica: causas e datas não fornecidas precisaram ser retiradas, e alternativas permaneceram condicionais.

Confira números, fontes, informações ausentes e compromissos. Diga qual trecho está incorreto, qual fonte prevalece e o que deve ser preservado. Depois, reabra o arquivo atualizado; a confirmação no chat não substitui essa leitura.

Exemplo de pedido de revisão, baseado no caso sintético do guia:

````
Revise o pacote da oficina extra.
Preserve as fontes e os cálculos conferidos:
40 horas disponíveis, 36 comprometidas e 4 livres.
A oficina de 10 horas gera déficit de 6 horas.
Não invente a causa da divergência do resumo comercial.
Não dê data ao adiamento nem trate parceiros como contratados.
Atualize o arquivo indicado e liste o que mudou.
Não envie, contrate ou agende nada.

````

Este texto é uma adaptação didática. Para reproduzir o exemplo documentado, use os pedidos integrais do guia. O gabarito continua 40 − 36 = 4 e 36 + 10 − 40 = 6; a viabilidade diária depende de dados adicionais.

## O arquivo não corresponde ao que você precisa

Confira o nome e o formato solicitado.

Consulte [Artefatos](https://guides.adapta.org/guias/maestro/recursos-do-maestro/artefatos/) e preserve a versão que conseguiu abrir. Não substitua um arquivo importante sem conferir o novo conteúdo.

## A tarefa depende de acesso externo

Verifique qual fonte e ação fazem parte do pedido. Veja [Conectores](https://guides.adapta.org/guias/maestro/recursos-do-maestro/conectores/) e [acessos do ambiente](https://guides.adapta.org/guias/maestro/recursos-do-maestro/integracoes/permissoes/).

Não compartilhe chaves, tokens ou configurações com segredos. Uma falha não autoriza reautenticar outra conta, instalar recursos ou conceder acesso mais amplo. Peça ao responsável a conferência do escopo.

## Registre o que aconteceu

Anote a tarefa, data e horário, etapa, resultado esperado, resultado observado e mensagem exata de erro quando houver. Informe modelo e versão somente se estiverem visíveis. Use uma amostra fictícia para explicar o problema, sem histórico completo, credenciais ou dados de clientes.

Se não houver confirmação do resultado de uma ação externa, não repita o envio. Confira o destino pelo procedimento autorizado da sua equipe. Este guia não diagnostica indisponibilidade do serviço, não promete prazo de resposta e não define um canal de atendimento.

**Dica prática:** transforme “não ficou bom” em critérios que possam ser conferidos. IA para Gestão, Max Peters, aula 23, ensina checklists de validação de conteúdo, formato e aprovação. Aqui, confira fonte, cálculo, arquivo e ausência de compromissos não autorizados.

Confira outras aplicações nos [casos de uso do Maestro](https://guides.adapta.org/guias/casos-de-uso/por-plataforma/maestro/).