--- title: Máquina de estados slug: aura/maquina-de-estados docTags: createdAt: 2025-07-07T20:39:55.891Z --- Este manual orienta como configurar, criar e editar uma máquina de estados, explicando a definição de estados, uso de detectores, entidades, mensagens automáticas, textos de dúvida e automações. Assim, você poderá definir como a máquina interage com os usuários e quais respostas devem ser apresentadas com base nas entradas. :::BlockQuote Esta funcionalidade está disponível apenas para o papel de **Desenvolvedor**. ::: ## Criar máquina de estados 1. No menu lateral, selecione a opção **Máquina de estados**. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/apHnUoTGskNpfVAL6uEe1_nlu.png) 2. Clique em **Novo workspace**. Uma janela será exibida. Informe o nome desejado e clique em **Criar workspace**. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/yc7NK2aLEdGtO-2i2vm1l_novoworkspace.png) ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/YKemFThrwyU7trzoSRfMj_novajanela.png) 3. Dentro do workspace, é possível editar o nome, criar/editar skills ou excluir a máquina. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/S0NfS-m9kf8cqeUilJDVM_opcoesworkspace.png) ## Editar nome do workspace Clique no ícone de lápis, digite o novo nome e clique fora da caixa para salvar automaticamente. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/LoZdu7UzgWI38qB-6FYaz_editarworkspace.png) ## Criar skill 1. Clique em **Nova skill**. 2. Na janela que abrir, informe o nome e clique em **Criar skill**. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/4Q-jmSKgjTkaWGKhpoZWg_novaskill.png) ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/px6GV4wzA0HnDWNSj8eUt_novaskill2.png) 3. A skill pode ser configurada no editor visual ou no editor de código. Ela define o fluxo de conversa, os estados, detectores e mensagens. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/4NwdNBdQWWuQ1k_wQGD-d_novaskill3.png) ## Editor visual Permite criar e organizar o fluxo da conversa conectando visualmente os estados da skill. Ao abrir, haverá dois estados iniciais: **Start** e **End**. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/4c2FGEsjmoikUMlJ-utbf_editorvisual.png) ### Recursos do editor - **Pesquisar estados**: encontre rapidamente qualquer estado criado. - **Adicionar novo estado**: estados representam os pontos de interação da conversa. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/NFnUozRj8akR0vwbzBv3x_novoestado.png) - **Propriedades**: defina configurações avançadas. [Veja mais aqui](#). ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/kmiInO92c5jMy3s5FBSaI_novapropriedade.png) - **Exemplos**: cadastre palavras ou frases que funcionem como detectores. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/BE4YiMOOCjYkpMJ0nLBGi_exemplo1.png) ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/1mtOg8qsXg1Jtzb8WZW_q_exemplo2.png) ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/Pe7P8wNmM8FPNU397p0ap_exemplo3.png) - **Entidades**: grupos de palavras com significado semelhante. Ajudam a identificar termos nas mensagens. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/7PC_gLIdrzv33HM6ZufDz_novaentidade.png) ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/tBsRTtd2P7wIDs3fBNiwq_novaentidade1.png) ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/K6Rx27XzZNYpz0U0fHfIc_novaentidade2.png) - **Testar**: simule o fluxo para verificar o comportamento configurado. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/iiTAubcieE28ehvJwcGA-_testar.png) - **Salvar**: salve as alterações realizadas. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/_M3ycj9bOhGl6qdz8HHxi_salvar.png) - **Fluxo global**: permite ativar o estado de qualquer ponto da conversa, caso os detectores sejam correspondidos. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/cnZT3B8OZbzhC7dyvInsv_fluxoglobal.png) - **Bloqueia avanço**: o sistema só avança após a resposta do usuário. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/2PAXWOoQQ54l5gI_5rK9V_bloqueioavanco.png) - **Detectores**: palavras ou expressões que ativam um estado. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/EVdlxDzzW2O9nPr-o_ngJ_menudetectores1.png) ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/UEHD1S3QlmCzfDHyMJSQb_menudetectores2.png) - **Mensagens**: textos que o sistema exibe automaticamente quando o estado é ativado. :::BlockQuote Se houver mais de uma, uma delas será escolhida aleatoriamente. ::: ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/bMq7GuHKVaWiniDZy262h_menumensagens1.png) ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/C3V04ERq845_tFWlALmQK_menumensagens2.png) - **Textos de dúvida**: usados quando há mais de um estado possível e a intenção não está clara. :::BlockQuote A escolha entre as frases será aleatória, se houver mais de uma. ::: ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/jkxB31CFrstRwrpWjaVxz_menuduvida1.png) ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/scHtq2NgJvkDRRa7SayGE_menuduvida2.png) - **Textos de dúvida completa**: exibidos quando o sistema não consegue reconhecer nenhuma intenção com precisão. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/70uzyJBoViuTz4em9_I0n_menuduvidacompleta1.png) ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/7__C6drFWcDibFULCgh7l_menuduvidacompleta2.png) - **Automações**: ações automáticas disparadas ao ativar um estado (mensagens, chamadas de API, etc). ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/QEG-xYgSpRZ0HnarsV5b2_menuautomacoes1.png) ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/-_8gjWP2p7h7rOTavrSaM_menuautomacoes2.png) - **Selecione os exemplos**: use exemplos criados para configurar os detectores de outros estados. - **Selecione os estados**: defina para onde o fluxo pode seguir. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/_OLzyqOKU9V9nD78xEenh_menuselecionarestado.png) ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/mz6wuqTzq2Nri-cjbQGki_estadolinkado.png) ## Editor de código Permite criar e editar a skill diretamente por código, usando uma linguagem inspirada em Rust. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/JxZllIRYAIE6N7_hk3-eT_codigo.png) Recursos disponíveis: - Upload de uma skill existente - Download da skill atual - Testes do fluxo - Salvamento de alterações Consulte mais detalhes no [guia completo](#). ## Excluir máquina de estado Clique no ícone de lixeira. :::BlockQuote Atenção: a exclusão é permanente. ::: ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/3QcS0Q_c6VYgR6yfQUALk_excluirworkspace2.png) ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/m6tzAZTIDXaVeYR4Ebe1b_excluirworkspace.png)