> 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="/files/iLmvjAmmMlR8D4vlPSJr" 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 **New** ou **Edit** em uma configuração existente
3. Preencha os seguintes campos:

#### Campos

**Name**\
Identificador interno da configuração de IA.

**Supplier**\
Selecione o provedor de IA (ex: OpenAI, Anthropic, DeepSeek).

**Model**\
Escolha o modelo específico disponível para o provedor selecionado\
(ex: GPT-4, Claude Opus, DeepSeek Chat).

**API Key**\
Insira a chave de API fornecida pelo provedor.\
A chave é armazenada com segurança e utilizada apenas em tempo de execução.

4. Clique em **Save**

***

## 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.

***

## 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 %}