> 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/~/revisions/7Eo5Ofrc1lRD4ux3EURz/tools/parametros.md).

# Parâmetros

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

O recurso **Parâmetros** permite criar variáveis reutilizáveis dentro do seu processo (flow).\
Essas variáveis podem ser usadas em filtros SQL, variáveis de ambiente para scripts JavaScript ou para transferir valores entre blocos de execução.

***

### **Onde encontrar**

A aba **Parâmetros** está localizada no painel lateral esquerdo.\
Ao abrir o menu do Studio, você verá a área dedicada para criação e edição de parâmetros.

***

### **Como adicionar um novo parâmetro**

1. Clique no botão **“+”** no canto superior direito da aba **Parâmetros**.
2. Uma janela de configuração será exibida com os seguintes campos:
   * **Param name**: Nome único do parâmetro (**obrigatório**).
   * **Description**: Campo opcional para explicar o propósito ou uso do parâmetro.
   * **Value**: Valor padrão a ser usado durante as execuções (pode ser alterado dinamicamente).
3. Clique em **Save** para criar o parâmetro.

{% hint style="warning" %}
&#x20;**Dica**: Ao usar parâmetros em filtros dentro de dashboards, se quiser que todos os valores sejam o padrão, utilize `all_`.
{% endhint %}

***

### **Como usar parâmetros**

Depois de criados, os parâmetros podem ser usados em diferentes blocos do seu fluxo:

* **Em consultas SQL**: use a sintaxe `{{ parameter_name }}`
* **Em blocos JavaScript**: `{{params.parameter_name}}`
* **No Builder (Computed)**: `{{ parameter_name }}`
* **Em filtros visuais de dashboard**: utilize parâmetros para filtrar dados dinamicamente

***

### **Gerenciando parâmetros**

* **Editar e Excluir**: Clique nos três pontos e selecione a opção desejada.
* **Copiar**: Clique no ícone de copiar.

***

### **Notas**

* O campo **User ID** é um parâmetro interno especial e pode ser usado para identificar o usuário atual.
* Parâmetros têm escopo restrito ao fluxo atual e **não** afetam outros projetos ou processos.
* É possível definir e usar múltiplos parâmetros simultaneamente ao longo do seu fluxo.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.gaiodataos.com/gaio-dataos-portuguese/~/revisions/7Eo5Ofrc1lRD4ux3EURz/tools/parametros.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
