← Todos os artigos

Image Tools: converta PNG, JPG, WebP, HEIC e AVIF a partir dos seus agentes no Singularity

Image Tools é o plugin do Singularity que permite a um agente converter uma imagem sem sair da sua execução. Uma foto HEIC para publicar, um PNG para passar a WebP em um site: o agente chama a ferramenta MCP image_convert e recebe o arquivo produzido, suas dimensões e seu tamanho.

Capturas da bancada de qualificação local: contribuição MCP e conversor reais, com uma imagem de demonstração.

Quais formatos de imagem são aceitos?

SentidoFormatos
EntradaPNG, JPG/JPEG, WebP, HEIC/HEIF, AVIF
SaídaPNG, JPG, WebP, AVIF

Portanto, HEIC é lido, mas não produzido.

Conversão real: entrada MCP, resposta e pré-visualização WebP nos componentes do Singularity
Conversão real: entrada MCP, resposta e pré-visualização WebP nos componentes do Singularity

Como funciona image_convert?

{
  "source": "demo.png",
  "target": "webp",
  "quality": 85
}

Sem saída indicada, a ferramenta substitui a última extensão do arquivo de origem. As pastas de destino são criadas se necessário. A resposta indica o caminho produzido, o formato, o peso, as dimensões e a duração.

Como usar no dia a dia?

Instale e ative o Image Tools pelo Marketplace e faça o pedido no ticket: “converta as capturas desta pasta para WebP”, “passe esta foto HEIC para JPG”. Você obtém arquivos comuns, para revisar como o restante do trabalho do agente.

Colisão de saída: image_convert se recusa a sobrescrever um arquivo existente
Colisão de saída: image_convert se recusa a sobrescrever um arquivo existente

Quais são os limites?

O plugin converte formatos: não retoca nem gera imagens. O acesso é limitado ao workspace; caminhos fora do escopo e links simbólicos são recusados. A entrada é limitada a 25 MiB, a saída a 50 MiB e a imagem a 40 milhões de pixels. Essas recusas aparecem como estão no resultado da ferramenta.

Perguntas frequentes

O Image Tools é gratuito?

Sim. O plugin é gratuito e não precisa de conta externa nem de segredo.

É possível converter uma imagem para HEIC?

Não. HEIC e HEIF são aceitos apenas como entrada. As saídas possíveis são PNG, JPG, WebP e AVIF.

Um arquivo existente pode ser sobrescrito?

Somente com overwrite como true. Caso contrário, a ferramenta retorna um erro e preserva o arquivo.

Marketplace · Plugins · Baixar o Singularity