--- title: Variáveis slug: variaveis createdAt: 2024-09-04T19:50:14.315Z --- Aplicações de Workflow e Chatflow são compostas por nós independentes. A maioria dos nós possui itens de entrada e saída, mas as informações de entrada e saída para cada nó não são consistentes e são dinâmicas. Como usar um símbolo fixo para se referir a um conteúdo que muda dinamicamente? As variáveis, como contêineres de dados dinâmicos, podem armazenar e transmitir conteúdo não fixo, sendo referenciadas mutuamente entre diferentes nós, fornecendo mobilidade flexível de informações entre os nós. **Variáveis de Sistema** As variáveis de sistema referem-se a parâmetros predefinidos no nível do sistema dentro de uma aplicação Chatflow/Workflow que podem ser lidos globalmente por outros nós. Todas as variáveis de nível de sistema começam com *sys*. Variáveis de leitura apenas são marcadas com o símbolo "\*". **Workflow** Aplicações do tipo Workflow fornecem as variáveis de sistema abaixo: | Nome da Variável | Tipo de Dado | Descrição | Observação | | ---------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | sys.files | Array\[File] | Parâmetro de Arquivo: Armazena imagens enviadas pelos usuários | A função de upload de imagens precisa ser ativada na seção 'Funcionalidades' no canto superior direito da página de orquestração da aplicação | | *sys.user\_id* | String | ID do Usuário: Um identificador único automaticamente atribuído pelo sistema a cada usuário ao utilizar uma aplicação Workflow. É usado para diferenciar usuários distintos | | ![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/0QdBT7DNGizXqMC4olCf1_image.png) **Chatflow** Aplicações do tipo Chatflow fornecem as seguintes variáveis de sistema: | Nome da Variável | Tipo de Dado | Descrição | Observação | | ---------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- | | sys.query | String | Conteúdo inserido pelo usuário na caixa de chat | | | sys.files | Array\[File] | Parâmetro de Arquivo: Armazena imagens enviadas pelos usuários | A função de upload de imagens precisa ser ativada na seção 'Funcionalidades' no canto superior direito da página de orquestração da aplicação | | *sys.dialogue\_count* | Number | O número de rodadas de conversação durante a interação do usuário com uma aplicação Chatflow. A contagem aumenta automaticamente em um após cada rodada de chat e pode ser combinada com nós if-else para criar lógica de ramificação rica | Por exemplo, na Xª rodada de conversação, o LLM revisará o histórico da conversa e fornecerá automaticamente uma análise. | | *sys.conversation\_id* | String | Um ID único para a sessão de interação da caixa de chat, agrupando todas as mensagens relacionadas na mesma conversa, garantindo que o LLM continue a conversa no mesmo tópico e contexto | | | *sys.user\_id* | String | Um ID único atribuído a cada usuário da aplicação para distinguir usuários de conversas diferentes | | ![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/s4k6zAn-COgfPShs6StGR_image.png) ### Variáveis de Ambiente Variáveis de ambiente são usadas para proteger informações sensíveis envolvidas em workflows, como chaves de API e senhas de banco de dados usadas ao executar workflows. Elas são armazenadas no workflow em vez de no código, permitindo que sejam compartilhadas entre diferentes ambientes. ![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/Pm5y7cchJjFJv0mUP2-f2_image.png) As variáveis de ambiente suportam os seguintes 3 tipos de dados: - String - Number - Secret Características das variáveis de ambiente: - Variáveis de ambiente podem ser referenciadas globalmente na maioria dos nós; - Nomes de variáveis de ambiente não podem ser duplicados; - Variáveis de saída de nós geralmente são somente leitura e não podem ser escritas. ### Variáveis de Conversação As variáveis de conversação são aplicáveis apenas para a Aplicação Chatflow. As variáveis de conversação permitem que os desenvolvedores de aplicações especifiquem informações particulares que precisam ser temporariamente armazenadas dentro da mesma sessão de Chatflow, garantindo que essas informações possam ser referenciadas em várias rodadas de conversa dentro do Chatflow atual. Isso pode incluir contexto, arquivos enviados para a caixa de chat (em breve), preferências do usuário inseridas durante a conversa, etc. É como fornecer um "memo" para o LLM, que pode ser consultado a qualquer momento, evitando vieses de informação causados por erros de memória do LLM. Por exemplo, você pode armazenar a preferência de idioma inserida pelo usuário na primeira rodada de conversa em uma variável de conversação. O LLM se referirá à informação na variável de conversação ao responder e usará o idioma especificado para responder ao usuário em conversas subsequentes. ![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/D80SI1DPGboLWuM6hcwK-_image.png) As variáveis de conversação suportam os seguintes seis tipos de dados: - String - Número - Objeto - Array\[string] - Array\[número] - Array\[objeto] Características das variáveis de conversação: - As variáveis de conversação podem ser referenciadas globalmente na maioria dos nós na mesma aplicação Chatflow; - Escrever em variáveis de conversação requer o uso do nó "Atribuidor de Variável"; - As variáveis de conversação são variáveis de leitura e escrita. Sobre como usar as variáveis de conversação com o nó "Atribuidor de Variável", consulte o Atribuidor de Variável. **Aviso** Para evitar duplicação de nomes de variáveis, os nomes dos nós não devem ser repetidos. As variáveis de saída dos nós geralmente são variáveis fixas e não podem ser editadas.