# Markdown + Agentes de IA: Como Automatizar a Produção de Conteúdo Técnico

**Categoria:** Automação | **Tempo de leitura:** 12 min | **Autor:** Equipe ITC Service

---

Produzir conteúdo técnico de qualidade exige tempo que equipes de TI não têm. Agentes de IA integrados a pipelines Markdown resolvem isso: escrevem, revisam e publicam artigos técnicos com consistência, sem alucinação e com versionamento real. Este guia mostra como montar esse pipeline usando Astro, agentes LLM e Git como fonte da verdade.

## Por que Markdown e não CMS tradicional?

CMSs (WordPress, Ghost) são ótimos para blogs editoriais. Para conteúdo técnico, eles falham:

- **Sem versionamento**: difícil rastrear quem mudou o quê e quando
- **Sem code review**: artigo técnico é código — precisa de PR e aprovação
- **Sem portabilidade**: locked-in ao formato do CMS
- **Sem automação nativa**: integrar agente de IA exige plugin frágil ou API customizada

Markdown + Git resolve tudo isso. O artigo é um arquivo `.md`, vive no repositório, passa por CI/CD e é renderizado estaticamente. Agentes de IA leem e escrevem Markdown nativamente — zero adaptação.

## Arquitetura do Pipeline

```
[Agente IA] → [PR no Git] → [CI/CD] → [Build Astro] → [Deploy Cloudflare Pages]
↑ |
└────────────── [Feedback/Analytics] ←─────────────────────────┘
```

Cada etapa é auditável, reversível e automatizável.

## Passo 1: Estrutura do Repositório

```
content/
blog/
entregabilidade-email-transacional-guia-ti.md
infraestrutura-vibe-coding-empresa.md
...
scripts/
generate-article.mjs
review-article.mjs
astro.config.mjs
package.json
```

Frontmatter padrão para cada artigo:

```yaml
---
title: "Entregabilidade de Email Transacional: Guia Completo"
slug: entregabilidade-email-transacional-guia-ti
category: Infraestrutura
author: Equipe ITC Service
date: 2026-09-10
tags: [email, infraestrutura, dkim, spf]
cta: "Auditoria gratuita de entregabilidade"
status: draft # draft | review | published
---
```

O campo `status` controla o fluxo: agentes só editam `draft`, humanos aprovam mudando para `review`, CI publica apenas `published`.

## Passo 2: Agente Gerador de Artigos

```javascript
// scripts/generate-article.mjs
import { readFileSync, writeFileSync } from 'fs';
import OpenAI from 'openai';

const openai = new OpenAI({
baseURL: process.env.AI_GATEWAY_URL, // AI Gateway da Cloudflare
apiKey: process.env.OPENAI_KEY
});

const topic = process.argv[2];
if (!topic) throw new Error('Usage: node generate-article.mjs "tópico do artigo"');

// Lê guidelines e artigos existentes para contexto
const guidelines = readFileSync('content/GUIDELINES.md', 'utf8');
const existingArticles = readFileSync('content/blog/index.json', 'utf8');

const response = await openai.chat.completions.create({
model: 'gpt-4o',
messages: [
{ role: 'system', content: `Você é redator técnico da ITC Service.
Siga estas diretrizes:
${guidelines}

Artigos existentes para evitar duplicação:
${existingArticles}

Regras:
- Título em formato pergunta
- Mínimo 2.000 palavras
- Inclua código real e exemplos práticos
- CTA relevante ao final
- Tags técnicas específicas
- Tom direto, sem jargões vazios` },
{ role: 'user', content: `Escreva um artigo completo sobre: ${topic}` }
],
temperature: 0.3
});

const article = response.choices[0].message.content;
const slug = topic.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
const filename = `content/blog/${slug}.md`;

writeFileSync(filename, article);
console.log(`✅ Artigo gerado: ${filename}`);
```

**Execução:** `node scripts/generate-article.mjs "como configurar postfix com dkim"`

## Passo 3: Agente Revisor Automático

Antes de abrir PR, o agente revisor valida qualidade:

```javascript
// scripts/review-article.mjs
import { readFileSync } from 'fs';
import OpenAI from 'openai';

const openai = new OpenAI({
baseURL: process.env.AI_GATEWAY_URL,
apiKey: process.env.OPENAI_KEY
});

const filePath = process.argv[2];
const content = readFileSync(filePath, 'utf8');

const review = await openai.chat.completions.create({
model: 'gpt-4o',
messages: [
{ role: 'system', content: `Revise este artigo técnico. Verifique:
1. Precisão técnica (código correto, comandos válidos)
2. Estrutura lógica (fluxo claro, sem saltos)
3. SEO básico (título em pergunta, H2/H3 hierárquicos, tags relevantes)
4. CTA presente e relevante
5. Tom consistente com diretrizes da ITC

Responda em JSON: { approved: boolean, issues: string[], suggestions: string[] }` },
{ role: 'user', content: content }
],
response_format: { type: 'json_object' }
});

const result = JSON.parse(review.choices[0].message.content);
console.log(JSON.stringify(result, null, 2));

if (!result.approved) {
console.error('\n❌ Artigo reprovado. Corrija os issues antes de abrir PR.');
process.exit(1);
} else {
console.log('\n✅ Artigo aprovado pelo revisor automático.');
}
```

Integre no CI como gate obrigatório: PR só mergeia se `review-article.mjs` retornar exit 0.

## Passo 4: Renderização com Astro

Astro é ideal para conteúdo técnico: build estático, suporte nativo a Markdown/MDX, zero JavaScript no cliente por padrão.

```javascript
// astro.config.mjs
import { defineConfig } from 'astro/config';
import cloudflare from '@astrojs/cloudflare';

export default defineConfig({
output: 'server',
adapter: cloudflare(),
markdown: {
remarkPlugins: [],
rehypePlugins: [],
shikiConfig: { theme: 'github-dark' }
}
});
```

Cada artigo vira uma rota automática via `getStaticPaths`. Build time <30s para 50+ artigos.

## Passo 5: Deploy e Feedback Loop

Deploy no Cloudflare Pages via Git push. Analytics nativo ou Plausible para métricas de privacidade.

Configure webhook no Cloudflare Pages → dispara agente de atualização quando artigo tem >30 dias e tráfego decrescente. O agente sugere refresh ou arquivamento.

## Custos do Pipeline

| Componente | Custo Mensal |
|------------|--------------|
| AI Gateway (50k requests) | $0.02 |
| OpenAI GPT-4o (geração + revisão) | $15-30 |
| Cloudflare Pages | $0 (free tier) |
| GitHub Actions | $0 (public repo) ou incluído |
| Domínio + DNS | $10-15/ano |
| **Total** | **$15-35/mês** |

Para 8-12 artigos/mês, custo por artigo ≈ $2-4. Redator humano técnico custa $200-500/artigo. ROI imediato.

## Checklist de Implementação

- [ ] Repositório criado com estrutura de pastas definida
- [ ] Guidelines de conteúdo documentadas (`GUIDELINES.md`)
- [ ] Agente gerador testado com 3+ tópicos reais
- [ ] Agente revisor validando saída do gerador
- [ ] Astro configurado e renderizando artigos localmente
- [ ] CI/CD rodando build + revisão automática
- [ ] Deploy no Cloudflare Pages funcionando
- [ ] Analytics configurado para feedback loop
- [ ] Processo de aprovação humana documentado

## Erros Comuns

1. **Deixar agente publicar direto**: sempre exija PR + revisão humana. Agentes alucinam fatos técnicos.
2. **Não versionar prompts**: mudança de prompt altera estilo sem aviso. Versione junto com o código.
3. **Ignorar frontmatter**: metadata inconsistente quebra listagem e SEO. Valide schema no CI.
4. **Usar modelo caro para tarefas simples**: geração usa GPT-4o, mas revisão pode usar Haiku/Sonnet. Otimize custo.
5. **Não medir qualidade**: track engagement, bounce rate e conversão por artigo. Demita prompts que não performam.

## Como a ITC Service implementa isso

Pipeline completo de conteúdo técnico com agentes IA em 72h: repositório estruturado, agentes gerador e revisor, Astro configurado, CI/CD e deploy. Inclui treinamento para sua equipe operar e evoluir o sistema.

**[Agendar implementação de pipeline de conteúdo →](/contato)**

---

*Tags: markdown, agentes ia, conteúdo técnico, astro, automação, ci-cd*
*CTA: Pipeline de conteúdo com IA*