> ## 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.

# Motor de IA

> Geração, melhoria e chat de conteúdo com IA consciente da marca.

## Visão geral

O Motor de IA Alana é a camada de inteligência por trás das operações de conteúdo de produtos. Ele gera, melhora e refina conteúdo de produtos respeitando as diretrizes da sua marca.

## Capacidades

### Chat (Canvas AI)

O endpoint `/ai/chat` alimenta o Canvas — um assistente de IA interativo que entende o contexto da sua marca e catálogo de produtos. Ele pode:

* Responder perguntas sobre seus produtos
* Sugerir melhorias para descrições
* Gerar variações de conteúdo
* Analisar posicionamento de concorrentes

O endpoint de chat usa **RAG (Retrieval-Augmented Generation)** — ele busca especificações de marca relevantes e dados de produtos antes de gerar uma resposta.

### Gerar

O endpoint `/ai/generate` cria novo conteúdo do zero:

* Descrições de produtos
* Títulos otimizados para SEO
* Pontos de recursos em bullet points
* Copy de marketing

### Melhorar

O endpoint `/ai/enhance` melhora conteúdo existente:

* Corrigir gramática e ortografia
* Melhorar legibilidade
* Adicionar palavras-chave faltantes
* Alinhar com tom da marca

## Como funciona o contexto da marca

```mermaid theme={null}
sequenceDiagram
    participant Client
    participant API
    participant BrandService
    participant AIEngine
    participant LLM

    Client->>API: POST /ai/generate (brandId, prompt)
    API->>BrandService: Load AI specs for brand
    BrandService-->>API: tone, keywords, policies
    API->>AIEngine: Build context-aware prompt
    AIEngine->>LLM: Generate with brand system prompt
    LLM-->>AIEngine: Generated content
    AIEngine-->>Client: Response with content
```

O motor de IA automaticamente:

1. Recupera especificações de IA da marca (tom, palavras-chave, políticas)
2. Busca contexto de produto relevante do catálogo
3. Constrói um prompt de sistema que incorpora todas as diretrizes da marca
4. Envia o prompt enriquecido para o LLM
5. Retorna o conteúdo gerado

## Seleção de modelo

A plataforma usa **LiteLLM** como uma camada de abstração, suportando múltiplos provedores de LLM. Requisições de geração de conteúdo são roteadas com base na complexidade e limites do plano do workspace.

<Info>
  Créditos de IA são rastreados por workspace. Verifique seu uso em **Configurações > Cobrança > Uso** ou via endpoint `/billing/usage`.
</Info>