> 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/analise-inteligente/configuracao-dos-parametros-da-analise-inteligente.md).

# Configuração dos parâmetros da Análise inteligente

A configuração de parâmetros da **Análise inteligente** permite definir como a funcionalidade se conectará ao provedor de Inteligência Artificial e como as solicitações serão processadas.

Nessa configuração, é possível selecionar o provedor utilizado pela função, definir parâmetros de execução, configurar o uso de raciocínio e personalizar os prompts utilizados pela Análise inteligente.

{% hint style="success" %}
**Importante:** A **Análise Inteligente** é uma funcionalidade adicional, disponibilizada 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 acesso à configuração dos parâmetros está disponível somente para usuários com perfil **Administrador** ou **Suporte** e com a respectiva permissão configurada no menu principal.
{% endhint %}

### Como acessar

Para acessar os parâmetros da Análise inteligente:

1. Acesse **Configurações > Inteligência artificial > Parâmetros**.
2. Selecione a função **Análise inteligente**.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FVqPFoZk8pCuWhzZE25Gl%2Fimage.png?alt=media&amp;token=435e3e04-8605-4e65-9d3a-7df0b3d310f8" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Em ambientes **white label**, a função **Análise inteligente** não é apresentada na tela de parâmetros.
{% endhint %}

### Selecionando o provedor

Na configuração da função **Análise inteligente**, selecione o provedor que será utilizado para realizar as solicitações de Inteligência Artificial.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2Fgo1ySTVjIP6MZG8gz2FD%2Fimage.png?alt=media&amp;token=4a9ea89f-53dc-4f2c-ba78-911d7844fb5b" alt=""><figcaption></figcaption></figure>

O provedor deve estar previamente cadastrado em **Configurações > Inteligência artificial > Provedores**.

Para mais informações, consulte [Broken mention](broken://pages/N7F8CuWDuEXUmCQxxgS6).

Caso não exista um provedor configurado especificamente para a função, será utilizado o **provedor padrão**, quando houver um cadastrado.

### Configurando os parâmetros de execução

| Envio de chamadas                            | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chamadas simultâneas à IA por provedor**   | <p>Define a quantidade máxima de chamadas à Inteligência Artificial que podem permanecer em andamento simultaneamente nesse provedor, considerando as requisições realizadas por todos os usuários da conta.Quando esse limite for atingido, as novas chamadas aguardam a liberação de uma vaga para serem enviadas.</p><p>Essa configuração pode ajudar a evitar que a conta ultrapasse os limites de requisições ou tokens por minuto definidos pelo provedor.</p><p>Informe <strong>0</strong> para não definir um limite.</p>                                                                              |
| **Chamadas simultâneas à IA por requisição** | <p>Define quantas chamadas pertencentes a uma mesma requisição podem permanecer em andamento simultaneamente.</p><p>Uma análise pode gerar várias chamadas à Inteligência Artificial, dependendo da quantidade de componentes selecionados no dashboard.</p><p>Esse limite impede que uma única análise utilize todas as chamadas simultâneas disponíveis para o provedor e faça com que as demais requisições precisem aguardar.</p><p>O valor informado não pode ser maior que o limite definido para as chamadas simultâneas por provedor.</p><p>Informe <strong>0</strong> para não definir um limite.</p> |
| **Intervalo entre os envios à IA**           | <p>Define o tempo de espera entre o envio de duas chamadas pertencentes à mesma requisição.</p><p>Uma análise pode gerar várias chamadas à Inteligência Artificial. A definição de um intervalo ajuda a distribuir esses envios ao longo do tempo e pode reduzir o risco de ultrapassar os limites de requisições por minuto definidos pelo provedor.</p><p>Quando o campo permanecer vazio, será utilizado o valor padrão do sistema, atualmente de <strong>2000 ms</strong>.</p><p>Informe <strong>0</strong> para enviar as chamadas sem intervalo adicional.</p>                                           |

| Tempo limite                                    | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Tempo limite de cada chamada à IA (minutos)** | <p>Define o tempo máximo de espera pela conclusão de uma chamada enviada à Inteligência Artificial.</p><p>Esse valor se aplica individualmente a cada chamada, e não à duração total da análise.</p><p>Uma análise pode realizar várias chamadas, como chamadas relacionadas aos componentes do dashboard e uma chamada adicional para consolidação das informações. Por esse motivo, o tempo total da análise pode ser maior que o valor configurado nesse campo.</p><p>Informe <strong>0</strong> para utilizar o valor padrão do sistema, atualmente de <strong>5 minutos</strong>.</p> |
| **Tempo limite de conexão**                     | <p>Define o tempo máximo para estabelecer uma conexão com o provedor de Inteligência Artificial.</p><p>Esse parâmetro se aplica somente ao processo de conexão.</p><p>Informe <strong>0</strong> para utilizar o valor padrão do sistema, atualmente de <strong>3 segundos</strong>.</p>                                                                                                                                                                                                                                                                                                   |

| Tokens                                    | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Limite de tokens por chamada à IA**     | <p>Define a quantidade máxima estimada de tokens que uma chamada à Inteligência Artificial pode utilizar.</p><p>Cada componente selecionado no dashboard pode gerar uma chamada. Quando o conteúdo estimado ultrapassar o limite configurado, o componente correspondente não será incluído na análise.</p><p>O sistema estima a quantidade de tokens a partir do conteúdo que será enviado.<br>Quando o campo permanecer vazio, será utilizado o limite padrão do sistema, atualmente de <strong>8000 tokens</strong>.</p>                                                                                                                                                                                                                                                    |
| **Margem de segurança da estimativa (%)** | <p>Define o percentual acrescentado à estimativa de tokens antes de compará-la com o limite configurado.</p><p>A quantidade de tokens é estimada e pode não corresponder exatamente à quantidade utilizada pelo modelo, pois cada modelo utiliza seu próprio mecanismo de tokenização. A margem de segurança ajuda a compensar essa imprecisão e reduz o risco de uma chamada ser enviada e recusada pelo provedor por ultrapassar o limite disponível.</p><p>Quanto maior for a margem configurada, mais conservadora será a seleção dos componentes para a análise, o que pode fazer com que mais componentes sejam recusados antes do envio da solicitação.</p><p>Ao informar <strong>0</strong>, será utilizado o valor padrão do sistema, que é <strong>60%</strong>.</p> |
| **Limite de tokens de saída por chamada** | <p>Define a quantidade máxima de tokens que a Inteligência Artificial poderá gerar em uma chamada, considerando a resposta e, quando aplicável, o conteúdo relacionado ao raciocínio.</p><p>A disponibilidade e o comportamento desse parâmetro podem depender do provedor e do modelo utilizado.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |

| Repetição em caso de falha                 | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Tentativas adicionais por chamada à IA** | <p>Define quantas vezes uma chamada poderá ser repetida após uma falha transitória.</p><p>São repetidas apenas falhas que podem ser resolvidas em uma nova tentativa, como:</p><ul><li>indisponibilidade temporária;</li><li>falhas de rede;</li><li>limite temporário do provedor.</li></ul><p>Erros de configuração não são repetidos automaticamente.</p><p>A espera entre as tentativas aumenta progressivamente. Por esse motivo, valores elevados podem aumentar significativamente o tempo total de execução da análise.</p><p>Quando o valor for <strong>0</strong>, a chamada não será repetida após uma falha.</p> |
| **Espera antes da 1ª nova tentativa (ms)** | <p>Define o tempo de espera antes de repetir uma chamada que apresentou falha.</p><p>A espera aumenta a cada nova tentativa.</p><p>Por exemplo, dependendo das configurações definidas, as esperas podem aumentar progressivamente, como:</p><p><strong>1 s → 2 s → 4 s</strong></p><p>Esse comportamento permite aguardar uma possível normalização do serviço antes de realizar uma nova chamada.</p><p>Quando o campo permanecer vazio, será utilizado o valor padrão do sistema, atualmente de <strong>1000 ms</strong>.</p>                                                                                             |
| **Espera máxima entre tentativas (ms)**    | <p>Define o limite máximo de espera entre duas tentativas.</p><p>Como a espera aumenta progressivamente após cada falha, esse limite impede que o tempo entre as tentativas continue crescendo indefinidamente.</p><p>O valor informado não pode ser menor que a espera definida para a primeira nova tentativa.</p><p>Quando o campo permanecer vazio, será utilizado o valor padrão do sistema, atualmente de <strong>16000 ms</strong>.</p>                                                                                                                                                                               |
| **Variação aletória de espera (ms)**       | <p>Define uma variação adicional aplicada ao tempo de espera antes das novas tentativas.</p><p>Essa configuração evita que várias chamadas que apresentaram falha no mesmo momento sejam reenviadas novamente exatamente ao mesmo tempo.</p><p>Sem essa variação, várias chamadas podem receber novamente um erro de limite simultaneamente.</p><p>Quando o valor for <strong>0</strong>, não será aplicada nenhuma variação ao tempo de espera.</p>                                                                                                                                                                         |

### Personalizando os prompts

Os prompts padrão utilizados pela **Análise inteligente** acompanham o idioma da sessão.

A personalização dos prompts deve ser utilizada somente quando houver uma necessidade específica de orientar a resposta gerada pela Inteligência Artificial.

Para personalizar um prompt:

1. Marque a opção **Sobrescrever o texto padrão**.
2. Informe o texto desejado no campo de personalização.
3. Utilize a opção **Sugerir texto padrão**, quando necessário, para inserir uma sugestão fornecida pelo sistema.
4. Caso já exista um texto preenchido, confirme a substituição para trocar o conteúdo atual pelo texto sugerido.
5. Clique em **Salvar** antes de executar uma nova análise.

{% hint style="warning" %}
A personalização dos prompts pode alterar a forma como a Inteligência Artificial interpreta e responde às informações enviadas pela Análise inteligente. Por esse motivo, essa configuração deve ser utilizada somente quando houver uma necessidade específica.
{% endhint %}

**Descrição dos campos:**

| Campo                                    | Descrição                                                                                                                                             | Quando habilitado                                                                                                                                                                                                                                                                                                                                                             | Quando desabilitado                                                                               |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| **Prompt da análise de cada componente** | Define a instrução utilizada pela Inteligência Artificial para orientar a análise individual de cada componente selecionado no dashboard.             | -                                                                                                                                                                                                                                                                                                                                                                             | -                                                                                                 |
| **Sobrescrever o texto padrão**          | <p>Permite substituir a especialização padrão aplicada pelo sistema na análise de cada componente do dashboard por um texto personalizado.</p><p></p> | <p>A Análise inteligente utiliza o conteúdo informado no campo. Se o campo permanecer em branco, nenhuma especialização será aplicada. <br><strong>Obs:</strong> Como esse texto é utilizado durante a análise de cada componente do dashboard, quanto maior for o conteúdo informado, maior poderá ser o consumo de tokens quando a análise envolver vários componentes.</p> | A Análise inteligente utiliza a especialização padrão definida pelo sistema.                      |
| **Sugerir texto padrão**                 | Permite inserir no campo uma sugestão de texto padrão fornecida pelo sistema.                                                                         | Disponível para utilização quando a opção **Sobrescrever o texto padrão** estiver habilitada. Ao utilizá-la, o conteúdo existente poderá ser substituído pelo texto sugerido pelo sistema.                                                                                                                                                                                    | Não fica disponível, pois o campo utiliza o texto padrão do sistema e não permite personalização. |

| Campo                                   | Descrição                                                                                                                                          | Quando habilitado                                                                                                                                                                                 | Quando desabilitado                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Prompt do relatório executivo final** | Define a instrução utilizada pela Inteligência Artificial para orientar a geração do relatório executivo final da Análise inteligente.             | -                                                                                                                                                                                                 | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **Sobrescrever o texto padrão**         | Permite substituir o texto padrão utilizado pelo sistema para orientar a geração do relatório executivo final por um texto personalizado.          | A Análise inteligente utiliza o conteúdo informado no campo para orientar a geração do relatório executivo final. Se o campo permanecer em branco, nenhuma instrução personalizada será aplicada. | A Análise inteligente utiliza o texto padrão definido pelo sistema para orientar a geração do relatório executivo final.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **Sugerir texto padrão**                | Permite inserir no campo uma sugestão de texto padrão fornecida pelo sistema.                                                                      | A opção fica disponível e permite substituir o conteúdo do campo pelo texto sugerido pelo sistema. Caso já exista um texto preenchido, a substituição deverá ser confirmada.                      | A opção não fica disponível, pois não há personalização do texto enquanto o sistema utiliza a configuração padrão.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Armazenar o raciocínio da IA            | Define se o raciocínio retornado pela Inteligência Artificial será armazenado e disponibilizado para consulta no **Histórico das análises de IA**. | O raciocínio retornado pela Inteligência Artificial será armazenado junto à análise e poderá ser consultado posteriormente no histórico.                                                          | <p>O raciocínio poderá ser apresentado ao usuário imediatamente após a execução da análise, quando o modelo oferecer suporte a esse recurso, mas <strong>não será armazenado nem disponibilizado posteriormente no histórico das análises</strong>.</p><p>Essa opção pode ser utilizada para evitar o armazenamento de conteúdos de raciocínio que não precisam ser consultados posteriormente, reduzindo a quantidade de informações armazenadas no banco de dados.<br><strong>Obs:</strong> A disponibilidade do raciocínio depende da compatibilidade do modelo de Inteligência Artificial utilizado.</p> |

#### **Orientando a resposta da análise em espanhol**

Quando for necessário receber os resultados da **Análise inteligente** em espanhol, a orientação da resposta deve considerar o idioma da sessão, os prompts personalizados e uma instrução explícita no contexto da análise.

Para configurar a utilização em espanhol:

1. Configure o Weknow client e o Weknow server para utilizar o idioma **espanhol**.
2. Acesse **Configurações > Inteligência artificial > Parâmetros**.
3. Selecione a função **Análise inteligente**.
4. Nos prompts aplicáveis, como **Prompt da análise de cada componente** e **Prompt do relatório executivo final**, marque a opção **Sobrescrever o texto padrão**.
5. Informe as instruções personalizadas em espanhol.
6. Salve as configurações.
7. No dashboard, abra a **Análise inteligente**.
8. No campo **Contexto adicional**, informe uma instrução explícita solicitando que o resultado seja apresentado em espanhol.

Por exemplo:

> Mostrar el resultado del análisis en español.

9. Selecione os componentes desejados e execute a análise.

{% hint style="warning" %}
**Atenção:**&#x20;

* A utilização da interface em espanhol, por si só, não substitui a orientação enviada à Inteligência Artificial.
* Para reforçar que a resposta seja gerada em espanhol, mantenha os prompts personalizados nesse idioma e informe uma solicitação explícita no campo **Contexto adicional** sempre que necessário.
  {% endhint %}

#### Próximos passos

Após configurar os parâmetros da **Análise inteligente**, defina os limites de utilização disponíveis para os usuários.

Consulte o artigo [Broken mention](broken://pages/FSdFf3ghSLl0WY7dB9dS)

Depois disso, os usuários que possuírem as permissões necessárias poderão utilizar a funcionalidade conforme as configurações definidas.
