> For the complete documentation index, see [llms.txt](https://wedocs.gitbook.io/wedocs-5.2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wedocs.gitbook.io/wedocs-5.2/inteligencia-artificial/configuracoes-de-inteligencia-artificial/limite-de-uso-das-funcoes-de-ia.md).

# Limite de uso das funções de IA

O recurso **Limite de uso** permite controlar a quantidade de utilizações das funções de Inteligência Artificial disponíveis no Weknow.

Por meio dessa configuração, é possível definir limites de utilização para diferentes funções de IA, grupos e usuários, acompanhar o consumo e controlar a disponibilidade dos recursos de acordo com as regras estabelecidas pela organização.

{% hint style="success" %}
**Importante:** As funcionalidades integradas à Inteligência Artificial (IA) são disponibilizadas como recurso adicional, mediante contratação específica. Para consultar as condições comerciais, entre em contato com nossa equipe pelo artigo [Conheça os recursos de Inteligência Artificial](/wedocs-5.2/inteligencia-artificial/conheca-os-recursos-de-inteligencia-artificial.md).
{% endhint %}

{% hint style="warning" %}
O limite de uso controla a quantidade de utilizações das funções de IA. A utilização de cada função também depende das respectivas permissões e demais configurações de IA do ambiente.
{% endhint %}

***

### Como acessar

Para acessar a configuração dos limites de utilização:

1. Acesse **Administração > Inteligência Artificial > Limite de uso**

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FoGJqnmkNloiAoCqyKQub%2Fimage.png?alt=media&amp;token=dcb550e0-5cda-40c4-ae31-729035fffa5e" alt=""><figcaption><p>Tela de concfiguração dos limites de uso das funções de IA</p></figcaption></figure>

{% hint style="warning" %}
**Atenção:**

* A tela está disponível somente para usuários que possuem permissão para acessar esse recurso.
* Antes de configurar os limites, verifique se os recursos de Inteligência Artificial estão habilitados para o ambiente.
  {% endhint %}

***

### Conhecendo a tela

A tela **Limite de uso** é composta por duas áreas principais:

* **Funções de IA:** apresenta as funções de Inteligência Artificial disponíveis para configuração dos limites.
* **Tabela de configurações:** apresenta os grupos e usuários e permite definir e acompanhar os limites da função selecionada.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FzG1mUASErD73FiZixPBH%2Fimage.png?alt=media&amp;token=56803e37-eba7-4572-9254-52cd9ae551d6" alt=""><figcaption><p>Tela Limite de uso de funções de IA.</p></figcaption></figure>

#### Níveis de configuração

Após selecionar uma função de IA, os limites podem ser configurados de acordo com os seguintes níveis:

| Nível       | Descrição                                                                                                                                                                                                 |
| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Todos**   | Define o limite mensal padrão aplicado aos usuários que não possuem uma configuração mais específica. Esse campo é obrigatório. Quando permanecer vazio, o sistema atribui automaticamente o valor **0**. |
| **Grupo**   | Define um limite específico para os usuários pertencentes a um determinado grupo. Quando permanecer vazio, será utilizado o limite definido no nível superior.                                            |
| **Usuário** | Define um limite específico para determinado usuário. Quando configurado, esse valor terá prioridade sobre os demais níveis.                                                                              |

***

#### Como funciona a prioridade dos limites

Quando houver configurações em mais de um nível, o sistema utilizará a seguinte ordem de prioridade:

1. Limite configurado para o **Usuário**.
2. Maior limite entre os **Grupos** aos quais o usuário pertence.
3. Limite configurado em **Todos**.

{% hint style="warning" %}
Quando um usuário pertence a mais de um grupo, será considerado o **maior limite** configurado entre esses grupos.
{% endhint %}

***

#### Exemplo

Considere que uma determinada função de IA possua as seguintes configurações:

* **Todos:** 100 utilizações por usuário por mês;
* **Grupo:** 150 utilizações por usuário por mês;
* **Usuário:** 200 utilizações por usuário por mês.

Para um usuário que possui um limite configurado individualmente, será considerado o limite definido para o **Usuário**.

Para um usuário sem configuração individual que pertença ao grupo configurado, será considerado o limite definido para o **Grupo**.

Para um usuário sem configuração individual ou de grupo, será considerado o limite definido em **Todos**.

Quando o usuário pertencer a mais de um grupo com limites diferentes, será considerado o maior limite configurado entre esses grupos.

***

### Configurando os limites

É possível configurar limites específicos para funções como **Análise Inteligente** e **Weknow Ask**, conforme as funções disponíveis no ambiente.

Para configurar um limite:

1. Selecione a **função de IA** para a qual deseja definir o limite.
2. Na tabela, localize o nível de configuração que deseja utilizar.
3. Informe o **Limite uso por usuário por mês**.
4. Clique em **Salvar**.

O limite pode ser configurado nos níveis **Todos**, **Grupo** ou **Usuário**.

Nos níveis **Grupo** e **Usuário**, deixar o campo vazio significa que não existe uma configuração própria. Nesse caso, será utilizado o limite definido no nível superior.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2F3t4qRNWWllnzxlVLRiIp%2Faplica%C3%A7%C3%A3o%20regra%20uso%20IA.gif?alt=media&amp;token=40fd9078-ae9b-41dd-90d2-803dea6c0e97" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
O valor **0** (zero) representa um limite configurado. Portanto, ele impede que o usuário utilize o limite herdado do grupo ou da configuração **Todos**.
{% endhint %}

***

### Significado das colunas

A tabela apresenta as seguintes informações:

| Coluna                                | Descrição                                                                                                                                      |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Descrição**                         | Identifica a configuração geral, o grupo ou o usuário.                                                                                         |
| **Código**                            | Apresenta o código do grupo ou usuário.                                                                                                        |
| **Limite de uso por usuário por mês** | Define a quantidade máxima de utilizações permitidas para cada usuário durante o mês.                                                          |
| **Quantidade extra neste mês**        | Apresenta a quantidade adicional de utilizações liberadas para o usuário exclusivamente no mês atual.                                          |
| **Limite efetivo neste mês**          | Apresenta o total de utilizações disponíveis para o usuário no mês corrente, considerando o limite configurado e a quantidade extra concedida. |
| **Quantidade utilizada neste mês**    | Informa quantas utilizações das funções de IA já foram consumidas pelo usuário durante o mês atual.                                            |

As colunas **Quantidade extra neste mês**, **Limite efetivo neste mês** e **Quantidade utilizada neste mês** são apresentadas somente nas linhas de usuários.

***

### Como funciona o consumo das utilizações

Cada utilização concluída com sucesso de uma função de IA consome uma utilização, conforme a regra definida para a função.

Após a conclusão da utilização, o sistema incrementa automaticamente a **Quantidade utilizada neste mês**.

Caso a utilização não seja concluída **com sucesso**, nenhuma utilização será consumida.

A **Quantidade utilizada neste mês** e a **Quantidade extra neste mês** consideram somente o mês corrente.

{% hint style="warning" %}
As funções de IA podem apresentar ao usuário a quantidade de utilizações restantes, quando aplicável. Essa informação considera o limite efetivo disponível para o usuário.
{% endhint %}

***

### Quando o limite é atingido

Quando a quantidade utilizada atingir o **Limite efetivo neste mês**, novas utilizações da função de IA não poderão ser executadas.

Por exemplo, quando o limite de uma função de IA for atingido, não será possível realizar novas utilizações dessa função até que exista uma nova quantidade disponível.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2F9gxFeehBDGN2XPA0rKZI%2Fimage.png?alt=media&amp;token=11d430f7-384c-40f0-9b26-93270c722926" alt=""><figcaption></figcaption></figure>

***

### Acompanhamento da utilização

A tela permite consultar informações sobre as utilizações realizadas.

Os registros de utilização permitem acompanhar o consumo das funções de IA pelos usuários.

Os registros são apresentados em ordem decrescente, com as utilizações mais recentes primeiro.

A pesquisa pode ser utilizada para localizar registros específicos.

{% hint style="danger" %}
**Importante:** Os registros do histórico de uso gerados antes das alterações introduzidas na versão **5.3** da funcionalidade de Inteligência Artificial não estão disponíveis para consulta nas telas atuais do sistema.

Caso seja necessário consultar essas informações, entre em contato com a equipe da Weknow pelo endereço de e-mail: **<contato@weknowhealthtech.com.br>**
{% endhint %}

***

### Boas práticas

Durante a configuração dos limites, recomenda-se:

* definir um limite padrão adequado no nível **Todos**;
* utilizar grupos para facilitar a administração dos usuários;
* configurar limites individuais somente quando necessário;
* revisar periodicamente a quantidade de utilizações consumidas;
* utilizar **quantidades extras** quando houver necessidade de ampliar temporariamente o limite de um usuário.

Uma configuração adequada dos limites facilita o gerenciamento das funções de IA e contribui para uma distribuição equilibrada das utilizações entre os usuários.

***

#### Próximo passo

Depois de definir os limites de utilização, configure as permissões necessárias para que os usuários possam acessar e utilizar as funções de Inteligência Artificial.

Consulte [Limite de uso das funções de IA](/wedocs-5.2/inteligencia-artificial/configuracoes-de-inteligencia-artificial/limite-de-uso-das-funcoes-de-ia.md).