kreuzberg

Visão geral da skill kreuzberg

O que a kreuzberg faz

A kreuzberg skill ajuda você a usar o Kreuzberg para extrair texto, tabelas, metadados, imagens e conteúdo com base em OCR de mais de 91 formatos de documentos, com suporte nativo a Python, Node.js/TypeScript, Rust e uma CLI. Ela é ideal para quem precisa de código confiável de processamento de documentos, e não apenas de um prompt pontual que tenta adivinhar como fazer o parsing.

Quem deve instalar

Instale kreuzberg se sua tarefa for transformar PDFs, arquivos do Office, imagens, HTML, e-mails, arquivos compactados ou arquivos acadêmicos em saída estruturada — especialmente quando a qualidade da digitalização, execuções em lote ou OCR específico por idioma importam. Ela é uma boa escolha para pipelines de ingestão, busca em documentos, preparo para RAG e ferramentas de extração.

Por que ela é diferente

O principal valor da kreuzberg skill é ser orientada à implementação: ela cobre caminhos de instalação, modos de extração, configuração, processamento em lote, tratamento de erros e plugins em múltiplos runtimes. Isso a torna mais útil do que um prompt genérico de “analise este documento” quando você precisa de código que realmente possa executar.

Como usar a kreuzberg skill

Instale e confirme o runtime de destino

Para uma kreuzberg install rápida, comece pelo runtime que você realmente vai entregar:

pip install kreuzberg
npm install @kreuzberg/node
cargo install kreuzberg-cli

Depois, leia primeiro a referência de API correspondente: references/python-api.md, references/nodejs-api.md ou references/rust-api.md. Se você estiver usando a CLI, comece por references/cli-reference.md. A skill funciona melhor quando você escolhe primeiro um runtime e um tipo de documento, em vez de pedir tudo de uma vez.

Transforme um pedido vago em um prompt útil

Um bom prompt de kreuzberg usage nomeia o tipo de arquivo, o objetivo da extração, o runtime e as restrições. Por exemplo: “Use kreuzberg em Python para extrair texto de faturas, tabelas e OCR de PDFs digitalizados, mantendo quebras de linha e retornando JSON pronto para parsing posterior.” Isso é melhor do que “extraia dados de PDFs” porque deixa claro se a prioridade é tabela, OCR ou texto limpo.

Leia estes arquivos primeiro

Para um trabalho prático com o kreuzberg guide, leia nesta ordem: SKILL.md, references/configuration.md, o arquivo de API do runtime e references/supported-formats.md. Depois, abra references/advanced-features.md se você precisar de plugins, ajuste de OCR ou comportamento em lote. Essa ordem evidencia as decisões que mais afetam a adoção: formato de instalação, entradas suportadas e valores padrão de configuração.

Use o fluxo que combina com a sua tarefa

Se você estiver processando um único arquivo, comece com uma chamada simples de extract_file ou com extract na CLI e só adicione dicas de MIME ou configuração se a saída estiver errada. Se você estiver processando muitos arquivos, verifique cedo os auxiliares de batch e o tratamento de erros. Para kreuzberg for PDF Processing, ajustes de OCR e formato de saída costumam importar mais do que a chamada básica de extração, então valide isso antes de escalar.

FAQ da skill kreuzberg

A kreuzberg serve só para PDFs?

Não. PDF é um caso de uso importante, mas a skill também cobre documentos do Office, imagens, HTML, e-mail, arquivos compactados e formatos acadêmicos. Se sua carga de trabalho mistura vários formatos, kreuzberg é mais adequada do que uma ferramenta só para PDF.

Preciso conhecer a biblioteca antes de usar a skill?

Não, mas você precisa saber qual é o runtime de destino e qual resultado espera. A kreuzberg skill é amigável para iniciantes se você conseguir descrever o tipo de documento, se OCR é necessário e se quer texto puro, markdown, JSON ou metadados estruturados.

Quando não devo usar a kreuzberg?

Pule a kreuzberg se sua tarefa for principalmente de sumarização semântica, e não de extração, ou se você só precisar de um prompt manual rápido para um documento único, sem saída em código. Ela também pode ser exagero se seu pipeline não precisar de OCR, tabelas ou suporte a múltiplos formatos.

Em que ela difere de um prompt normal?

Um prompt normal pode descrever a tarefa, mas a kreuzberg usage trata de acertar instalação, chamada de API, configuração e tratamento de falhas para extração de documentos. Isso a torna melhor quando a qualidade da saída depende da configuração do runtime, da escolha do backend de OCR ou dos detalhes do processamento em lote.

Como melhorar a kreuzberg skill

Informe a estrutura da entrada logo de cara

Os melhores resultados da kreuzberg skill vêm de prompts que especificam tipo de arquivo, qualidade da origem e saída desejada. Inclua detalhes como “PDF digitalizado”, “PDF nativo”, “tabelas de fatura”, “anexos de e-mail” ou “preservar títulos”. Esses detalhes mudam se o padrão ideal deve ser OCR, chunking ou extração simples.

Diga qual falha você quer evitar

Se a primeira saída vier ruim, diga à skill o que deu errado: tabelas faltando, quebras de linha quebradas, OCR lento, detecção de idioma ruim ou imagens muito ruidosas. Para kreuzberg for PDF Processing, isso ajuda a restringir se vale ajustar o backend de OCR, a configuração ou o formato de saída, em vez de reescrever o fluxo inteiro.

Itere com exemplos concretos

Um ciclo de melhoria mais forte é colar a descrição de um arquivo problemático e um resultado-alvo, por exemplo: “Esta fatura digitalizada deve gerar número da fatura, total, fornecedor e itens em JSON.” Isso é mais útil do que pedir para “tornar mais preciso”, porque a skill consegue ajustar a orientação de extração ao schema e ao tipo de documento reais.

Comece de forma restrita e depois expanda

Comece com um runtime, um formato e um modo de extração. Depois que a kreuzberg install básica e o caminho de extração estiverem funcionando, adicione processamento em lote, plugins ou configuração avançada. Isso reduz a confusão e facilita verificar se o problema está na instalação, no OCR ou no parsing downstream.