> 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/nodes/action-node.md). # Ação ## Visão geral técnica e recursos {% columns %} {% column width="58.333333333333336%" %} **Ação** os nós no IoT Logic permitem o controle automatizado de dispositivos executando comandos específicos quando acionados por fluxos de dados de entrada. Esses nós transformam o monitoramento passivo da frota em sistemas de automação ativa, realizando operações críticas como comutação de saídas e transmissão de comandos GPRS. {% endcolumn %} {% column width="50%" %}
{% endcolumn %} {% endcolumns %} Embora os nós de Ação possam receber dados de qualquer tipo de nó, eles são mais comumente conectados a [Lógica](/docs/user/pt-br/guide/account/iot-logic/nodes/logic-node.md) nós que avaliam condições e acionam ações apenas quando critérios específicos são atendidos, como limites de temperatura, movimento não autorizado ou incidentes de condução agressiva. {% hint style="info" %} O **Ação** os nós são configurados separadamente para cada fluxo na interface da plataforma Navixy. Cada nó pode conter várias ações que são executadas sequencialmente quando acionadas por dados de entrada. {% endhint %}
### Como funcionam os nós de Ação Quando os dados chegam a um **Ação** nó, o sistema identifica quais dispositivos forneceram os dados de entrada e executa as ações configuradas somente para esses dispositivos. Para ver todos os detalhes sobre a sequência de execução e o direcionamento, consulte [Execução e direcionamento das ações](#action-execution-and-targeting) abaixo. {% hint style="info" %} **Requisito de conectividade do dispositivo**: As ações são enviadas apenas para dispositivos confirmados on-line (aqueles que fornecem dados recentes), garantindo a entrega confiável dos comandos. {% endhint %} Cada **Ação** resultado de acionamento do nó aparece em [Analisador de dados](/docs/user/pt-br/guide/account/iot-logic/data-stream-analyzer.md) como um atributo nomeado após o **ID do nó** (exibido na caixa de diálogo de configuração do nó, por exemplo `action_1a2b3c4d`). O valor é `0` quando o nó não foi acionado e `1` quando foi acionado, permitindo confirmar a execução e diferenciar vários nós de Ação no mesmo fluxo. ### Integração com a arquitetura do fluxo **Ação** os nós funcionam como nós terminais dentro da arquitetura do fluxo, recebendo acionamentos de nós anteriores sem encaminhar dados adiante. Os recursos de automação se integram ao sistema mais amplo de gerenciamento de dispositivos da Navixy por meio de: * **Automação condicional**: Integração com [Lógica](/docs/user/pt-br/guide/account/iot-logic/nodes/logic-node.md) nós permite fluxos de trabalho sofisticados do tipo se... então..., em que as ações são executadas somente quando condições específicas são validadas * **Controle de dispositivos em tempo real**: Os comandos são transmitidos em segundos após o recebimento dos acionamentos, garantindo resposta imediata a condições críticas * **Coordenação em toda a frota**: Quando conectadas a múltiplas fontes de dispositivos, as ações podem coordenar respostas em grupos inteiros de veículos simultaneamente * **Respeito às capacidades do dispositivo**: As limitações individuais de cada dispositivo são respeitadas, e os comandos não suportados são recebidos, mas não executados ## Opções de configuração {% columns %} {% column valign="middle" %} Configurar um **Ação** nó determina quais comandos serão executados e, opcionalmente, quais dispositivos adicionais receberão esses mesmos comandos. A caixa de diálogo de configuração está organizada em duas abas: * **Padrão**: define quais comandos executar. Funciona de forma independente, sem depender da aba Avançado. * **seção Avançado**: define quais dispositivos adicionais recebem os mesmos comandos quando o nó é acionado. Opcional. {% endcolumn %} {% column %}
{% endcolumn %} {% endcolumns %} Vamos ver quais elementos este nó usa e o que você pode configurar ao trabalhar com ele: ### Etapas de configuração {% stepper %} {% step %} #### Especifique o nome do nó Digite um nome descritivo que identifique as ações automatizadas que este nó executará 1. Use nomes como "Resposta de resfriamento de emergência" ou "Ações de alerta de segurança" para ficar mais claro 2. Este nome aparece no diagrama do fluxo para facilitar a identificação {% endstep %} {% step %} #### ID do nó (gerado automaticamente) Abaixo do campo Nome, a caixa de diálogo exibe um **ID do nó** (por exemplo, `action_1a2b3c4d`). Este campo é somente leitura — você não pode editar nem definir seu valor. 1. O ID é gerado automaticamente quando o nó é criado e permanece o mesmo durante toda a vida útil do nó 2. Use-o para diferenciar os resultados deste nó de outros nós de Ação em [Analisador de dados](/docs/user/pt-br/guide/account/iot-logic/data-stream-analyzer.md), onde ele aparece como um atributo mostrando `0` (não acionado) ou `1` (acionado) {% endstep %} {% step %} #### Selecione o tipo de ação No **Padrão** na aba, escolha o tipo de resposta automatizada no menu suspenso 1. **Alternar saída**: Controle as saídas do dispositivo ligando-as ou desligando-as 2. **Enviar comando GPRS**: Transmita comandos personalizados diretamente para os dispositivos {% endstep %} {% step %} #### Configurar parâmetros da ação Defina os detalhes específicos com base no tipo de ação selecionado:
Configuração de comutação de saída
Ao configurar ações de Alternar saída: * **Número da saída**: Selecione qual saída do dispositivo controlar no menu suspenso * Os números de saída disponíveis dependem das capacidades específicas do seu dispositivo * Consulte a documentação do seu dispositivo para entender as funções das saídas * **Alternância ligar/desligar**: Defina se a ação liga ou desliga a saída * Use o botão de alternância para selecionar o estado desejado
Configuração de Enviar comando GPRS
Ao configurar ações de comando GPRS: * **String do comando**: Digite o texto exato do comando a enviar aos dispositivos * Os comandos devem corresponder à sintaxe de comando suportada pelo seu dispositivo * Consulte a documentação do dispositivo para ver os comandos disponíveis e a formatação correta * Não há restrições de caracteres no campo de entrada
{% endstep %} {% step %} #### Adicionar ações adicionais (opcional) Clique em **Adicionar ação** para criar várias ações dentro do mesmo nó. {% hint style="info" %} * Os comandos de ação são enviados ao receber um pacote de dados do dispositivo, de acordo com a configuração do fluxo * Os comandos são executados sequencialmente na ordem em que aparecem na configuração * Cada ação pode ser de um tipo diferente (Alternar saída ou comando GPRS) * Use o ícone da lixeira para remover ações desnecessárias {% endhint %} {% endstep %} {% step %} #### Configurar mapeamentos de destinatários (opcional) Abra o **seção Avançado** na aba para definir quais dispositivos adicionais receberão os mesmos comandos quando o nó for acionado.
1. Use o cabeçalho **Dispositivo de origem** menu suspenso para selecionar o dispositivo cujos dados de entrada acionam o nó. Esse deve ser um dispositivo presente no **nó Fonte de Dados**. 2. Use o cabeçalho **Dispositivos de destino** menu suspenso para selecionar um ou mais dispositivos que receberão os mesmos comandos. 3. Clique em **+ Mapeamento personalizado** para adicionar pares adicionais de origem para destino caso diferentes dispositivos de origem devam propagar comandos para diferentes conjuntos de dispositivos de destino. {% hint style="info" %} A aba Avançado é opcional. Sem ela, o nó se comporta exatamente como antes — os comandos são executados apenas para o dispositivo acionador. {% endhint %} {% endstep %} {% step %} #### Salvar configuração Clique em **Aplicar alterações** para salvar a configuração do seu nó {% endstep %} {% endstepper %} {% hint style="danger" %} **Observação sobre compatibilidade do dispositivo:** A execução da ação depende das capacidades individuais de cada dispositivo. Certifique-se de que seus dispositivos suportem as saídas ou os comandos específicos que você está configurando. Procure os comandos suportados em recursos do fabricante, como a documentação do dispositivo. A lista de dispositivos compatíveis está disponível em [Dispositivos integrados da Navixy](https://www.navixy.com/devices/). {% endhint %} ## Execução e direcionamento das ações O **Ação** o nó oferece controle preciso sobre quando e onde os comandos são executados, garantindo respostas de automação eficientes e direcionadas. ### Sequência de execução Quando acionado, o **Ação** nó segue este padrão de execução: 1. **Direcionamento de dispositivos**: As ações são enviadas apenas para dispositivos que forneceram dados no evento de acionamento atual 1. Isso garante que os comandos alcancem apenas os dispositivos específicos envolvidos na condição 2. Evita comandos desnecessários para os dispositivos da frota que não foram afetados 2. **Processamento sequencial**: Várias ações dentro de um nó são executadas na ordem configurada, de cima para baixo 1. Cada ação conclui a transmissão antes que a próxima ação comece 2. O tempo total de execução geralmente é de segundos após o recebimento do acionamento 3. **Validação do dispositivo**: Os dispositivos individuais processam os comandos recebidos de acordo com suas capacidades 1. Os comandos suportados são executados imediatamente após o recebimento 2. Os comandos não suportados são recebidos, mas ignorados pelo dispositivo 3. Os mecanismos de segurança do dispositivo podem impedir comandos inadequados (por exemplo, desligamento do motor em movimento) ### Comportamento da conexão **Integração com o nó Lógica**: Quando conectado a [Lógica](/docs/user/pt-br/guide/account/iot-logic/nodes/logic-node.md) nós, as ações são executadas apenas para dispositivos em que a condição lógica foi avaliada como `true`. Isso oferece automação condicional precisa. **Conexões diretas**: Quando conectado diretamente a outros tipos de nó (Fonte de Dados, Iniciar Atributo), as ações são executadas para todos os dispositivos no fluxo de dados sempre que os dados são recebidos. ## Perguntas frequentes #### Como sei se minhas ações foram executadas com sucesso? Verifique [Analisador de dados](/docs/user/pt-br/guide/account/iot-logic/data-stream-analyzer.md): selecione o dispositivo acionador e procure o atributo correspondente ao ID do nó. Veja [Como funcionam os nós de Ação](#how-device-action-nodes-work) para detalhes. Os comandos são enviados para dispositivos confirmados on-line (aqueles que fornecem dados recentes), sem intervalo de tempo de execução entre o acionamento e a entrega. Isso elimina a possibilidade de o dispositivo ficar off-line entre o acionamento e a execução. #### Posso conectar vários nós ao mesmo nó de Ação? Sim. Os nós de Ação podem receber acionamentos de vários nós anteriores, mas observe que as ações serão executadas para qualquer dispositivo que acionar qualquer nó conectado. Ao projetar fluxos complexos, considere o efeito cumulativo de várias fontes de acionamento para garantir que as ações sejam executadas somente nos cenários pretendidos. Para confirmar que o nó é acionado apenas nos cenários desejados, monitore seu atributo ID do nó em [Analisador de dados](/docs/user/pt-br/guide/account/iot-logic/data-stream-analyzer.md): ele mostra `1` em cada acionamento e `0` caso contrário. #### O que acontece se eu conectar um nó de Ação diretamente a uma Fonte de Dados? O nó de Ação executará as ações configuradas toda vez que qualquer dispositivo na Fonte de Dados enviar dados. Isso cria uma execução contínua de ações em vez de respostas condicionais. Para a maioria dos casos de uso, conectar nós de Ação a [Lógica](/docs/user/pt-br/guide/account/iot-logic/nodes/logic-node.md) nós oferece melhor controle sobre quando as ações devem ser executadas. --- # 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/nodes/action-node.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.