> For the complete documentation index, see [llms.txt](https://docs.sapios.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sapios.com.br/construindo-e-treinando/variaveis.md).
# Variáveis
Variáveis são todas as informações de usuário, configurações de um intenção ou de um componente representados por um nome e podendo ser utilizados durante o fluxo caso seja necessário retomar essas configurações para o avanço do fluxo.
Uma variável pode ser criada em um componente de **Pergunta** ou **Atribuir Variáveis** e pode ser definido o alcance e por quanto tempo essa variável é valida. Um fluxo pode ser composto por 4 tipos de variáveis:
### Variável Local
Uma variável local quando criada é capaz de ser utilizada apenas no fluxo em que foi criada, uma vez em que o usuário esteja em uma conversa com um chatbot, essa variável pode servir, por exemplo para decisões do usuário.
Assim que usuário responder a decisão ou condição apresentada o fluxo prossegue e a variável é descartada, pois a informação já foi recebida e não será utilizada no fluxo.
### Variável de Conversa
Variável criada para ser utilizada durante o fluxo inteiro repetidamente. Possui as mesmas caraterísticas de uma variável local, porém é possível utilizá-la na conversa inteira até que seja encerrada.
### Variável de Usuário
A Variável de Usuário é responsável por adquirir informações que já estão pré definidas ou informações definidas do usuário durante uma interação no chat e armazená-las no componente para usos futuros, deixando a comunicação mais dinâmica, sem necessitar de repetição de informações. Exemplo: nome, CPF, número de telefone, endereço, etc.
Nestes dois componentes acima, você pode configurar a sua variável que forma que possa validá-la ao fluxo. As configurações de variáveis geralmente aparecem com a da imagem acima.
### Variáveis Globais
Uma Variável Global não está atrelada diretamente ao fluxo como as três anteriores, ela é pré definida nas configurações do Bot. Isso ocorre por conta de seu uso ser direcionado a informações mais sensíveis que caso introduzidas em variáveis normais dentro de componentes, se tornariam um ponto de falha para obtenção de dados como URLs, webservices, senhas ou tokens de autenticação.
Você pode adicionar uma entidade variável pelo sinal de '+', disponível no conto superior direito da tela ou importar uma variável já definida em um arquivo JSON no botão ao lado.
---
# 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:
```
GET https://docs.sapios.com.br/construindo-e-treinando/variaveis.md?ask=
```
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.