Blog

Ao perguntar à IA sobre um erro: envie uma captura de tela ou copie o texto?

Copie diretamente o texto legível de um erro, extraia palavras de um diálogo sem seleção e mantenha capturas quando o contexto visual for relevante.

Ao perguntar a um assistente de IA sobre um erro no Mac, copie a mensagem como texto se puder. Use OCR quando as palavras estiverem em uma imagem ou em um diálogo sem seleção. Inclua uma captura de tela quando o problema depender da aparência da interface, em vez de enviar todo erro como imagem por padrão.

Escolha a entrada que preserva as evidências

Uma compilação que falhou e um botão fora do lugar exigem explicações diferentes:

  • Texto: Mensagens de erro, rastreamentos de pilha, comandos e valores de configuração em que os caracteres exatos importam. Mantenha as quebras de linha úteis e o trecho de saída ao redor.
  • Captura de tela: Um painel cortado, cor inesperada, controles sobrepostos ou um problema cuja posição seja importante. Mostre o suficiente da interface para explicar a relação entre os elementos.
  • Ambos: Um diálogo com um código de erro importante dentro de uma interface visivelmente quebrada. Forneça a imagem para dar contexto e o texto conferido para mostrar a mensagem.

Se o terminal ou editor já permite copiar a saída, use isso em vez de reconhecer uma captura de tela. O OCR acrescenta uma etapa de transcrição que pode alterar pontuação, recuo ou caracteres parecidos, como 0 e O.

Extraia um erro sem seleção com o Frset

Imagine que um app exibe uma mensagem de erro que não pode ser selecionada. Com as ferramentas de captura do Frset:

  1. Inicie Screenshot pela barra de menus ou pelo atalho configurado.
  2. Selecione a mensagem e qualquer rótulo próximo necessário para entendê-la.
  3. Escolha Extract Text na barra de ferramentas da captura.
  4. Compare o resultado do OCR com o original, principalmente códigos de erro, caminhos e pontuação.
  5. Corrija os erros e copie o texto relevante.
  6. Cole-o na conversa com a IA junto da ação que provocou o erro.

O Frset requer macOS 13 ou posterior. A captura de tela exige a permissão pertinente de Gravação de Tela do macOS. O OCR usa o reconhecimento de texto local da Apple e não precisa de uma chave API de IA. Se a imagem já estiver no histórico da área de transferência do Frset, você também pode usar Extract Text nela, sem capturá-la novamente.

Para uma imagem salva, o Texto ao Vivo na Pré-Visualização da Apple é outra opção em sistemas e idiomas compatíveis. Veja o guia de texto em imagens para conhecer as etapas básicas.

Acrescente o contexto que a mensagem não consegue fornecer

Um erro raramente explica o problema inteiro. Por exemplo, diga que uma compilação falhou depois de alterar uma dependência e inclua o comando, a saída e a configuração relevante. Evite colar um log inteiro sem relação apenas porque ele está disponível.

Antes de enviar, inclua:

  • O que você tentava fazer e o que aconteceu em vez disso.
  • A versão do app, ambiente de execução ou dependência relevante para o erro.
  • A mensagem exata e a saída ao redor necessária para entender a causa.
  • O que mudou recentemente e o que você já tentou.

Ao reunir esses elementos em vários apps, o histórico da área de transferência do Frset pode ajudar a encontrar uma cópia anterior por conteúdo, título ou alias. Cole cada parte com um rótulo para que o assistente consiga distinguir o comando, a saída e a configuração. Os textos selecionados em conjunto são unidos com quebras de linha; revise a mensagem montada antes de enviá-la.

Trate a economia de tokens como uma questão, não como uma proporção fixa

Substituir uma captura de tela com muito texto por um trecho curto e preciso pode reduzir a entrada necessária para uma pergunta. Isso não garante uma economia específica nem uma resposta equivalente. O processamento de imagens e a cobrança dependem do serviço, do modelo e do tamanho da imagem; a Anthropic documenta esses fatores em seu guia de visão.

Não remova evidências visuais apenas para encurtar a entrada. Se a pergunta é por que um botão está oculto, o OCR do rótulo não mostra o painel que se sobrepõe a ele. Mantenha a captura e acrescente texto quando os caracteres exatos forem importantes.

Confira o que você está prestes a compartilhar

Remova credenciais, URLs privadas e dados pessoais ou de clientes sem relação com a pergunta da mensagem que vai enviar. Confira também a imagem, além do texto extraído. O OCR local não faz com que um envio posterior seja local: enviar qualquer um dos dois a um assistente online compartilha esse conteúdo com o serviço escolhido.

Mantenha a captura de tela ou o log original até conferir a explicação. Se o assistente sugerir um comando, verifique a finalidade e o destino antes de executá-lo. Para trechos que espera usar novamente, continue com como salvar código e comandos copiados.