> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/pt-br/guide/account/iot-logic/quick-start-guide.md).
# Guia de início rápido
Este guia ajuda você a configurar rapidamente seu primeiro fluxo de dados no IoT Logic e começar a processar seus dados de telemetria.
## Pré-requisitos
Antes de prosseguir com a criação do seu primeiro fluxo, certifique-se de ter:
* Uma **Proprietário** uma função em sua conta Navixy
* Dispositivos ativados em sua conta
* Entendimento de quais fontes de dados você deseja processar
{% hint style="info" %}
O workspace do IoT Logic está disponível apenas para contas **Proprietários** e não é exibido para usuários comuns **Usuários**. Para detalhes sobre funções de usuário, consulte [Permissões de acesso](/docs/user/pt-br/guide/account/users-and-roles.md).
{% endhint %}
## Começando a partir de um modelo
Os modelos são uma alternativa a criar um fluxo manualmente do zero. Cada modelo é uma estrutura de fluxo pré-configurada para um cenário comum de processamento de dados que você pode selecionar na página inicial do IoT Logic e adaptar às suas necessidades. Para detalhes sobre os modelos disponíveis e como usá-los, consulte [Modelos](/docs/user/pt-br/guide/account/iot-logic/quick-start-guide/templates.md).
## Configuração do fluxo
Agora, vamos detalhar o processo básico de configuração do fluxo passo a passo.
{% stepper %}
{% step %}
### Abrir o IoT Logic
No menu principal, navegue até **IoT Logic**. A página inicial é aberta com duas seções: **Modelos de fluxo**, uma galeria de estruturas de fluxo pré-configuradas, e **fluxos criados**, uma tabela que lista todos os fluxos existentes em sua conta.
{% endstep %}
{% step %}
### Criar um novo fluxo
1. Clique **Criar fluxo**. Na caixa de diálogo que se abre, digite um nome e uma descrição para o seu fluxo e defina seu estado como ativado.
2. Clique **Confirmar** para abrir a tela de trabalho e começar a montar o fluxo.
{% hint style="info" %}
Se você preferir começar de uma estrutura pré-configurada, você pode usar um modelo em vez de criar um fluxo do zero. Os modelos são fluxos pré-configurados para cenários comuns de processamento de dados. Veja [Modelos](/docs/user/pt-br/guide/account/iot-logic/quick-start-guide/templates.md) a lista completa e as instruções de configuração.
{% endhint %}
{% endstep %}
{% step %}
### Configurar um nó de Fonte de Dados
Esta etapa define quais dispositivos enviarão suas leituras para este fluxo. É essencial fornecer ao pipeline dados reais.
1. Do **Nós** painel, que agrupa os nós disponíveis em **Comece com**, **Processamento**, **Ação**, e **Termine com** seções, arraste um **Fonte de Dados** nó para a tela de trabalho
2. Clique no nó para exibir ações rápidas, ou dê um clique duplo para abrir imediatamente o painel de configuração
3. Configure as seguintes configurações:
1. **Nome do nó**: Digite um nome descritivo, especificando a origem dos dados enviados (por exemplo, *Veículos do motorista*)
2. **Fontes**: Selecione os dispositivos cujas leituras você deseja enviar para este fluxo.
4. Clique **Aplicar alterações** para aplicar a configuração
{% hint style="info" %}
Para detalhes sobre a configuração do nó, consulte [nó Fonte de Dados](/docs/user/pt-br/guide/account/iot-logic/nodes/data-source-node.md).
{% endhint %}
{% endstep %}
{% step %}
### Adicionar enriquecimento de dados
Nesta etapa, configure os cálculos para enriquecer os dados brutos ou até mesmo criar matematicamente atributos de dados completamente novos.
1. Arraste um **Iniciar Atributo** nó para a tela de trabalho
2. Clique no nó para exibir ações rápidas, ou dê um clique duplo no nó para abrir seu painel de configuração
3. Adicione um nome descritivo **Nome do nó** para especificar sua finalidade e os cálculos que ele realiza (por exemplo, *Temperatura °F para °C*)
4. Defina seu atributo:
1. **Nome do atributo**: Um nome claro e descritivo (por exemplo, "speed\_mph")
2. **Fórmula**: A expressão de cálculo (por exemplo, `speed/1.609` para converter km/h em mph)\
:bulb:**Observação**: A sintaxe curta é a opção principal. Use a sintaxe completa quando precisar de valores históricos/indexados ou de verificações explícitas de validade (por exemplo, `value('speed', 1, 'valid')`).\
Os nomes dos atributos [podem ser preenchidos automaticamente](/docs/user/pt-br/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names) para evitar erros de digitação.
5. Adicione atributos adicionais, se necessário, clicando em **Adicionar atributo**. Para remover um atributo, clique no ícone de exclusão ao lado dele.
6. Clique **Aplicar alterações** para aplicar a configuração
7. Crie uma conexão:
1. Clique no conector de saída do **Fonte de Dados** nó
2. Arraste a transição para o conector de entrada do **Iniciar Atributo** nó
{% hint style="info" %}
Para detalhes sobre a configuração do nó, consulte [nó Iniciar Atributo](/docs/user/pt-br/guide/account/iot-logic/nodes/initiate-attribute-node.md).
Para detalhes sobre ações com atributos, consulte [Gerenciar atributos](/docs/user/pt-br/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md).
Para exemplos de fórmulas de cálculo, consulte [Exemplos de cálculo](/docs/user/pt-br/guide/account/iot-logic/nodes/initiate-attribute-node/calculation-examples.md).
{% endhint %}
{% endstep %}
{% step %}
### Configurar a saída de dados
Esta etapa define para onde os dados são enviados a partir deste fluxo. Você pode direcioná-los para a Navixy ou para um sistema de terceiros via MQTT.
1. Arraste um **Ponto de Extremidade de Saída** nó para a tela de trabalho
2. Passe o mouse sobre o nó para exibir ações rápidas, ou dê um clique duplo no nó para abrir seu painel de configuração
3. Selecionar endpoint **Modo**:
* **Ponto de extremidade padrão**: uma saída padrão para enviar dados do fluxo para a plataforma Navixy. Ela já vem pré-configurada e não pode ser editada.
* **Ponto de extremidade MQTT**: uma saída personalizada para enviar dados do fluxo a destinos de terceiros via MQTT.
4. Configure as configurações específicas do preset. A saída padrão já vem pré-configurada; para instruções sobre outras configurações e parâmetros do preset, consulte [Configurações específicas do modo](/docs/user/pt-br/guide/account/iot-logic/nodes/output-endpoint-node.md#mode-specific-configurations).
5. Clique **Aplicar alterações** para aplicar a configuração
6. Conecte seus outros nós a este na ordem necessária para finalizar a estrutura do fluxo
{% hint style="info" %}
Todo fluxo deve incluir um **Ponto de extremidade padrão** nó de saída para garantir que os dados sejam enviados à plataforma. Sem essa conexão, os dados do dispositivo não ficam visíveis na interface da Navixy.
Para detalhes sobre a configuração do nó, consulte [Nó Ponto de Extremidade de Saída](/docs/user/pt-br/guide/account/iot-logic/nodes/output-endpoint-node.md).
{% endhint %}
{% endstep %}
{% step %}
### Salve e ative seu fluxo
1. Verifique se todos os nós estão conectados corretamente em seu fluxo
2. Clique no **Salvar fluxo** botão na **Nós** painel
{% hint style="success" %}
Seu fluxo agora está ativo e processando dados em tempo real!
{% endhint %}
{% endstep %}
{% endstepper %}
## Validação do fluxo
A estrutura e as fórmulas do fluxo são validadas automaticamente pelo IoT Logic, exibindo avisos e mensagens de erro se a configuração estiver incompleta ou com falhas.
Para confirmar que os dados estão sendo processados corretamente, use a **Analisador de dados** ferramenta:
1. Clique no **Analisador de dados** guia na parte superior da tela de trabalho
2. Selecione os dispositivos que você deseja monitorar na lista suspensa
3. Observe os atributos dos dados recebidos e seus valores
4. Use as opções de filtragem para focar em parâmetros específicos
5. Verifique se quaisquer atributos calculados exibem os valores corretos
Para detalhes sobre o uso da ferramenta, consulte [Analisador de dados](/docs/user/pt-br/guide/account/iot-logic/data-stream-analyzer.md).
{% hint style="success" %}
Parabéns! Seu primeiro fluxo de dados do IoT Logic já está em funcionamento.
{% endhint %}
## Próximos passos
Depois de criar seu primeiro fluxo do IoT Logic, você pode:
* Adaptar este exemplo de início rápido às necessidades do seu negócio
* Criar transformações de dados mais complexas com vários [nós Iniciar Atributo](/docs/user/pt-br/guide/account/iot-logic/nodes/initiate-attribute-node.md)
* Configurar destinos adicionais [de saída](/docs/user/pt-br/guide/account/iot-logic/nodes/output-endpoint-node.md) para seus dados que podem se tornar perfis reutilizáveis para configurações consistentes
* [Gerenciar fluxos já criados](/docs/user/pt-br/guide/account/iot-logic/flow-management.md) para ajustar o processamento de dados a quaisquer mudanças que você enfrentar
* [Projetar fluxos avançados](/docs/user/pt-br/guide/account/iot-logic/flow-management/flow-configuration-example.md) para cenários de negócios específicos usando diferentes combinações e configurações de nós
## Perguntas frequentes
### O que acontece com os dispositivos não atribuídos a um fluxo personalizado?
A Navixy garante automaticamente que os dados deles cheguem à plataforma no nível do sistema. Nenhum fluxo personalizado ou configuração adicional é necessário para a transmissão básica de dados. Os fluxos personalizados servem para ir além dessa base, enriquecendo dados, aplicando lógica condicional ou encaminhando para sistemas externos.
### Posso usar o mesmo dispositivo em vários fluxos?
Sim. Um dispositivo pode pertencer a vários fluxos ao mesmo tempo. Todos os fluxos que incluem o dispositivo processam seus dados simultaneamente, e os resultados são mesclados para evitar perda de dados. Não há restrições quanto ao número de fluxos aos quais um dispositivo pode pertencer.
### Meu fluxo continuará funcionando se eu sair?
Sim, depois de ativados, os fluxos operam independentemente da sua sessão de usuário. Enquanto o fluxo estiver ativado, ele processa dados mesmo quando você não estiver conectado.
### Como sei se meu fluxo está funcionando corretamente?
Use o Analisador de dados para monitorar a transmissão de dados em tempo real. Essa ferramenta mostra tanto os dados brutos dos dispositivos quanto os atributos calculados, permitindo que você verifique se suas transformações estão funcionando como esperado.
### O que acontece se eu desativar um fluxo?
Quando você desativa um fluxo, toda a transmissão de dados para os dispositivos atribuídos a ele é interrompida, incluindo a entrega para a plataforma Navixy. Os dispositivos não ficam mais visíveis nem são atualizados na interface até que o fluxo seja reativado. Desative um fluxo somente quando você quiser interromper completamente a transmissão de dados para os dispositivos afetados.
---
# 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://navixy.com/docs/user/pt-br/guide/account/iot-logic/quick-start-guide.md?ask=&goal=
```
`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.