# Orçamento

O Power Omni oferece ferramentas avançadas na Área de Administração para monitorar e controlar o consumo de tokens de Inteligência Artificial (cobrado diretamente pela Microsoft no seu Azure).

Você pode definir limites de uso para evitar gastos excessivos, tanto a nível geral da organização quanto para entidades específicas (usuários, agentes, grupos e áreas de trabalho).

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FJKv6zBrVmIIS8WiqQw65%2Fimage.png?alt=media&#x26;token=93138fdc-f5bf-40b9-88c4-9516b61ff2c8" alt=""><figcaption></figcaption></figure>

### Visão Geral do Controle de Custos

O controle de custos é acessível no Portal de Administração e permite definir orçamentos mensais, limitando a quantidade de tokens que podem ser consumidos no período.

#### Orçamento Global da Organização

* Configuração Geral: É possível definir um limite de consumo mensal em dólares (USD) para toda a organização.
* Sem Limite: Se o campo de orçamento for deixado vazio ou com valor zero, o consumo da organização será ilimitado (limitado apenas pelo seu plano Azure).

#### Limite por Entidade Específica

Para otimizar e gerenciar o consumo de forma precisa, o Power Omni permite aplicar orçamentos segmentados. Esses orçamentos atuam garantindo um controle específico e detalhado sobre o gasto de tokens por áreas ou indivíduos.

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2Fk3ZBzi0aySNPcMNe64uU%2Fimage.png?alt=media&#x26;token=aa482148-feca-4a00-b3e9-77ee234d601d" alt=""><figcaption></figcaption></figure>

***

### Fluxo de Prioridade e Contabilização

O Power Omni segue um fluxo de hierarquia para determinar o caminho de acesso à IA e aplicar as regras de orçamento.

#### Hierarquia de Acesso (Prioridade)

O sistema prioriza o acesso aos agentes de IA buscando o caminho mais específico, seguindo a ordem de hierarquia abaixo:

1. Usuário → Agente
2. Usuário → Grupo → Agente
3. Usuário → Área de Trabalho → Agente
4. Usuário → Grupo → Área de Trabalho → Agente

A ordem de prioridade é sempre respeitada, mesmo que um ou mais níveis não possuam orçamento definido.\
Se a Organização, Usuário ou Agente possuir orçamento e exceder o limite, o sistema gerará uma falha específica conforme o nível que ultrapassou a cota.

***

#### Contabilização de Uso (Tokens)

* O orçamento refere-se exclusivamente ao consumo de tokens.\
  Funcionalidades com custos adicionais — como os Conectores Fabric, VectorStore e CodeInterpreter — não são contabilizadas no orçamento.
* Cada item (Usuário, Grupo, Área de Trabalho e Agente) tem seu uso contabilizado de forma independente, independente da existência de um orçamento.\
  Essa contabilização de uso ocorre de forma assíncrona, permitindo que as atualizações de consumo dos itens do caminho escolhido ocorram em paralelo, sem bloquear as execuções em andamento.
* Durante a execução, o consumo de tokens é contabilizado individualmente para cada item que compõe o caminho efetivamente utilizado (por exemplo, Usuário, Grupo e Agente).\
  Esses custos de utilização individuais são utilizados para verificar se algum orçamento foi excedido em qualquer nível do caminho percorrido.
* Um caminho de acesso entre o Usuário e o Agente é considerado bloqueado quando um ou mais itens que o compõem possuem orçamento definido e já expirado.\
  Nesses casos, o sistema tentará automaticamente o próximo caminho disponível, seguindo a ordem de prioridade.\
  Se todos os caminhos estiverem bloqueados, o sistema retornará um erro genérico ou específico, dependendo da natureza da falha.

#### Regras de Bloqueio e Tentativa de Próximo Caminho

O sistema monitora cada nível do caminho de acesso e aplica o bloqueio de forma inteligente:

***

> ⚠ <mark style="color:$danger;">Aviso Importante sobre Excedente de Tokens</mark>
>
> <mark style="color:$danger;">Devido à natureza em tempo real da contagem de tokens (que só é finalizada após a conclusão de uma resposta da IA), pode ocorrer um consumo que ultrapasse ligeiramente o limite de orçamento. Isso acontece apenas para garantir a finalização de uma solicitação em andamento, evitando que a conversa seja cortada no meio.</mark>

***

### Configurando um Orçamento

A configuração de orçamentos é realizada na área de administração da ferramenta, permitindo a definição de um valor limite e as ações a serem tomadas ao atingi-lo.

#### Passo a Passo

1. Acesse o Portal de Administração.
2. Navegue até a seção de Orçamentos.
3. Utilize o campo de Limite de Uso Mensal (USD) para definir o orçamento para organização em geral (Não é obrigatorio).
4. Para configurar o orçamento em uma permissão especifica é só clicar no Icone Azul ![](https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2F1TWE70N5xfsB5aCoSQ0I%2Fimage.png?alt=media\&token=8619b7de-a27c-4921-8793-e36d4b3eec03) e selecionar o escopo (Usuário,agente,grupo e Área de trabalho) e o valor limite (USD).

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2F8rOWSUMEUaum6YYfqNQs%2Fimage.png?alt=media&#x26;token=958bfa23-a77e-4426-ba2c-a95bfb3da8c7" alt=""><figcaption></figcaption></figure>

#### Opções ao Atingir o Limite

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2F25pCS4MALkPqN3EYRmZF%2Fimage.png?alt=media&#x26;token=6183ef10-efae-414a-b042-85ae7ba9bbb9" alt=""><figcaption></figcaption></figure>

* Bloqueio Automático: Ao atingir o limite, o usuário receberá uma mensagem de erro logo após tentar enviar uma mensagem, informando que o limite de uso foi atingido. O acesso à funcionalidade de IA é bloqueado automaticamente para a entidade em questão e é restaurado no início do próximo mês.
* Liberação Manual: Caso queira liberar o uso mesmo após ultrapassar o limite, o administrador pode ajustar o orçamento (aumentando a capacidade em USD) diretamente nas configurações de orçamento.

### Visualização e Auditoria

O Power Omni registra o consumo de tokens de forma transparente. Os administradores podem visualizar o consumo acumulado no mês e o percentual em relação ao orçamento definido:

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FZn7OJrGOHUOWCA6EVM9U%2Fimage.png?alt=media&#x26;token=acaabad9-3b52-4384-b288-d17ee0a052de" alt=""><figcaption></figcaption></figure>

* Dashboards: Apresenta o consumo total da organização e o saldo restante do orçamento global.
* Auditoria de Permissões: No menu Auditorias > Visualizar permissões, é possível verificar os possíveis caminhos até um determinado agente e visualizar se há orçamentos e quanto de uso já foi utilizado em entidades específicas como grupos e áreas de trabalho.
* Relatórios Detalhados: É possível auditar o consumo de tokens por usuário, agente, grupo e área de trabalho.
* <mark style="color:$warning;">Reset Mensal: Todos os orçamentos e contadores de uso são resetados automaticamente no primeiro dia de cada mês, iniciando um novo ciclo de controle de gastos.</mark>
