Quando você pede a um agente de IA para redigir uma página escaneada e a redação de texto não encontra nada para substituir, a página não está limpa, não possui camada de texto para pesquisar. Para redigir um escaneamento localmente, o agente cobre uma região por coordenadas com redact_image_area em vez de corresponder palavras. Com GroupDocs.Redaction.Mcp conectado ao Claude Desktop ou Cursor, a solicitação se parece com isto:

Cubra o terço inferior de scan.png com uma caixa preta.

A versão passo a passo com configuração e solução de problemas está na documentação: Como redigir documentos e imagens escaneados com um agente de IA.

Por que a redação de texto não encontra nada em um escaneamento?

Um escaneamento é uma foto de um documento. As palavras nele são pixels, portanto uma expressão regular não tem nada para corresponder. redact_text não encontra nada para substituir em uma página escaneada, e não encontrar nada não é o mesmo que não haver nada sensível. Trate um resultado vazio em um arquivo apenas de imagem como “sem camada de texto”, então troque de ferramenta. O mesmo vale para fotografias, carimbos e uma página de assinatura escaneada na parte de trás de um contrato que, de outra forma, é digital.

Qual ferramenta cobre uma região de uma página?

redact_image_area cobre um retângulo de uma página com uma caixa de cor sólida e oculta permanentemente o conteúdo da imagem abaixo, como rostos, assinaturas e carimbos. Ela recebe x, y, width e height em pixels, medidos a partir do canto superior esquerdo da página, e um color opcional (padrão Preto, ou um valor hexadecimal como #FF0000). A ferramenta não recebe argumento de página, apenas o arquivo e o retângulo, então abra a saída e confirme onde a caixa foi colocada. Como os números são pixels, você precisa do tamanho da imagem ou da página antes de escolher um retângulo.

Como obter as coordenadas?

Comece pelo tamanho da página. get_document_info devolve o tipo de arquivo, a contagem de páginas e a largura e altura de cada página, o que transforma “o terço inferior” em números reais.

Qual é o tamanho de scan.png?

Então dê a região ao agente:

Cubra o terço inferior de scan.png com uma caixa preta.

Para um elemento específico, como uma assinatura ou um rosto, você precisa da sua posição. Dois caminhos práticos funcionam. Abra a página em qualquer visualizador e leia as coordenadas você mesmo. Ou deixe o agente renderizar a página com um servidor que devolve imagens de página: a ferramenta render_page do GroupDocs.Viewer.Mcp renderiza uma única página como PNG e a devolve inline, e o servidor GroupDocs.Annotation.Mcp pode devolver pré‑visualizações de página (sua ferramenta de pré‑visualização atualmente falha para arquivos PDF no Linux e em Docker; documentos Word e outros do Office são renderizados, e no Windows com dnx todo formato é renderizado). Um modelo capaz de visão pode então estimar a caixa, e você a confirma antes que a redação seja executada.

E quanto a documentos que são metade texto, metade escaneamento?

Um contrato nascido digitalmente com uma página de assinatura escaneada precisa de ambas as ferramentas, e redact_image_area não pode ser direcionado a uma única página por argumento. Mantenha as partes separadas: redija o texto primeiro, e trate as páginas escaneadas como imagens que recebem sua própria redação por área.

Redija os endereços de e‑mail em contract.docx, então me diga qual arquivo salvo devo usar na próxima etapa.

Em seguida, verifique cada página da saída final a olho.

Como é um fluxo de trabalho típico de escaneamento?

A ordem que funciona é: ler o tamanho da página, decidir a região, cobri‑la, então observar o resultado. Se a região não for óbvia, renderize a página primeiro e deixe um modelo capaz de visão propor uma caixa. Mantenha a proposta e as coordenadas finais na transcrição para que qualquer pessoa revisando o caso possa ver o que foi coberto e por quê. Redigir por região é intencionalmente bruto: cobre um retângulo e nada mais.

Este servidor lê texto em imagens (OCR)?

Não. GroupDocs.Redaction.Mcp redige; ele não reconhece texto em imagens. Isso mantém o comportamento previsível, porque nenhum limiar de confiança decide silenciosamente que um nome borrado não era um nome. Se seu fluxo de trabalho precisar do texto de escaneamentos, extraia‑o primeiro com uma ferramenta feita para isso, decida o que é sensível e então redija por área. O servidor não pode dizer onde um nome está em uma foto.

Sessão de exemplo (abreviada)

You:    How big is scan.png?
Agent:  -> get_document_info(file: scan.png)
        The image is 1200 x 1600 pixels.
You:    Cover the bottom third of scan.png with a black box.
Agent:  -> redact_image_area(file: scan.png, x: 0, y: 1067, width: 1200, height: 533, color: Black)
        Saved the output file. Please open it and check that the box covers the area.

Como verificar uma redação por área?

Observe cada página da saída, não apenas a que você mirou. Uma redação por área que fica 20 pixels curta é uma redação que falhou, e nenhum texto de resposta lhe dirá isso. Este é o único caso em que a verificação não pode ser automatizada reexecutando um padrão: a checagem é feita pelos seus olhos, ou por uma pré‑visualização renderizada que o agente pode ver. A verificação é abordada em seu próprio post, Não confie em redação que você não verificou.

Quais são os limites do modo de avaliação?

Sem licença, o servidor permite um documento por processo e uma redação, limitada a 4 substituições, além de selos de teste. Para escaneamentos isso significa uma caixa: uma página que precisa de três regiões cobertas recebe apenas uma, e ainda parece processada. Execute get_license_status primeiro. O limite serve para experimentar as ferramentas, não para trabalho real.

  • PDF no Linux. No Linux, incluindo a imagem Docker, redact_image_area e erase_metadata atualmente falham em arquivos PDF (o manuseio de imagens do motor PDF depende de System.Drawing, que .NET suporta apenas no Windows); ambas funcionam em documentos Word, e redact_text funciona em PDF. Execute a redação de área em PDF e a remoção de metadados no Windows com dnx.

Perguntas Frequentes

Um agente de IA pode redigir um documento escaneado? Sim, por área. Ele cobre um retângulo que você define com redact_image_area, porque não há texto para correspondência de padrão.

Claude pode remover uma assinatura de uma imagem escaneada? Claude pode conduzir a redação assim que a posição da assinatura for conhecida, a partir de um visualizador ou de uma pré‑visualização de página renderizada. O servidor então cobre esse retângulo com uma caixa sólida.

Como eu escureço automaticamente uma região em um escaneamento ou imagem? Forneça ao agente o arquivo e o retângulo, e ele chama redact_image_area. A ferramenta não tem argumento de página, então verifique cada página do resultado a olho.

Por que a redação de texto não altera nada no meu escaneamento? O escaneamento ou imagem contém pixels, não texto, portanto não há nada para substituir. Use redação por área e verifique o resultado a olho.

Aprofunde‑se