> For the complete documentation index, see [llms.txt](https://docs.gaiodataos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gaiodataos.com/gaio-dataos-portuguese/configuracoes/ia.md).

# IA

A seção **AI** em Settings permite que administradores gerenciem provedores de IA, definam políticas de compartilhamento de dados e controlem como informações contextuais são enviadas para modelos de IA durante análises, conversas e execuções de agentes.

<figure><img src="https://1268188283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91J5WBQDmSrL6EE6Xqez%2Fuploads%2FxF51R5BykAvR5M5LPeuh%2Fimage.png?alt=media&amp;token=5b1f478e-3761-4ed4-b975-7f49f582c826" alt=""><figcaption></figcaption></figure>

## Permissões de Compartilhamento de Dados

No topo da página, é possível configurar quais tipos de dados podem ser compartilhados com provedores de IA.

Essas configurações são **globais** e definem os limites de privacidade e governança do uso de IA dentro do Gaio DataOS.

***

### 1. Metadata

Compartilha apenas informações estruturais básicas das tabelas.

#### Inclui:

* Nome da coluna
* Título da coluna
* Tipo de dado

#### Exclui:

* Valores sensíveis

#### Finalidade:

Permite que a IA compreenda a estrutura do schema sem acessar dados reais.

***

### 2. Table Sample Data

Compartilha um subconjunto limitado de dados da tabela.

#### Inclui:

* Primeiras 10 linhas
* Dados sensíveis (se habilitado)

#### Finalidade:

Melhora o entendimento contextual da IA para respostas mais precisas em análises e interpretações de dados.

***

### 3. Analytics

Compartilha informações analíticas derivadas das tabelas.

#### Inclui:

* Distribuições de frequência
* Métricas
* Resumos analíticos
* Dados sensíveis (se habilitado)

#### Finalidade:

Permite que a IA raciocine sobre padrões, tendências e agregações, além dos dados brutos.

***

### 4. Results Sample

Compartilha uma amostra dos resultados de consultas executadas.

#### Inclui:

* Primeiros 10 resultados de consulta
* Dados sensíveis (se habilitado)

#### Finalidade:

Fornece contexto de execução para perguntas subsequentes e análises mais complexas.

***

## Criando ou Editando uma Configuração de IA

1. Acesse **Settings → AI**.
2. Clique em **Novo** ou no lápis de uma configuração existente. A janela **Gerenciador de IA** será aberta.
3. Preencha os campos abaixo.
4. Clique em **Salvar**. O ícone de lixeira exclui a configuração.

### Campos

* **Nome**: identificador interno da configuração de IA.
* **Tipo de uso**: **Geral** ou **RAG**.
* **Fornecedor**: DeepSeek, OpenAI, Anthropic, Grok, Mistral ou Azure.
* **Modelo**: os modelos disponíveis dependem do fornecedor. Para OpenAI, por exemplo: GPT-5, GPT-5 Nano, GPT-5 Mini, GPT-4.1, GPT-4.1 Mini, GPT-4.1 Nano, GPT-4o, GPT-4o Mini, GPT-4o Audio Preview, GPT-4 Turbo, GPT-4, O3, O3 Mini e O4 Mini.
* **Chave de API**: chave fornecida pelo fornecedor. Ela é armazenada com segurança e usada apenas em tempo de execução.

***

## Modelo Preferencial

É possível marcar uma configuração como **Preferential**.

O modelo preferencial será utilizado por padrão em:

* Dashboards
* Agents
* Funcionalidades com IA

Outros modelos continuam disponíveis para seleção manual ou casos avançados.

***

## Lista de configurações

A lista de configurações de IA mostra as colunas **ID**, **Nome**, **Fornecedor**, **Modelo**, **Preferencial**, **Definir** e **Provedor**.

* **Preferencial**: seletor que marca o modelo preferencial.
* **Definir**: botão **Aplique em todos os aplicativos**.
* **Provedor**: **Gaio** ou **Personalizado**.
* O lápis no fim de cada linha abre a configuração para edição.

***

## Governança e Segurança

* O compartilhamento de dados sensíveis é controlado explicitamente por escopo.
* As chaves de API nunca são expostas aos usuários finais.
* Os provedores de IA recebem apenas os dados que você habilitar.
* É possível utilizar múltiplos provedores no mesmo ambiente (ex: OpenAI + Anthropic).

***

## Boas Práticas

* Comece habilitando apenas **Metadata**, e evolua conforme necessário.
* Use **Table Sample Data** para exploração e entendimento de schema.
* Ative **Analytics** apenas quando for necessário raciocínio estatístico mais profundo.
* Defina um modelo **Preferential** para manter comportamento consistente.
* Utilize diferentes provedores para comparar qualidade, custo e performance.

{% hint style="info" %}
Essa camada de configuração garante que os recursos de IA do Gaio sejam poderosos, transparentes e aderentes à governança, mantendo controle total sobre como a inteligência é aplicada aos dados.
{% endhint %}
