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:
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
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
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:
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).
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
}
}'
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:
{
"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
}
]
}
}
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.
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.
