O que markitdown-auto-converter-agent-skill faz?
Habilidade de conversão automática inteligente para transformar documentos em Markdown. Roteamento inteligente com consciência de tamanho para markitdown + fallback pandas para arquivos tabulares grandes. Projetado para o sistema Hermes Agent.
Visão Geral
Esta habilidade converte automaticamente documentos para Markdown usando a biblioteca markitdown. Para arquivos tabulares grandes (XLSX/CSV), ela utiliza roteamento inteligente baseado em tamanho: arquivos pequenos são processados com markitdown, enquanto arquivos grandes (>10MB) recebem fallback para pandas, extraindo os dados para markdown de forma eficiente.
Formatos Suportados
- DOCX
- PPTX
- XLSX (com fallbase inteligente para pandas)
- CSV (com fallback inteligente para pandas)
- HTML
- Imagens (via OCR, se configurado)
- E outros formatos suportados pelo markitdown
Instalação
Certifique-se de ter o markitdown e o pandas instalados:
pip install markitdown pandas
Uso
A habilidade é ativada automaticamente quando um arquivo de documento é detectado. Exemplo:
from hermes_agent import Agent
agent = Agent(skills=["yanyintingyou/markitdown-auto-converter-agent-skill"])
agent.run("Converta este arquivo para markdown: ./documento.docx")
Configuração
MARKITDOWN_AUTO_CONVERTER_MAX_TABLE_SIZE_MB: Tamanho máximo em MB para usar markitdown diretamente em arquivos tabulares (padrão: 10).MARKITDOWN_AUTO_CONVERTER_OCR_LANGUAGE: Idioma para OCR (padrão: 'eng').
Comportamento de Roteamento
| Tipo de Arquivo | Tamanho | Mecanismo |
|---|---|---|
| Tabular (XLSX/CSV) | <= 10MB | markitdown |
| Tabular (XLSX/CSV) | > 10MB | pandas fallback |
| Outros | Qualquer | markitdown |
Tratamento de Erros
Se o markitdown falhar, a habilidade tentará automaticamente o fallback para pandas em arquivos tabulares. Em caso de erro geral, uma mensagem descritiva será retornada.
Logs
A habilidade fornece logs detalhados do processo de conversão, incluindo o mecanismo utilizado e o tempo de processamento.
Licença
MIT