PSPDFKit-labs/nutrient-agent-skill

O que nutrient-agent-skill faz?

Processamento de documentos com a API Nutrient DWS: conversão, extração de texto/tabelas, OCR, redação de PII, marca d'água, assinaturas digitais e preenchimento de formulários.

Visão Geral

O skill PSPDFKit-labs/nutrient-agent-skill permite que agentes de IA utilizem os recursos da API Nutrient DWS para manipular e processar documentos de forma programática. As principais funcionalidades incluem:

• Conversão de Documentos: Converta documentos entre formatos como PDF, DOCX, HTML, imagens (TIFF, JPEG, PNG), e muito mais.
• Extração de Texto e Tabelas: Extraia texto puro, texto com layout preservado e tabelas estruturadas de documentos.
• OCR (Reconhecimento Óptico de Caracteres): Execute OCR em documentos escaneados ou baseados em imagem para torná-los pesquisáveis.
• Redação de PII: Identifique e redija informações pessoais identificáveis (PII) automaticamente ou manualmente.
• Marca D'água: Adicione marcas d'água de texto ou imagem em documentos.
• Assinaturas Digitais: Aplique e verifique assinaturas digitais em documentos PDF.
• Preenchimento de Formulários: Preencha campos de formulários em PDF com dados fornecidos.

Como Funciona

O agente interage com a API Nutrient DWS por meio de chamadas HTTP ou comandos pré-definidos no contexto do skill. Cada operação requer parâmetros específicos, como o caminho do documento de entrada, o formato de saída desejado e, quando aplicável, configurações avançadas.

Exemplo de uso (em linguagem natural):

• "Converta este DOCX para PDF"
• "Extraia as tabelas deste documento escaneado"
• "Redija os nomes e CPFs deste PDF"
• "Preencha o formulário modelo.docx com os dados do usuário"

Parâmetros comuns:

• --input ou input_path: Caminho do arquivo de entrada.
• --output ou output_format: Formato de saída desejado (pdf, docx, txt, etc.).
• --pages: Seleção de páginas para processamento (ex: 1-5 ou 1,3,5).
• --ocr: Habilita OCR (true/false).
• --redact: Lista de tipos de PII para redação (ex: nome, cpf, email).
• --watermark-text: Texto da marca d'água.
• --signature: Caminho para o certificado de assinatura digital.
• --form-data: Dados para preenchimento de formulário (JSON ou caminho de arquivo).

Requisitos

• Acesso a uma instância da API Nutrient DWS (cloud ou on-premises).
• Token ou chave de API configurada (geralmente por meio de variável de ambiente NUTRIENT_API_KEY ou DWS_API_KEY).
• Conexão de rede para comunicações com a API.

Plataformas Suportadas

• Claude Code: Agente pode invocar o skill passando instruções em linguagem natural.
• Cursor: Suportado por meio de comandos de terminal ou integração via plugin.
• Codex: Pode ser usado em prompts para gerar código que chama a API diretamente.

Como Configurar

1. Certifique-se de que a chave da API Nutrient DWS esteja definida no ambiente (ex: NUTRIENT_API_KEY=your_api_key_here).
2. O skill já vem pré-configurado para usar a instância cloud padrão; para on-premises, defina NUTRIENT_API_URL.
3. Para usar em um agente, carregue o skill com:

load skill PSPDFKit-labs/nutrient-agent-skill

Limitações

• Depende de conectividade com a API Nutrient DWS.
• Operações em documentos muito grandes podem exigir mais tempo e recursos.
• A precisão do OCR e redação de PII depende da qualidade do documento de entrada.