> 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/configuracao-de-provedores-de-ia.md).

# Configuração de provedores de IA

O Weknow permite configurar provedores de Inteligência Artificial que serão utilizados pelas funcionalidades de IA da plataforma.

Na configuração do provedor são definidas as credenciais de acesso, o provedor e o modelo de Inteligência Artificial que serão utilizados pelas funções de IA. **O modelo selecionado deve ser compatível com a funcionalidade que utilizará o provedor.**

{% 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 acesso ao cadastro de provedores está disponível somente para usuários com perfil **Administrador** ou **Suporte** e com a respectiva permissão configurada no menu principal.
{% endhint %}

### Provedores de IA suportados

O Weknow permite cadastrar diferentes provedores de Inteligência Artificial para utilização nas funcionalidades de IA da plataforma.

Atualmente, são suportados os seguintes provedores:

* **OpenAI**;
* **Gemini**;
* **Anthropic**;
* **DeepSeek**.

Cada provedor possui seus próprios modelos e requisitos de autenticação. Para realizar a configuração, é necessário possuir as credenciais de acesso fornecidas pelo respectivo provedor.

Após informar o token na configuração, é possível utilizar a opção **Listar** para consultar os modelos disponíveis para aquela credencial e selecionar o modelo que será utilizado.

{% hint style="info" %}

* A disponibilidade de modelos pode variar conforme o provedor, as credenciais utilizadas e os modelos disponibilizados pelo serviço no momento da consulta.
* Para utilização no **Weknow Ask**, devem ser considerados os modelos compatíveis com os recursos necessários para a funcionalidade.
* Recursos específicos, como o raciocínio, também dependem da compatibilidade do modelo selecionado.
  {% endhint %}

### Como acessar

Para acessar a configuração de provedores:

1. Acesse **Configurações > Inteligência artificial > Provedores**.
2. Inclua um novo provedor ou selecione um registro existente para edição.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FomoBM0W2LlC1tJm1taYw%2Fimage.png?alt=media&amp;token=1e2a53b9-c1c1-441c-aa04-786f3fbecd0b" alt=""><figcaption><p>Tela de configuração e listagem dos provedores de IA.</p></figcaption></figure>

A tela permite **incluir, pesquisar, editar, duplicar, excluir e consultar referências** dos provedores cadastrados.

***

### Configurando um novo provedor

Ao incluir um provedor, informe os dados necessários para estabelecer a conexão com o serviço de Inteligência Artificial.

Entre as informações estão:

* **Descrição:** identificação do provedor;
* **Provedor:** serviço de Inteligência Artificial que será utilizado;
* **Token:** credencial utilizada para acesso ao provedor;
* **Modelo:** modelo de IA que será utilizado nas solicitações.

#### Selecionando o provedor

No campo **Provedor**, selecione o serviço de Inteligência Artificial que será utilizado.

Cada provedor pode possuir características, requisitos e restrições específicas para a sua configuração.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FMsU8MjAWF4MSHcX3i2zI%2Fimage.png?alt=media&amp;token=861f3648-e28c-4f9a-a583-22c09589fd02" alt=""><figcaption><p>Seleção do provedor</p></figcaption></figure>

#### Consultando as particularidades do provedor

Ao lado do campo **Provedor**, utilize o botão **Particularidades** para consultar as orientações e restrições específicas do provedor selecionado.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FkN4T5Hcnj29z93I3YrO4%2Fimage.png?alt=media&amp;token=5280e11b-2546-4802-bd6d-4edd147c8a65" alt=""><figcaption></figcaption></figure>

A ajuda apresenta somente os provedores que possuem particularidades cadastradas.

#### Informando o token e selecionando o modelo

Informe o **Token** utilizado para acessar o provedor.

Em seguida, clique em **Listar**, ao lado do campo **Modelo**, para carregar os modelos disponíveis para o provedor e a credencial informados.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FkelOS80cdxm7ZJaLG6N6%2Fimage.png?alt=media&amp;token=20ed7936-092b-414c-be70-c8a83c82b5a7" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Modelos compatíveis:** Para utilizar o provedor no **Weknow Ask**, selecione um modelo compatível com os recursos necessários para o funcionamento da funcionalidade. A disponibilidade dos modelos depende do provedor e da credencial utilizada.
{% endhint %}

Selecione o modelo que será utilizado e complete os demais campos disponibilizados de acordo com as características do provedor e do modelo, como:

* **Temperatura**;
* **Esforço de raciocínio**, quando compatível;
* outras opções disponibilizadas pela configuração.

{% hint style="danger" %}
**Importante:** O token é uma credencial de acesso ao provedor. Ele deve ser informado somente por usuários autorizados e não deve ser compartilhado em telas, documentos públicos ou registros de atendimento.
{% endhint %}

Após concluir o preenchimento das informações, clique em **Salvar** para finalizar a configuração.

O provedor ficará listado na parte inferior da tela:

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FnNJRcrnLlXYGhhjVsb3v%2Fimage.png?alt=media&amp;token=827ba356-1946-4d35-a034-675314048c61" alt=""><figcaption><p>Preenchimento do token, seleção do modelo e demais parâmetros do provedor.</p></figcaption></figure>

{% hint style="warning" %}
A disponibilidade de determinados recursos e opções depende do provedor e do modelo selecionados.
{% endhint %}

***

### Definindo o provedor padrão

É possível definir um dos provedores cadastrados como provedor padrão.

Para isso:

1. Ao cadastrar ou editar um provedor, marque o campo **Este é um provedor padrão**.
2. Clique em **Salvar**.

Na lista de provedores cadastrados, o provedor será identificado como **Sim** na coluna **Padrão**.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FY2exPkNR3pMsOz73ukrK%2Fimage.png?alt=media&amp;token=4090afe2-6f28-4c73-81cc-288e90937bf2" alt=""><figcaption><p>Campo 'Este é um provedor padrão' e identificação do provedor padrão na lista.</p></figcaption></figure>

O provedor padrão será utilizado somente quando a função de IA não possuir um provedor definido especificamente em seus **Parâmetros**.

{% hint style="warning" %}

* Definir um provedor como padrão não substitui um provedor que já esteja selecionado especificamente para uma função de IA.
* Somente um provedor pode ser definido como padrão por vez.
  {% endhint %}

***

### Modelos compatíveis com raciocínio

Alguns modelos de IA oferecem suporte ao recurso de raciocínio, enquanto outros não.

Quando o modelo selecionado for compatível, será possível configurar o **Esforço de raciocínio** de acordo com as opções disponibilizadas.

Para modelos que não oferecem suporte ao recurso de raciocínio, essa configuração não estará disponível.

A disponibilidade do recurso depende da compatibilidade do modelo selecionado.

***

### Editando um provedor

Para alterar um provedor já cadastrado:

1. Localize o provedor na lista.
2. Selecione o registro.
3. Edite as informações necessárias.
4. Salve as alterações.

{% hint style="warning" %}
As alterações poderão afetar as funções de IA que utilizam esse provedor. Antes de modificar uma configuração em uso, verifique as configurações das funções relacionadas.
{% endhint %}

***

### Excluindo um provedor

Antes de excluir um provedor, verifique se ele está sendo utilizado por alguma configuração de IA.

Um provedor que esteja definido como padrão ou associado diretamente a uma função pode possuir referências que precisam ser avaliadas antes da exclusão.

Para excluir um provedor:

1. Acesse a lista de provedores cadastrados.
2. Selecione o registro que deseja excluir.
3. Clique em **Excluir**.
4. Confirme a operação.

***

### Próximo passo

Depois de configurar os provedores de Inteligência Artificial, configure os demais recursos necessários para utilização das funções de IA.

Consulte [Análise Inteligente](/wedocs-5.2/inteligencia-artificial/analise-inteligente.md) para definir e acompanhar a quantidade de utilizações disponíveis para os usuários.