> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alana.shopping/llms.txt
> Use this file to discover all available pages before exploring further.

# Geração de Conteúdo com IA

> Gere, melhore e refine conteúdo de produtos usando IA consciente da marca.

## Configurando especificações de IA

Antes de gerar conteúdo, configure as especificações de IA da sua marca. Isso garante que toda saída de IA corresponda à voz da sua marca.

Navegue até **Marcas > \[Sua Marca] > Especificações de IA** no dashboard, ou use a API:

```bash theme={null}
curl -X PATCH ".../brands/{brandId}/ai-specs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tone_of_voice": "Profissional mas acessível. Use voz ativa.",
    "target_audience": "Millennials conscientes de moda, 25-40",
    "keywords_always": ["sustentável", "premium", "artesanal"],
    "keywords_never": ["barato", "básico", "genérico"],
    "content_policies": "Nunca mencionar marcas concorrentes. Sempre destacar sustentabilidade.",
    "custom_instructions": "Incluir instruções de cuidado ao descrever tecidos."
  }'
```

## Gerando conteúdo

### Novas descrições de produtos

```bash theme={null}
curl -X POST "https://app.alana.shopping/api/ai/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brandId": "BRAND_ID",
    "type": "description",
    "context": {
      "productTitle": "Blazer de Linho Orgânico",
      "category": "Vestuário > Roupas Externas > Blazers",
      "attributes": {"material": "100% linho orgânico", "color": "Azul Marinho"}
    }
  }'
```

### Melhorando conteúdo existente

```bash theme={null}
curl -X POST "https://app.alana.shopping/api/ai/enhance" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brandId": "BRAND_ID",
    "text": "Blazer azul marinho feito de linho. Bom para escritório.",
    "type": "description",
    "instructions": "Torne mais atraente e adicione mensagem de sustentabilidade"
  }'
```

### Chat interativo (Canvas)

O chat Canvas AI fornece uma interface conversacional para operações de conteúdo:

```bash theme={null}
curl -X POST "https://app.alana.shopping/api/ai/chat" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brandId": "BRAND_ID",
    "messages": [
      {"role": "user", "content": "Escreva 3 variações de título para nosso blazer de linho orgânico"}
    ]
  }'
```

### Gerando FAQs de alta confiança

A action `faq` dedicada (Phase 185) produz de 5 a 10 perguntas frequentes específicas do produto, com categoria e score de confiança por pergunta. A API faz post-filter mantendo apenas itens com `confidence >= 0.7`; o prompt proíbe explicitamente perguntas sobre cor/tamanho/disponibilidade/preço (esses dados vivem em campos estruturados).

```bash theme={null}
curl -X POST "https://app.alana.shopping/api/ai/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "faq",
    "workspaceId": "WORKSPACE_ID",
    "model": "balanced",
    "productContext": {
      "id": "PROD_123",
      "name": "Blazer de Linho Orgânico",
      "brand": "Alana",
      "description": "Blazer alfaiataria em linho 100% orgânico, cor marinho, abotoamento simples.",
      "price": 489
    }
  }'
```

O parâmetro `model` aceita `"economic"`, `"balanced"` ou `"high"` e mapeia pro alias de tier do LiteLLM (`canvas-faq-eco` / `canvas-faq-bal` / `canvas-faq-hi`). Tiers maiores usam modelos mais fortes — útil quando a resposta vem 400 com menos de 5 FAQs de alta confiança.

Shape da resposta:

```json theme={null}
{
  "success": true,
  "action": "faq",
  "data": {
    "faqs": [
      {
        "question": "Posso lavar este blazer na máquina?",
        "answer": "Não recomendamos. Linho é um tecido delicado — prefira lavagem a seco ou à mão com água fria.",
        "category": "cuidado",
        "confidence": 0.94
      },
      {
        "question": "Como é o caimento?",
        "answer": "Modelagem alfaiataria com leve estrutura nos ombros, caimento solto no torso. Veste no tamanho usual.",
        "category": "tamanho",
        "confidence": 0.88
      }
    ]
  }
}
```

Categorias: `uso`, `cuidado`, `tamanho`, `envio`, `trocas`, `material`, `estilo`, `outro`. A rota retorna 400 se sobrarem menos de 5 FAQs de alta confiança — adicione `"model": "high"` ao body da requisição ou inclua mais detalhe do produto no `productContext`.

## Uso de créditos de IA

Operações de IA consomem créditos baseados no plano do seu workspace. Monitore o uso via dashboard de cobrança ou API.

<Warning>
  Créditos de IA resetam mensalmente. Se você exceder o limite do seu plano, operações de IA serão limitadas até o próximo ciclo de cobrança.
</Warning>