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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gaiodataos.com/gaio-dataos-portuguese/configuracoes/ia.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.