Questionários e Ações

esta funcionalidade está disponível apenas para o papel de desenvolvedor a funcionalidade questionários e ações permite criar conversas e fluxos de interação de forma flexível, seja escrevendo scripts em lua ou usando o editor visual blockly escolha a abordagem que mais se adequa ao seu conhecimento e à complexidade do projeto editor de código ideal para usuários que preferem controle total sobre o código e fluxos personalizados editor visual indicado para quem busca rapidez e visualização intuitiva, montando lógica por meio de blocos workspaces os workspaces permitem organizar seus projetos de forma prática e eficiente dentro da funcionalidade questionários e ações para criar um novo workspace, siga as instruções abaixo criar um workspace no menu lateral, acesse citsmart aura > questionários e ações menu lateral na tela principal, clique em novo workspace novo workspace ao clicar em “novo workspace” , um pop up será exibido preenchendo workspace campos do formulário nome do workspace insira um nome único e descritivo para facilitar a identificação integrar com o git (opcional) se desejar conectar o workspace a um repositório git, preencha repositório url completa do repositório usuário seu nome de usuário para acesso ao repositório senha senha ou token de acesso ao repositório quando terminar, basta clicar em criar novo workspace pronto! seu ambiente será criado e já poderá ser utilizado excluir um workspace para deleter um workspace , clique no ícone de lixeira ao lado daquele que deseja excluir deletando workspace no pop up de confirmação, clique em sim para confirmar a exclusão editor visual no citsmart aura, o editor visual oferece uma forma fácil de montar seus fluxos sem escrever código com base na tecnologia blockly, ele apresenta blocos coloridos que representam ações, condições, repetições, cálculos, textos, listas, variáveis e funções ao arrastar e encaixar esses blocos no espaço de trabalho, o sistema converte automaticamente a sequência em código funcional acessar para acessar o editor, escolha o workspace e clique na opção "editor visual" acessando o editor visual caixa de ferramentas a caixa de ferramentas organiza todos os blocos por tema, facilitando a busca pelo recurso certo cada categoria agrupa blocos com finalidades específicas página do editor visual para usar um bloco, clique no nome da categoria para expandir a lista, em seguida arraste o bloco escolhido para o painel principal arrastando blocos para o espaço de trabalho tipos de blocos nesta seção, você vai conhecer os diferentes tipos de blocos disponíveis e entender para que serve cada um esses blocos são como peças de um quebra cabeça que você pode montar para criar soluções no sistema, mesmo sem saber programar cada categoria tem uma função específica para tornar o processo simples e intuitivo lógica os blocos de lógica permitem criar condições e tomar decisões no seu projeto por exemplo, você pode usar "se então" para que algo aconteça apenas quando uma condição for verdadeira também pode combinar condições ou verificar se algo é verdadeiro ou falso repetições esses blocos ajudam a automatizar ações que precisam ser feitas várias vezes você pode repetir uma tarefa um número específico de vezes ou enquanto uma condição for verdadeira, como "continue até que o valor chegue a 10" cálculos os blocos de cálculo são usados para realizar operações matemáticas, como somar, subtrair, multiplicar ou dividir números além disso, você pode trabalhar com números aleatórios ou realizar cálculos mais avançados dependendo da necessidade do projeto texto aqui você encontra blocos para trabalhar com palavras e frases com eles, é possível criar textos personalizados, juntar palavras, verificar se uma palavra aparece em outra ou até contar quantos caracteres tem uma frase listas os blocos de lista ajudam a organizar informações em sequência, como uma lista de itens de compras ou números ordenados com eles, você pode adicionar, remover ou encontrar elementos específicos em uma lista, facilitando a manipulação de dados variáveis as variáveis funcionam como caixinhas que guardam informações que podem mudar ao longo do tempo por exemplo, você pode criar uma variável chamada "pontos" para armazenar a pontuação de um jogo e atualizar esse valor conforme o jogo avança funções os blocos de função permitem criar conjuntos de ações que podem ser reutilizados em diferentes partes do projeto pense neles como uma receita você monta uma vez e pode chamá la quantas vezes quiser, tornando tudo mais organizado e eficiente pipelines as pipelines são uma forma poderosa de organizar fluxos de interação com o usuário, especialmente em sistemas que precisam de entradas dinâmicas e respostas interativas no questionários e ações, criar uma pipeline é simples e intuitivo, pois tudo é feito através de blocos que representam cada etapa do processo bloco de pipelines cada bloco desempenha uma função, veja abaixo bloco "pipelines criar lista com" função cria uma lista para armazenar pipelines as pipelines são fluxos de interação que conectam várias etapas ou ações bloco "criar pipeline com as iterações" função define um pipeline específica com um nome personalizado e as iterações que ele conterá parâmetros nome da pipeline identifica a pipeline iterações define quais etapas (ou interações) fazem parte do fluxo uso este é o ponto central de criação da pipeline, conectando diferentes etapas bloco "nome da interação" função define as iterações dentro da pipeline parâmetros nome da iteração define o nome da iteração da pipeline mensagem de saída texto ou instrução exibida ao usuário durante a interação mostrar interação define se a interação será visível (verdadeiro) ou oculta (falso) aceitar entrada configura se a interação aceita dados do usuário mensagem de rejeição texto exibido caso a entrada do usuário seja inválida uso configura o comportamento de uma etapa na pipeline bloco "chave valor" função define pares de chave valor muito útil para armazenar dados ou configurar informações dentro de uma interação ou função parâmetros chave nome que identifica o dado valor conteúdo associado à chave uso esse bloco é usado para manipular e organizar dados na pipeline bloco "referenciar função" função faz referência a uma função previamente definida no sistema parâmetros nome da função a função que será chamada quando o bloco for executado uso este bloco é utilizado para reaproveitar comportamentos ou lógicas já implementadas bloco "função com argumentos criar lista com" função define uma função com argumentos que podem ser passados quando ela for chamada parâmetros nome da função identifica a função argumentos lista de variáveis ou parâmetros que a função utiliza uso permite criar funções reutilizáveis que podem ser configuradas dinamicamente com base nos argumentos fornecidos bloco "função com argumentos (repetição)" função similar ao bloco anterior, define uma função com argumentos, mas aqui pode ser usado em outro contexto ou repetido bloco "definir variável local "i" para" função cria uma variável local (visível apenas dentro do contexto onde foi definida) e atribui um valor a ela parâmetros nome da variável identifica a variável (neste caso, i) valor o conteúdo inicial da variável uso este bloco é útil para armazenar temporariamente valores ou realizar cálculos locais criando uma pipeline simples neste exemplo, vamos criar uma pipeline básica chamada pipeline exemplo que solicita três informações do usuário o nome do usuário, a idade do usuário, e qual o problema ele deseja resolver além de aprender a criar a pipeline, você verá como configurar mensagens personalizadas e validar as entradas do usuário com este passo a passo detalhado e ilustrado, você conseguirá criar suas próprias pipelines para atender a diversas necessidades exemplo prático siga as instruções abaixo para criar e configurar sua pipeline passo 1 definir nome da pipeline no menu pipelines , localize o bloco "pipelines" > "criar lista com" arraste o bloco para o espaço de trabalho no menu texto , arraste o primeiro bloco "( )" conecte ao espaço disponível no bloco "criar lista com" clique no campo de texto do bloco e insira o nome da pipeline pipeline exemplo observação para remover os campos de conexões que não serão utilizados, basta clicar na engrenagem e arrastar o campo "item" para fora primeiro passo passo 2 iniciar a pipeline no menu pipelines , localize o bloco "criar pipeline com as iterações" > "criar lista com" arraste o bloco para o espaço de trabalho no campo de texto do bloco, insira o nome da pipeline pipeline exemplo segundo passo passo 3 configurar as iterações agora, você configurará as etapas (iterações) da pipeline este exemplo inclui três etapas perguntar o nome , perguntar a idade e perguntar o problema etapa 1 perguntar o nome no menu pipelines , localize o bloco "nome da interação" arraste o para o espaço de trabalho preencha os campos do bloco nome da interação digite perguntar nome mensagem de saída escreva "por favor, informe seu nome" mostrar interação selecione verdadeiro aceitar entrada selecione verdadeiro mensagem de rejeição escreva "tente novamente " primeira etapa etapa 2 perguntar a idade arraste outro bloco "nome da interação" para o espaço de trabalho preencha os campos do bloco nome da interação digite perguntar idade mensagem de saída escreva "qual é a sua idade?" mostrar interação selecione verdadeiro aceitar entrada selecione verdadeiro mensagem de rejeição escreva "idade inválida tente novamente " observação utileze como referência a imagem da etapa 1 etapa 3 perguntar o problema adicione mais um bloco "nome da interação" ao espaço de trabalho preencha os campos do bloco nome da interação digite perguntar problema mensagem de saída escreva "qual é o problema que deseja resolver?" mostrar interação selecione verdadeiro aceitar entrada selecione verdadeiro mensagem de rejeição escreva "entrada inválida por favor, tente novamente " observação utileze como referência a imagem da etapa 1 passo 4 conectar as iterações à pipeline certifique se de que as três iterações foram criadas perguntar nome perguntar idade perguntar problema no menu texto , arraste três blocos de texto " " (campo de texto vazio) para o espaço de trabalho em cada bloco de texto, escreva os nomes das iterações criadas perguntar nome , perguntar idade , e perguntar problema conecte os blocos de texto ao campo "criar lista com" do bloco "criar pipeline com as iterações" verifique se todas as interações estão conectadas corretamente à lista passo 4 checagem final após seguir todos os passos, revise o fluxo completo no espaço de trabalho certifique se de que o nome da pipeline está correto pipeline exemplo as três iterações foram criadas e configuradas corretamente as iterações estão conectadas ao bloco principal se tudo estiver correto, sua pipeline estará funcional e pronta para uso ela seguirá o seguinte fluxo pergunta o nome do usuário pergunta a idade do usuário pergunta qual problema o usuário deseja resolver testar a pipeline para validar a lógica da sua pipeline, utilize o botão testar , disponível no canto superior direito do editor visual botão testar ao clicar na opção testar , uma janela será exibida para que você possa interagir com o fluxo criado e verificar se ele está funcionando conforme o esperado realizando teste webserver com os blocos de webserver, você pode configurar interações com servidores na web, como enviar ou receber informações eles são úteis para criar sistemas que se comunicam com outros serviços online ou para criar funcionalidades como apis dentro do seu projeto lixeira a lixeira permite que você remova blocos arrastando os até ela se precisar, basta clicar na lixeira para abrir uma lista com os blocos descartados, permitindo que você os recupere quando necessário lixeira menu de contexto o menu de contexto é exibido quando você clica com o botão direito do mouse ou pressiona por alguns instantes certos elementos no espaço de trabalho, como o fundo ou os blocos ele apresenta uma lista de ações disponíveis para o elemento selecionado veja abaixo contexto outras ferramentas do editor visual o editor visual oferece outras ferramentas que tornam a navegação e organização mais prática e eficiente confira os recursos apresentados na imagem abaixo outros funções do editor mini mapa exibe uma visão reduzida do espaço de trabalho, permitindo localizar rapidamente áreas específicas quando há muitos blocos distribuídos ideal para facilitar a navegação em projetos maiores maximizar expande os blocos para ocupar todo o espaço de trabalho, proporcionando um visão melhor dos blocos já criados útil para evitar distrações e aproveitar melhor o ambiente de trabalho auto organizar realinha automaticamente os blocos no espaço de trabalho, organizando os de forma clara e eficiente essa função é ideal para manter os fluxos bem estruturados voltar localizada ao lado do título "editor visual", a seta permite retornar facilmente ao menu principal do questionários e ações, proporcionando acesso rápido às demais funcionalidades salvar grava as alterações feitas no projeto atual, garantindo que nenhum progresso seja perdido código para acessar o código, selecione o card desejado na lista do workspace e clique na opção "código" , conforme indicado na imagem abaixo código para criar um "novo item" , clique no ícone com o símbolo de "+" , localizado ao lado da palavra "raiz" criando novo item digite o nome para o item e escolha se ele será um "arquivo" ou "pasta" após preencher as informações, clique em "salvar" para finalizar a criação nomeando novo item editor de código após criar a pasta e o arquivo, a tela de edição de código será exibida, oferecendo um ambiente semelhante ao de um editor de texto avançado essa tela permite que você escreva o código necessário para configurar sua pipeline na imagem abaixo, estão destacados a área principal para edição do código, o botão para salvar as alterações e o arquivo criado dentro da pasta, onde o código será inserido tela de edição de código área de código aqui é onde você vai inserir o código da sua pipeline você pode digitar diretamente ou colar o código se já o tiver pronto botão "salvar" após finalizar a edição do código, clique em "salvar" para garantir que suas alterações sejam aplicadas lista de arquivos no painel lateral, você pode navegar entre os arquivos e pastas criados, como mostrado no exemplo com essas ferramentas, você pode facilmente criar, editar e organizar as pipelines diretamente pelo sistema outras funções o sistema de questionários e ações oferece diversas funcionalidades adicionais para facilitar a gestão e personalização dos seus workspaces confira na imagem abaixo outras funcionalidades funcionalidades disponíveis sincronizar todos permite sincronizar todas as alterações realizadas nos workspaces com o repositório git conectado sincronizar (card) atualiza as alterações mais recentes daquele card, garantindo que os dados estejam sempre em sincronia editar nome você pode alterar o nome do workspace de forma simples basta clicar no ícone de lápis ou diretamente sobre o nome do workspace após digitar o novo nome, clique fora da caixa para salvar automaticamente a alteração download esta opção permite fazer o download completo de todas as criações realizadas no editor visual e no código assim, você pode manter uma cópia local do conteúdo para backup ou análise visualizar logs clique no ícone em formato de "bug" para acessar o log de atividades do workspace essa funcionalidade permite acompanhar de forma detalhada as alterações, sincronizações e outros eventos importantes, facilitando o monitoramento ao clicar, uma nova página será aberta exibindo todos os registros dos logs