---
title: Planilhas Nativas para Agentes
description: Como a Siglata integra cálculos reativos de planilhas com toolchains de agentes de IA.
sidebar:
  label: Planilhas
  order: 1
---

As planilhas da Siglata tratam dados e interações com agentes como conceitos de primeira classe. Em vez de arquivos binários opacos, cada planilha é sustentada por um catálogo versionado e verificável acessível diretamente por ferramentas MCP e APIs REST.

## Arquitetura

1. **Engine de Células Reativas**: Cálculos são atualizados de forma reativa com schemas tipados e validação de fórmulas.
2. **Planejar e Aplicar Transacional**: Os agentes não gravam às cegas; eles propõem mudanças planejadas, revisam digests e realizam o commit de forma atômica.
3. **Histórico Auditável**: Cada edição registra proveniência, hashes criptográficos e identidade do autor.

## Interagindo via MCP

Agentes usam a skill `@siglata/files` para ler e editar planilhas:

```javascript
// Buscar arquivos na organização
const results = await files.search({ query: "previsao-t3" });

// Propor uma atualização de célula
const plan = await files.execute({
  mode: "plan",
  script: "await sheets.updateCell('A1', 42);",
});

// Aplicar o digest validado
await files.execute({
  mode: "apply",
  digest: plan.digest,
});
```

## Formatos Suportados

- Planilhas reativas nativas da Siglata
- Importação e exportação `.xlsx` com preservação de fórmulas
- Exportação em Parquet e CSV para pipelines de ciência de dados