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

# Consumo de IA

> Acompanhe o consumo mensal de IA, defina limites por empresa e por pessoa e bloqueie o acesso quando necessário.

<Warning>
  **Acesso restrito.** Acompanhar o consumo é possível para **Administradores** e **Master**. **Alterar limites e bloquear o acesso** é exclusivo do perfil **Master**.
</Warning>

## O que é

O controle de consumo evita surpresas na conta de IA da empresa. Cada pessoa tem um **limite mensal de gasto com IA**. Quando o limite acaba, a IA para de responder para aquela pessoa até o mês seguinte, ou até alguém da administração aumentar o limite.

Com ele você pode:

* **Acompanhar** quanto cada pessoa já usou no mês.
* **Definir** o limite padrão da empresa e limites diferentes para quem precisa de mais (ou de menos).
* **Bloquear** o acesso à IA de uma pessoa, quando necessário.

## Como funciona o limite

| Regra | Como é |
| - | - |
| **Unidade do limite** | Valor em **dólares (US\$)** por mês, calculado a partir do preço de cada modelo usado. |
| **Limite padrão** | Toda pessoa recebe o **limite mensal padrão por usuário** da empresa. Se a empresa não tiver um padrão definido, vale **US\$ 20,00**. |
| **Limite individual** | Uma pessoa pode ter um limite próprio, maior ou menor que o padrão. |
| **Renovação** | Automática, no **primeiro dia de cada mês**. O consumo volta a zero. |
| **Aviso ao usuário** | A partir de **85%** do limite, a pessoa vê um aviso no chat. |
| **Limite atingido** | Ao chegar a **100%**, a IA para de responder para a pessoa. Nada é cobrado a mais. |
| **Bloqueio** | Independente do limite. Uma pessoa bloqueada não usa a IA até ser desbloqueada, mesmo com saldo. |

<Tip>
  **O que a pessoa vê:** o usuário acompanha o próprio consumo em **Configurações → Uso**, em **porcentagem do limite** e em tokens, sem os valores em dinheiro. Veja [Configurações da conta](/guia/configuracoes).
</Tip>

<Note>
  O consumo só é calculado para modelos com **preço configurado** em **Configurações → Modelos**. O uso de um modelo sem preço não conta para o limite.
</Note>

## Como acessar

<Steps>
  <Step title="Abra o Painel Admin">
    Menu do usuário → **Painel Admin**.
  </Step>

  <Step title="Em Gerenciamento, clique em Usuários" />
</Steps>

## Acompanhar o consumo de todos

Na lista de **Usuários**, a coluna **Consumo / Limite** mostra, para cada pessoa:

* os **tokens** usados no mês e, com a permissão de ver custos, o **valor** gasto;
* a **porcentagem** do limite já usada;
* uma etiqueta de situação:

| Etiqueta | Significado |
| - | - |
| **Dentro do limite** | Menos de 80% do limite usado. |
| **Próximo do limite** | Entre 80% e 100%. Vale acompanhar. |
| **Limite atingido** | 100% ou mais. A pessoa não consegue usar a IA até a renovação. |

No topo da lista aparecem também o **Total de tokens no mês** e, com a permissão de ver custos, o **Custo no mês** da empresa.

## Acompanhar o consumo de uma pessoa

Clique na linha da pessoa para abrir o detalhe. Lá você vê:

* **Consumo mensal** — quanto do limite já foi usado e quando renova.
* **Uso ao longo do tempo** — gráfico do período escolhido.
* **Consumo de IA** — os modelos e agentes que a pessoa mais usou.
* **Atividade do usuário** — as conversas e as execuções de IA da pessoa.

## Definir o limite padrão da empresa *(Master)*

<Steps>
  <Step title="Acesse Plataforma → Empresas no Painel Admin" />

  <Step title="Abra a empresa e vá à aba Licença" />

  <Step title="Preencha Limite mensal padrão por usuário">
    Com um valor maior que zero.
  </Step>

  <Step title="Salve" />
</Steps>

O novo padrão vale para todas as pessoas da empresa que **não** têm limite individual.

## Definir um limite individual *(Master)*

<Steps>
  <Step title="Abra o detalhe da pessoa">
    **Gerenciamento → Usuários** → clique na linha.
  </Step>

  <Step title="No cartão Consumo mensal, clique na engrenagem (Controles de consumo)" />

  <Step title="Em Limite mensal, digite o valor em dólares">
    Ex.: `50` ou `10,50`.

    * Para voltar ao padrão da empresa, **apague o valor** e deixe o campo vazio.
    * O padrão atual aparece ao passar o mouse no ícone de informação ao lado do campo.
  </Step>

  <Step title="Clique em Salvar" />
</Steps>

<Note>
  Um limite de **0** não permite nenhum uso de IA. Para suspender o acesso de alguém, prefira o **bloqueio**: ele deixa claro para a pessoa que o acesso foi suspenso pela administração.
</Note>

## Bloquear e desbloquear o acesso à IA *(Master)*

**Para bloquear:**

<Steps>
  <Step title="Abra o detalhe da pessoa e clique na engrenagem do cartão Consumo mensal" />

  <Step title="Em Acesso à IA, clique em Bloquear consumo" />

  <Step title="Confirme">
    A pessoa vê no chat o aviso **"Um administrador bloqueou seu acesso à IA"**.
  </Step>
</Steps>

**Para desbloquear:** no detalhe da pessoa, o cartão mostra **Consumo bloqueado**. Clique em **Desbloquear**.

O bloqueio não apaga nada: conversas, agentes, bases e configurações da pessoa continuam lá.

## Boas práticas

* **Defina um padrão realista** para a empresa e use limites individuais só para exceções, como quem trabalha com documentos grandes ou fluxos automáticos.
* **Acompanhe a etiqueta "Próximo do limite"** para agir antes que alguém fique sem acesso no meio de uma tarefa importante.
* **Confira o preço dos modelos** em **Configurações → Modelos**. Sem preço, o uso não entra no limite.
* **Prefira o bloqueio ao limite zero** para suspender alguém: a mensagem para a pessoa fica mais clara.
* **Contas técnicas** usadas em integrações e fluxos automáticos podem precisar de um limite próprio.

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Um usuário diz que a IA parou de responder.">
    Abra o detalhe dele e veja o **Consumo mensal**. Se o limite foi atingido, aumente o **Limite mensal** (perfil Master) ou aguarde a renovação no dia 1º. Se aparecer **Consumo bloqueado**, clique em **Desbloquear**.
  </Accordion>

  <Accordion title="Aumentei o limite. Quando a pessoa volta a usar?">
    Na hora. Se o aviso de limite ainda aparecer no chat, peça para a pessoa atualizar a página.
  </Accordion>

  <Accordion title="Sou Administrador e não vejo a engrenagem de controles.">
    Alterar limites e bloquear é exclusivo do perfil **Master**. Peça ao responsável pela plataforma.
  </Accordion>

  <Accordion title="Por que não vejo os valores em dólar?">
    A sua empresa não tem a permissão de **ver custos** no Painel Admin. Sem ela, você vê tokens e porcentagens.
  </Accordion>

  <Accordion title="O consumo dos fluxos conta no limite?">
    Sim. Cada etapa de agente de um fluxo conta no consumo de quem executou o fluxo, como uma mensagem no chat.
  </Accordion>

  <Accordion title="O limite é por mês corrido ou a partir da data de cadastro?">
    Por mês do calendário. Todos os limites renovam no primeiro dia de cada mês.
  </Accordion>
</AccordionGroup>

## Limitações conhecidas

* O limite é sempre **mensal** e em **dólares**. Não há limite por dia ou por quantidade de tokens.
* Não é possível definir "sem limite" pela tela: toda pessoa tem o limite padrão ou um limite individual.
* Alterar limites e bloquear é exclusivo do perfil **Master**.
* Os valores dependem do **preço configurado** em cada modelo.
* O usuário vê o próprio consumo em porcentagem, nunca em dinheiro.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.