> 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/tools/descoberta/power-search.md).

# Power Search

<figure><img src="/files/kp7zUI6ZDrH4ZNPeHQ3U" alt=""><figcaption></figcaption></figure>

O **Gaio Power Search** é uma funcionalidade que simplifica significativamente o acesso aos dados para todos os colaboradores da empresa. Com alta facilidade de criação e uso, os usuários podem acessar essa funcionalidade diretamente na tela inicial da plataforma Gaio e digitar naturalmente os termos que desejam pesquisar.

O Gaio cria automaticamente visualizações de dados com gráficos que melhor representam os resultados da consulta, tornando a exploração de informações rápida e eficiente.

***

## Como Utilizar

#### 1. Acessar a Task Power Search

No Studio:

* Vá até o painel **Delivery**
* Clique no botão **+**

***

#### 2. Configurar Informações Básicas

* **Label:** Adicione um nome para identificar a task no contexto
* **Table Name:** Escolha a tabela que será a fonte de dados (ex.: `sales`)
* **Description (opcional):** Texto explicativo para esclarecer o significado da tabela
* **User filter column (opcional):** Campo para aplicar filtros automáticos com base no usuário logado (ex.: `region` ou `sales_rep`)
* **Search:** Selecione as colunas da tabela que poderão ser pesquisadas

***

#### 3. Configurar os Campos

Para cada coluna da tabela, é possível configurar:

#### Field Type (ícone à esquerda)

* **Value:** Para campos categóricos ou de texto
* **Sum:** Para campos numéricos que serão agregados (ex.: `units_sold`)
* **Month:** Para campos de data utilizados em linhas do tempo

#### Title

Rótulo exibido nas visualizações geradas.

#### Description (opcional)

Texto auxiliar para esclarecer o significado do campo.

#### Format

Defina o formato do campo:

* Decimal
* Currency
* Percentage
* Entre outros

***

#### 4. Salvar a Configuração

Clique em **Save**, no canto superior direito, para aplicar as configurações.

***

#### 5. Ativar o Power Search

Após salvar:

* Saia do Studio
* Clique no botão **Search** para habilitar a interface com IA
* Ou utilize o atalho **Ctrl + G**

***

## Boas Práticas

* Utilize nomes amigáveis e descritivos para os campos (ex.: “Order Date” em vez de `order_dt`)
* Sempre adicione descrições para facilitar o entendimento dos usuários
* Formate corretamente os campos numéricos (Decimal, Currency, etc.)
* Remova campos desnecessários para simplificar e otimizar os resultados
* Priorize campos agregáveis (como `units_sold`, `revenue`, etc.) para gerar insights mais ricos
