# Formatos DOCX e XLSX: quando é necessário um documento final completo gerado por IA

> Guia prático completo para geração e processamento de documentos DOCX e planilhas XLSX com IA: comparação com Markdown e CSV, engenharia de prompts, trabalho com fórmulas e automação em código.

## 1. Quatro formatos — quatro tarefas distintas: Text, CSV, DOCX e XLSX

Um dos erros mais comuns ao interagir com a Inteligência Artificial é exigir imediatamente: *«Gere um documento Word»* ou *«Exporte tudo para Excel»*. A extensão do arquivo, por si só, não agrega valor se o formato escolhido não corresponder à próxima etapa do ciclo de vida dos dados.

```mermaid
flowchart TD
    A["Вхідний запит / Сирі дані"] --> B{"Яка мета використання результату?"}
    B -->|Обговорення, драфт, код, проміжний аналіз| C["Текст / Markdown<br><i>(Максимальна швидкість, гнучкість у чаті)</i>"]
    B -->|Імпорт у БД, міграція, машинний парсинг| D["CSV / JSON<br><i>(Легкий формат, плоска структура даних)</i>"]
    B -->|Презентація клієнту, друк, фірмовий звіт| E["DOCX<br><i>(Стилі, ієрархія H1-H3, колонтитули, брендбук)</i>"]
    B -->|Розрахунки, бізнес-план, щоденний облік| F["XLSX<br><i>(Багатосторінковість, динамічні формули, фільтри)</i>"]
```

### Matriz de seleção do formato ideal

| Formato | Quando usar | Principais vantagens | Quando evitar |
| :--- | :--- | :--- | :--- |
| **Texto / Markdown** | Rascunhos, discussões iterativas, geração de código | Resposta imediata, ausência de artefatos binários | Relatórios finais para clientes e diretoria |
| **CSV** | Exportação de grandes conjuntos de dados (>10.000 linhas), importação em CRM | Universalidade, tamanho mínimo | Cálculos, relatórios multipágina, formatação |
| **DOCX** | Regulamentos, propostas comerciais, manuais, contratos | Layout corporativo, estilos do Word, impressão | Notas intermediárias e código bruto |
| **XLSX** | Orçamentos, planos de conteúdo, modelos financeiros, dashboards | Fórmulas funcionais, resumos, filtros, formatação condicional | Simples troca de listas entre scripts |

> [!NOTE]
> Se você pedir ao modelo que desenvolva o conceito de um relatório ou a estrutura de um curso, gerar um DOCX é prematuro: é mais eficiente polir o texto no chat e fixar os tópicos primeiro. Os formatos DOCX e XLSX devem aparecer quando o próprio arquivo se torna o produto final.

---

## 2. Quando solicitar DOCX: do rascunho ao artefato final

O DOCX é necessário nos casos em que o documento se destina à leitura humana, revisão colaborativa na suíte de escritório ou fluxo documental oficial.

### O que o DOCX oferece além do texto simples

1. **Hierarquia tipográfica rigorosa:** Uso de estilos semânticos do Word (*Título 1*, *Título 2*, *Corpo de Texto*), permitindo que o documento gere automaticamente um sumário clicável.
2. **Template visual unificado:** Possibilidade de alterar fonte ou espaçamento entre linhas em todo um documento de 50 páginas com um clique via painel de estilos.
3. **Formatação de tabelas complexas:** Largura fixa de colunas, cabeçalhos coloridos e alinhamento de valores numéricos.
4. **Elementos de layout institucional:** Números de página, cabeçalhos/rodapés com nome do projeto, páginas de rosto e quebras de seção.

![Estrutura de tabela em documentos DOCX e XLSX](/api/guides-media/automation/docx-xlsx-document-formats-for-ai/images/docx-xlsx-document-formats-for-ai-extra-01.webp)

```markdown
| Etapa | Responsável | Prazo |
| :--- | :--- | :--- |
| **Preparação** | Especialista em Marketing | 3 dias |
| **Revisão** | Líder de Diretoria | 1 dia |
| **Publicação** | Gerente de Conteúdo | 1 dia |
```

> [!TIP]
> Se você precisa fazer ajustes pontuais no texto de um parágrafo, trabalhe diretamente no chat. Criar um DOCX vale a pena apenas quando o documento final estiver pronto para ser entregue aos stakeholders ou arquivado.

---

## 3. Elaboração de um brief perfeito para geração de DOCX

A frase *«Faça um arquivo bonito no Word»* faz a IA agir aleatoriamente. Para obter um resultado previsível, utilize uma abordagem de engenharia na formulação do prompt.

```mermaid
flowchart LR
    A["1. Цільова аудиторія та роль"] --> B["2. Жорстка структура розділів"]
    B --> C["3. Внутрішні компоненти (Таблиці/Списки)"]
    C --> D["4. Стилістичні вимоги (Шрифти/Поля)"]
    D --> E["Готовий бізнес-документ DOCX"]
```

### Cinco componentes obrigatórios do prompt

1. **Propósito do documento:** Para quem o texto é escrito (conselho administrativo, suporte técnico, cliente B2B).
2. **Lista de seções obrigatórias:** Fixe a sequência: *Página de Rosto $\rightarrow$ Resumo Executivo $\rightarrow$ 4 Etapas $\rightarrow$ Riscos $\rightarrow$ Orçamento*.
3. **Requisitos de componentes:** O que deve ser apresentado como lista com marcadores, o que como regulamento numerado e o que como tabela comparativa.
4. **Diretrizes de estilo:** Fonte desejada (*Calibri*, *Aptos*, *Inter*), espaçamento entre linhas (1.15) e cores de destaque para caixas de texto.
5. **Limites de intocabilidade (para edição):** Proibição clara de alterar formulações jurídicas ou especificações no texto de entrada.

### Comparação de prompts: fraco vs. preciso

:::tabs
@tab Prompt Fraco
```text
Crie um regulamento de trabalho do departamento de vendas em Word.
```
*Resultado:* Texto corrido sem estilos, fontes aleatórias, ausência de página de rosto, desperdício de tempo com reformatamento manual.
@tab Brief Profissional
```text
Crie um regulamento interno pronto no formato DOCX: «Atuação dos gestores no CRM».
Público-alvo: novos colaboradores do departamento de vendas B2B.
Estrutura:
1. Página de capa com o título e a versão do documento.
2. Sumário automático baseado em Títulos de nível 1 e 2.
3. Processo passo a passo para tratamento de leads (lista numerada com ações).
4. Tabela «Status das oportunidades, campos obrigatórios e prazos».
5. Matriz de erros comuns e métodos para sua correção.
6. Checklist final de preparação para a ligação.
Formatação: estilo corporativo sóbrio, fonte Aptos 11pt, margens de 2 cm, cor de destaque azul (#1E40AF) para os cabeçalhos das tabelas.
```
:::

---

## 4. Quando o XLSX é necessário: dados dinâmicos, planilhas e fórmulas

O XLSX é escolhido quando o arquivo deve funcionar como uma ferramenta de cálculo viva, e não como um snapshot estático de números.

### Sinais de que você precisa exatamente de um XLSX:

- Os dados exigem atualização mensal e recálculo de totais.
- É necessário vincular várias fontes através de fórmulas (`SUM`, `AVERAGE`, `VLOOKUP`, `XLOOKUP`).
- O projeto possui múltiplas dimensões (por exemplo: planilha separada para receitas, despesas e dashboard consolidado).
- Os usuários aplicarão filtros por status, gerentes ou datas.
- É necessária formatação condicional para visualização instantânea de riscos (destaque de pagamentos vencidos).

```mermaid
flowchart TD
    subgraph Excel_Workbook["Структура робочої книги XLSX"]
        S1["Аркуш 1: 'Вихідні дані'<br><i>(Чистий реєстр угод, дати, суми)</i>"]
        S2["Аркуш 2: 'Розрахунки'<br><i>(Динамічні формули, коефіцієнти, маржа)</i>"]
        S3["Аркуш 3: 'Дашборд'<br><i>(Зведені підсумки, ключові KPI, діаграми)</i>"]
    end
    S1 -->|Посилаються формули| S2
    S2 -->|Агрегує показники| S3
```

---

## 5. XLSX vs. CSV: principais diferenças arquiteturais

Devido à semelhança externa das representações tabulares, desenvolvedores iniciantes frequentemente confundem esses formatos ou escolhem a ferramenta inadequada.

| Parâmetro | CSV (Comma-Separated Values) | XLSX (Microsoft Excel OpenXML) |
| :--- | :--- | :--- |
| **Natureza do formato** | Fluxo de texto plano com delimitadores | Pacote XML compactado e mídia (ZIP) |
| **Multipágina** | Apenas 1 planilha plana | Número ilimitado de planilhas nomeadas |
| **Suporte a fórmulas** | Ausente (armazenam-se apenas linhas brutas) | Suporte completo ao motor de cálculo do Excel |
| **Formatação** | Nenhuma (sem cor, fontes, largura de coluna) | Fontes, bordas, preenchimento, formatos de número/moeda |
| **Filtros e validação** | Ausentes | Autofiltros, listas suspensas, bloqueio de células |
| **Tamanho do arquivo** | Mínimo (ideal para milhões de linhas) | Maior devido a metadados estruturais |

> [!WARNING]
> Se você salvar uma pasta de trabalho complexa do Excel com múltiplas planilhas e fórmulas no formato CSV, todas as planilhas adicionais, gráficos e vínculos matemáticos serão irremediavelmente perdidos!

---

## 6. Engenharia de fórmulas, tipos de dados e formatação condicional no XLSX

A principal vantagem de um arquivo XLSX de qualidade gerado pela IA reside na correta separação entre dados brutos e lógica computacional.

### Fórmulas em vez de números estáticos

Sempre exija que a IA registre nas células de totalização fórmulas reais:
- ❌ **Ruim:** A IA calculou a soma na memória e registrou na célula `D20` o número `45200`. (Ao alterar os preços originais, o total permanecerá incorreto).
- ✅ **Correto:** A IA registrou na célula `D20` a fórmula `=SUM(D2:D19)`. (A tabela permanece interativa permanentemente).

### Tipagem estrita de dados

Cada coluna deve ter um formato claramente designado:
- **Datas:** formato `DD.MM.YYYY` ou `YYYY-MM-DD` (para que o Excel ordene cronologicamente, e não como texto).
- **Valores monetários:** formato numérico com separador de milhar e símbolo da moeda (`R$ 12.500,00` ou `$12,500.00`).
- **Porcentagens:** formato numérico de porcentagem (`15.4%`), e não string de texto `"15%"`.

### Formatação condicional dinâmica

Indicadores automáticos de cor ajudam a avaliar a situação sem ler centenas de linhas:
- Gradiente verde: cumprimento da meta $\ge 100\%$.
- Destaque vermelho: gasto ultrapassa o limite ou prazo está vencido.

---

## 7. Elaboração de briefs para geração de tabelas XLSX

Para obter uma tabela madura da Inteligência Artificial, formule cinco blocos básicos de requisitos.

```mermaid
flowchart TD
    A["1. Архітектура аркушів"] --> B["2. Реєстр стовпців та типи даних"]
    B --> C["3. Математичні формули та зв'язки"]
    C --> D["4. Фільтри, сортування та випадаючі списки"]
    D --> E["5. Зведені підсумки та візуальні діаграми"]
```

### Prompt padrão para arquivo de cálculo

```text
Crie uma pasta de trabalho XLSX completa para o cálculo do orçamento anual de um projeto de TI para 2027.

Estrutura das planilhas:
1. “Parâmetros”: taxas horárias dos especialistas, coeficientes fiscais, taxas de câmbio.
2. “Despesas”: registro de itens (categoria, executor, taxa, quantidade de horas, valor).
3. “Resumo”: relatório mensal com despesas planejadas e reais, desvios e % de execução.

Requisitos para os cálculos:
- Calcule o valor em “Despesas” usando a fórmula de multiplicação das horas pela taxa da planilha “Parâmetros”.
- Na planilha “Resumo”, utilize as fórmulas SUMIF/SUMIFS para agregação por categorias.
- Adicione o cálculo do desvio: =(Real - Planejado) / Planejado.

Formatação:
- Congele a primeira linha (cabeçalhos) em todas as planilhas.
- Ative filtros automáticos na planilha “Despesas”.
- Formate os valores monetários em USD com duas casas decimais.
- Na planilha “Resumo”, adicione um gráfico de colunas “Planejado vs Real por mês”.
```

---

## 8. Trabalho com templates: criação do zero vs. atualização de arquivos existentes

Criar um arquivo do zero e atualizar um template corporativo já existente são duas operações de engenharia fundamentalmente diferentes.

```mermaid
flowchart LR
    subgraph From_Scratch["Створення з нуля"]
        A1["Опис архітектури"] --> B1["Проєктування сітки"] --> C1["Генерація нового файлу"]
    end
    subgraph By_Template["Робота за шаблоном"]
        A2["Завантаження еталона"] --> B2["Аналіз зв'язків і формул"] --> C2["Акуратне оновлення комірок"]
    end
```

### Regras para atualização segura de templates

1. **Fixe elementos intocáveis:** Instrua claramente o modelo: *«Não altere nomes das planilhas, tamanho das fontes, cabeçalhos de tabelas e fórmulas nas colunas F:H»*.
2. **Especifique limites precisos para inserção de novas linhas:** Por exemplo: *«Adicione novas linhas de transações ao final da tabela antes da linha de total 'Total' e expanda o intervalo na fórmula SUM»*.
3. **Preservação de macros e conexões:** Se o arquivo original contiver scripts VBA ou conexões com bancos de dados, certifique-se de que o processamento não danifique as estruturas binárias da pasta de trabalho.

---

## 9. Automação em código: como IA e backend geram DOCX e XLSX

Quando agentes de IA operam em ambientes de produção (por exemplo, via Claude Code, LangChain ou serviços de backend personalizados), a geração de arquivos ocorre não manualmente, mas através de bibliotecas de software robustas.

:::tabs
@tab Python (python-docx)
```python
from docx import Document
from docx.shared import Inches, Pt, RGBColor
from docx.enum.text import WD_ALIGN_PARAGRAPH

doc = Document()

# Налаштування стилів документа
title = doc.add_heading("Звіт з продуктивності команди", level=0)
title.alignment = WD_ALIGN_PARAGRAPH.CENTER

p = doc.add_paragraph("Цей документ сформовано автоматично на основі даних за 3 квартал.")
p.runs[0].font.size = Pt(11)

# Додавання таблиці з даними
table = doc.add_table(rows=1, cols=3)
table.style = 'Light Shading Accent 1'
hdr_cells = table.rows[0].cells
hdr_cells[0].text = 'Спринт'
hdr_cells[1].text = 'Задач закрито'
hdr_cells[2].text = 'Ефективність'

data = [("Sprint 41", "34", "94%"), ("Sprint 42", "41", "98%")]
for sprint, count, eff in data:
    row_cells = table.add_row().cells
    row_cells[0].text = sprint
    row_cells[1].text = count
    row_cells[2].text = eff

doc.save("team_report.docx")
```
@tab Python (openpyxl)
```python
from openpyxl import Workbook
from openpyxl.styles import Font, PatternFill, Alignment

wb = Workbook()
ws = wb.active
ws.title = "Бюджет"

# Створення та стилізація заголовків
headers = ["Категорія", "План ($)", "Факт ($)", "Відхилення ($)"]
ws.append(headers)

header_fill = PatternFill(start_color="1E40AF", end_color="1E40AF", fill_type="solid")
header_font = Font(color="FFFFFF", bold=True)

for col_num in range(1, 5):
    cell = ws.cell(row=1, column=col_num)
    cell.fill = header_fill
    cell.font = header_font
    cell.alignment = Alignment(horizontal="center")

# Додавання рядків даних
rows = [
    ["Сервери AWS", 2500, 2350],
    ["Маркетинг", 5000, 5600],
    ["Підписки на ПЗ", 800, 800],
]

for row_idx, data in enumerate(rows, start=2):
    ws.append([data[0], data[1], data[2], f"=C{row_idx}-B{row_idx}"])

# Підсумковий рядок із формулами
ws.append(["Разом", "=SUM(B2:B4)", "=SUM(C2:C4)", "=SUM(D2:D4)"])
ws.cell(row=5, column=1).font = Font(bold=True)

wb.save("project_budget.xlsx")
```
@tab TypeScript (exceljs)
```typescript
import ExcelJS from 'exceljs';

async function generateSpreadsheet() {
  const workbook = new ExcelJS.Workbook();
  const sheet = workbook.addWorksheet('Sales Data');

  sheet.columns = [
    { header: 'Продукт', key: 'product', width: 25 },
    { header: 'Кількість', key: 'qty', width: 15 },
    { header: 'Ціна за од.', key: 'price', width: 15 },
    { header: 'Разом', key: 'total', width: 18 }
  ];

  sheet.addRow({ product: 'Cloud Gateway License', qty: 5, price: 1200, total: { formula: 'B2*C2' } });
  sheet.addRow({ product: 'Support SLA Tier 1', qty: 1, price: 3500, total: { formula: 'B3*C3' } });

  await workbook.xlsx.writeFile('enterprise_sales.xlsx');
}
```
:::

---

## 10. Protocolo de verificação e validação de arquivos gerados

Nunca envie arquivos criados automaticamente para clientes ou parceiros sem inspeção prévia. Verifique o documento conforme dois protocolos especializados.

### Protocolo de controle de qualidade para DOCX

- [ ] **Estrutura semântica:** O documento utiliza níveis de título nativos (*Heading 1*, *Heading 2*), e não apenas texto em negrito com fonte maior.
- [ ] **Integridade das tabelas:** As tabelas não ultrapassam as margens da página; o texto nas células não se sobrepõe nem é cortado.
- [ ] **Quebras de página:** Não há "títulos órfãos" na última linha da página sem o texto subsequente.
- [ ] **Campos de serviço:** Numeração de páginas verificada (primeira página oculta se necessário) e índice.

### Protocolo de controle de qualidade para XLSX

- [ ] **Fórmulas vivas:** Células de totalização contêm fórmulas (`=SUM()`), e não números estáticos.
- [ ] **Intervalos de fórmulas:** Verificado se os intervalos de totais abrangem todas as linhas inseridas, incluindo a última.
- [ ] **Teste de recálculo:** Altere um número base — todo o modelo deve atualizar o resultado automaticamente.
- [ ] **Formatos de exibição:** Células de moeda e porcentagem possuem formatação adequada, sem erros `#VALUE!` ou `#REF!`.

---

## 11. Biblioteca pronta de master-prompts e checklist de implementação

Utilize estes templates prontos como base comprovada para automação diária.

### Master-prompt para regulamentos e relatórios em DOCX

```markdown
Atue como um escritor técnico sênior. Crie um documento oficial pronto para uso no formato DOCX.

Tema: [Indique o tema, por exemplo: Regulamento de Segurança para Postos de Trabalho Remotos]
Público-alvo: [Indique o público-alvo]

Estrutura do documento:
1. Capa (Título, versão, autor, data).
2. Resumo e objetivos do documento.
3. Requisitos normativos (regulamento numerado das ações).
4. Tabela consolidada: “Ameaça | Nível de Risco | Ação Preventiva | Responsável”.
5. Matriz de escalonamento de incidentes.
6. Checklist final de autoverificação para o colaborador.

Requisitos de formatação:
- Fonte do texto principal: Aptos ou Calibri 11pt, espaçamento entre linhas 1,15.
- Estilos de títulos: Heading 1 (18pt, Negrito), Heading 2 (14pt, SemiBold).
- Esquema de cores das tabelas: destaque em azul-marinho para os cabeçalhos, alternância de linhas em cinza claro.
- Inclua um sumário no início do documento.
```

### Master-prompt para modelos financeiros em XLSX

```markdown
Atue como um analista financeiro. Crie uma planilha XLSX completa para um plano de negócios.

São necessárias as seguintes abas separadas:
1. “Parâmetros”: premissas de entrada (custo unitário, preço de venda, taxas de conversão, impostos).
2. “Vendas”: projeção mensal do número de transações e da receita bruta por meio de fórmulas.
3. “OPEX”: lista de despesas operacionais por categoria (aluguel, servidores, folha de pagamento).
4. “DRE Consolidado”: relatório mensal de lucros e perdas (Receita, Despesas, EBITDA, Lucro Líquido).

Requisitos de lógica:
- É proibido inserir valores calculados manualmente (hardcode) — todos os números na aba “DRE Consolidado” devem referenciar as abas “Vendas” e “OPEX” por meio de fórmulas.
- Configure o formato monetário em USD para todas as células financeiras.
- Adicione formatação condicional para a margem: verde quando >25%, vermelho quando <10%.
- Crie um gráfico combinado na aba “DRE”: colunas representando a receita e linha representando o lucro líquido.
```

### Checklist final de seleção de formato

- [ ] Necessário texto para negociações, ideias ou alinhamento de teses $\rightarrow$ **Chat / Markdown**.
- [ ] Necessários dados estruturados planos para importação em bancos ou scripts $\rightarrow$ **CSV**.
- [ ] Necessário documento representativo para leitura humana, impressão e arquivo $\rightarrow$ **DOCX**.
- [ ] Necessária planilha interativa funcional com fórmulas, análise e abas $\rightarrow$ **XLSX**.