Acompanhar os custos da IA

A IA de indexação lê o texto do OCR de um documento e sugere o tipo documental e o preenchimento da ficha. Ela ajuda muito o indexador, mas cada pedido custa alguns centavos, cobrados pelo provedor da IA em dólar. A página Custos da IA, no menu Configurações, mostra quanto isso está saindo, prefeitura por prefeitura, para nenhuma surpresa aparecer na fatura do cartão.

Como a IA gasta#

Antes de olhar os números, vale lembrar as regras que já seguram o gasto:

• Só sob demanda. A IA roda quando o indexador clica para pedir a sugestão, nunca sozinha depois do processamento. Documento que ninguém pediu não custa nada.
• Só onde foi autorizada. A IA só funciona nas prefeituras com IA de indexação ligada no cadastro, o que depende de autorização em contrato (LGPD).
• Nunca sigilosos nem saúde. Documentos sigilosos e classes de saúde nunca são enviados, nem pagos.
• Teto mensal. Cada prefeitura tem um Teto mensal da IA (R$) (padrão de R$ 50). Ao atingir o teto, a IA pausa naquela prefeitura até o mês seguinte, e o indexador vê o aviso "O teto mensal de custo da IA desta prefeitura foi atingido." A indexação manual continua normalmente.

O custo de cada pedido é calculado na hora: tokens usados × preço por milhão de tokens × cotação do dólar, todos informados em Plataforma e integrações, no card IA de indexação.

Ler o relatório#

1. No menu Configurações, abra Custos da IA.
2. Escolha o Mês. A página abre no mês atual.

A tabela Por prefeitura mostra as prefeituras com IA ligada ou que tiveram uso no mês:

Coluna	O que é
Prefeitura	O cliente.
IA	ligada ou desligada hoje no cadastro.
Pedidos	Quantas sugestões foram pedidas no mês.
Falhas	Pedidos que não deram certo (o provedor não respondeu, por exemplo).
Tokens	Entrada e saída somadas, a "matéria-prima" do preço.
Custo	O valor em reais no mês.
Teto	O teto mensal da prefeitura.
Uso do teto	O custo como percentual do teto. Fica laranja a partir de 80% e vermelho ao chegar a 100%.

Na última linha, o Total do mês somando todas as prefeituras.

O que fazer com os números#

• Uso do teto chegando a 80% no meio do mês: converse com a supervisão da operação. Pode ser um acervo de manuscritos (mais caro) ou o modelo avançado ligado sem necessidade.
• Muitas falhas: confira a configuração do provedor em Integrações e se a chave da API continua válida.
• Prefeitura com IA ligada e zero pedidos: a equipe talvez não saiba que pode pedir sugestão. Vale um lembrete no treinamento (veja Indexação).

Para mudar o teto ou ligar e desligar o modelo avançado, edite a prefeitura em Clientes > Prefeituras (veja Cadastrar e configurar uma prefeitura). A mudança vale na hora.