Lendo Arquivos - Processar Uploads do Usuario

Skill para leitura de arquivos enviados pelo usuario via upload.

ESCOPO: Esta skill processa Excel (.xlsx, .xls) e CSV. Para CRIAR/EXPORTAR arquivos para download, use exportando-arquivos. Para consultas Odoo (NF, PO, SO, titulos), use rastreando-odoo.

Script Principal

ler.py

source .venv/bin/activate && \
python .claude/skills/lendo-arquivos/scripts/ler.py [opcoes]

Tipos de Arquivo

FORMATOS SUPORTADOS
│
├── Excel (.xlsx)
│   Engine: openpyxl
│   Usar: Planilhas modernas (2007+)
│
├── Excel (.xls)
│   Engine: xlrd
│   Usar: Planilhas legado (97-2003)
│
└── CSV (.csv)
    Separadores: ; , \t |
    Usar: Arquivos texto estruturados

Parametros

Parametros Principais

Exemplos de Uso

Ler arquivo Excel

source .venv/bin/activate && \
python .claude/skills/lendo-arquivos/scripts/ler.py \
  --url "/agente/api/files/default/abc123_planilha.xlsx"

Ler com limite de linhas

python .../ler.py --url "/agente/api/files/default/dados.xlsx" --limite 50

Ler aba especifica

python .../ler.py --url "/agente/api/files/default/multi.xlsx" --aba "Vendas"

Ler CSV

python .../ler.py --url "/agente/api/files/default/dados.csv"

Retorno JSON

{
  "sucesso": true,
  "arquivo": {
    "nome": "planilha.xlsx",
    "tipo": "excel",
    "tamanho": 15234,
    "tamanho_formatado": "14.9 KB",
    "abas": ["Dados", "Resumo"],
    "aba_lida": "Dados"
  },
  "dados": {
    "colunas": ["Pedido", "Cliente", "Valor"],
    "total_linhas": 150,
    "linhas_retornadas": 100,
    "registros": [
      {"Pedido": "VCD123", "Cliente": "ATACADAO", "Valor": 50000},
      {"Pedido": "VCD456", "Cliente": "ASSAI", "Valor": 75000}
    ]
  },
  "resumo": "Arquivo EXCEL com 150 linhas e 3 colunas (limitado). Colunas: Pedido, Cliente, Valor"
}

Fluxo de Uso

Quando o usuario anexar um arquivo e pedir "analise essa planilha":

1. Identificar URL do arquivo nos metadados do anexo
2. Executar script:

   source .../venv/bin/activate && python .../ler.py --url "URL_DO_ARQUIVO"
   

3. Analisar JSON retornado
4. Responder ao usuario com insights dos dados

Tratamento de Erros

Conversoes Automaticas

Notas

• Limite padrao: 1000 linhas (para evitar respostas muito grandes)
• Para arquivos grandes, use --limite para obter amostra
• Separador CSV eh detectado automaticamente (;, ,, \t, |)
• Encoding: UTF-8 com BOM suportado

Relacionado

NOTA: Esta skill eh para LEITURA de arquivos do usuario. Para criar arquivos para download, use exportando-arquivos.