# Usar o Sidekick, o assistente de IA do painel

Pergunta ao Sidekick como correm as vendas, que encomendas faltam enviar ou que produtos estão a acabar, e pede-lhe tarefas como criar um desconto — tudo o que altera a loja espera pela tua aprovação.

O **Sidekick** é um assistente de inteligência artificial que vive dentro do painel da tua loja. Escreves como falarias com um colega — "como correram as vendas esta semana?" — e ele vai buscar a resposta aos dados reais da loja. Também pode fazer trabalho por ti, como criar um código de desconto ou etiquetar clientes, mas **nunca altera nada sem a tua aprovação**.

## Abrir o Sidekick

1. Em qualquer página do painel, carrega no botão **Sidekick** no topo, ao lado do sino das notificações. Também podes usar o atalho Ctrl J.
2. O painel lateral abre à direita. Por baixo da caixa de texto aparecem sugestões de pedidos que mudam conforme a página em que estás (por exemplo, nas encomendas: "Que encomendas estão por enviar?").
3. Escreve o teu pedido e carrega em Enter. As respostas chegam em tempo real; podes carregar em **Parar** a meio.

*(Captura do painel: O botão Sidekick fica no topo do painel, em todas as páginas)*

## O que lhe podes perguntar

O Sidekick lê a tua loja com as mesmas regras do painel. Alguns exemplos do que sabe responder:

- **Vendas e análises:** resumo de vendas por período, comparação com o período anterior, produtos mais vendidos, o que os clientes procuram no site.
- **Encomendas:** procurar encomendas (por pagar, por enviar, de um cliente), abrir e resumir uma encomenda.
- **Produtos e stock:** procurar produtos, ver um produto em detalhe, listar o que tem stock baixo.
- **Clientes:** procurar clientes, resumir um cliente e o que costuma comprar.
- **Descontos, checkouts abandonados, subscrições** e um resumo das definições da loja (por exemplo, que métodos de pagamento estão ativos).

> **Dica — Usa a página em que estás**
> Se abrires o Sidekick dentro de uma encomenda, de um produto ou de um cliente, ele sabe de que página se trata. Basta dizer "resume esta encomenda" ou "melhora a descrição deste produto".

## Pedir tarefas (com aprovação)

O Sidekick também pode **fazer** coisas: criar um desconto, atualizar um produto, ajustar o stock, criar uma coleção, preparar uma campanha de email (fica em rascunho), escrever a descrição de um produto, etiquetar clientes, adicionar uma nota a uma encomenda, criar um rascunho de artigo do blog e criar um fluxo de automação (este só nos planos com fluxos).

1. Pede a tarefa por escrito, por exemplo: "Cria um código de 15 % para este fim de semana".
2. Antes de mexer na loja, o Sidekick mostra um cartão **Precisa da tua aprovação** com o resumo do que vai fazer e os campos que mudam (o valor antigo riscado e o novo ao lado).
3. Lê com atenção. Se estiver certo, carrega em **Aprovar**; se não, carrega em **Recusar** e explica o que queres de outra forma.
4. Depois de aprovada, a alteração fica feita e registada no **Registo de atividade** como feita pelo Sidekick. Se a página aberta mudou, aparece o aviso "Esta página mudou" com a opção **Recarregar para ver**.

> **Importante — O Sidekick pode enganar-se**
> É uma IA: confirma sempre os valores no cartão antes de aprovares, sobretudo preços, percentagens e quantidades de stock.

## Conversas anteriores

- O ícone **Conversas** (relógio) no topo do painel lateral mostra as tuas últimas conversas. Uma conversa com uma ação por aprovar fica assinalada.
- **Nova conversa** começa do zero. Podes apagar conversas que já não queres.
- As conversas são tuas: cada pessoa da equipa vê só as suas.

## Permissões e limites do plano

- O Sidekick só faz o que **tu** podes fazer. Se a tua conta não tem acesso a Marketing, por exemplo, ele também não consegue ver nem criar campanhas.
- Cada plano inclui um número de pedidos de IA por mês, contando o Sidekick e os geradores de texto:

| Plano | Pedidos de IA por mês |
|---|---|
| Essencial | 200 |
| Pro | 2 000 |
| Avançado | 10 000 |

O contador de **Pedidos de IA este mês** aparece no painel do Sidekick. Se chegares ao limite, o Sidekick avisa e sugere **Ver planos** (em **Definições → Plano e faturação**).

## Quando o Sidekick não está disponível

Se vires **A IA não está configurada**, a ligação ao modelo de IA ainda não foi ativada na instalação da Feitora. Não há nada a configurar do teu lado: é a equipa Feitora que a liga.

*(Captura do painel: O painel do Sidekick numa instalação em que a IA ainda não foi ligada)*

> **Em testes — Por validar com conta real**
> O Sidekick usa o Claude, da Anthropic. A ligação segue a documentação oficial, mas só funciona depois de a equipa Feitora configurar a chave da IA no servidor. Em demonstrações pode aparecer a etiqueta **Demonstração**: as respostas são simuladas.

## Problemas frequentes

| Problema | O que fazer |
|---|---|
| "Chegaste ao limite de pedidos de IA deste mês" | Espera pelo mês seguinte ou muda de plano em **Definições → Plano e faturação**. |
| O Sidekick diz que não tem acesso a uma área | A tua conta não tem essa permissão. Pede ao proprietário em **Definições → Utilizadores**. |
| A resposta não está certa | Reformula o pedido com mais pormenores (datas, nomes de produtos) e confirma sempre no painel. |