# 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: 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/tools/parametros.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.