Edite e gerencie seu fluxo de trabalho no designer

Os fluxos de trabalho são criados e editados no designer visual redesenhado no Copilot Studio. O designer fornece uma tela onde você pode construir ou editar uma automação, adicionar e remover ações, verificar erros e publicar seu fluxo de trabalho sem sair do designer.

Exiba um fluxo de trabalho no designer

Para exibir um fluxo de trabalho no designer, abra o Copilot Studio, selecione Workflows, selecione o fluxo de trabalho e então selecione a aba Build.

Mude como seu fluxo de trabalho é exibido

Dependendo do tamanho e da complexidade do seu fluxo de trabalho, talvez seja interessante ajustar a forma como ele é exibido para facilitar o trabalho. A barra de ferramentas no canto inferior esquerdo da tela controla a exibição.

Legenda:

1. Ampliar: aumente o tamanho do fluxo de trabalho na tela.
2. Diminuir Zoom: diminuir o tamanho do fluxo de trabalho na tela.
3. Encaixar na tela: redimensione a visualização para encaixar todo o fluxo de trabalho na tela.
4. Arrumar: reorganizar o fluxo de trabalho e as ramificações para uma visão de ponta a ponta mais clara.
5. Layout vertical: alterne para uma exibição de layout vertical do fluxo de trabalho.

Adicionar e remover ações

1. No cartão após o qual você deseja adicionar a ação, selecione Adicionar uma etapa. O painel Adicionar é aberto.

2. Em Adicionar, comece a digitar a ação que você quer que seu fluxo de trabalho execute ou o conector que deseja adicionar, e então selecione na lista. Dependendo da seleção, talvez seja necessário fornecer informações adicionais para concluir a ação.

Se você determinar que uma ação não é necessária, selecione o ícone Excluir no canto superior direito da ação.

Verifique parâmetros do fluxo de trabalho

Para exibir os parâmetros de um gatilho ou ação em seu fluxo de trabalho, selecione seu cartão. O painel de configuração é aberto no lado direito. Para inserir o valor de um parâmetro, selecione uma opção na lista suspensa ou insira uma expressão para definir o valor dinamicamente.

Verificar se há erros

Erros em ações de fluxo de trabalho são indicados em vermelho. Para exibir detalhes de um erro em uma ação, selecione o erro. Para listar todos os erros em todo o fluxo de trabalho, abra o banner do centro de saúde . Para exibir os detalhes de erros individuais, selecione o erro.

Publicar seu fluxo de trabalho

Se o fluxo de trabalho não tiver erros, você poderá publicá-lo. No menu no topo da tela, selecione Publicar.

Testar seu fluxo de trabalho

As execuções de teste permitem verificar uma etapa ou um fluxo de trabalho inteiro sem sair do projetista, usando dados reais a montante, valores que você mesmo simula ou resultados de uma execução anterior.

Há duas maneiras de executar um teste:

Ambas as superfícies compartilham a mesma ideia: fornecer entradas (reais ou simuladas), executar e inspecionar a saída.

Testar um único nó em um fluxo de trabalho

Abra qualquer ação ou nó no seu fluxo de trabalho e clique no botão Reproduzir ou Testar. Há três seções:

1. Executar/Redefinir teste: executa a etapa quando solicitado ou limpa as entradas e saídas atuais.

   

2. Valores de carga das execuções anteriores: Um menu suspenso das execuções recentes desse fluxo de trabalho. Escolher um recupera as saídas da etapa upstream na execução para os campos de entrada abaixo.

3. Entradas: um campo editável por etapa upstream gera as referências do nó. O distintivo à direita de cada linha mostra o tipo esperado do campo (string, e-mail, data-hora, número e assim por diante).

4. Saída: O resultado ao vivo do teste mais recente, formatado para o tipo de nó.

Entradas simuladas

Por padrão, os campos de entrada estão em branco. É possível:

• Digite qualquer valor diretamente em um campo. O campo aceita o tipo mostrado no emblema à direita.
• Deixe um campo vazio se a etapa não depender dele.

Carregar valores de uma execução anterior

Se seu fluxo de trabalho já rodou antes, você pode reproduzir dados reais em vez de digitá-los:

1. Na lista suspensa Carregar valores de execução anterior, escolha uma execução.

2. O designer recupera as saídas das etapas dessa execução e as projeta através do esquema de entrada do nó. Os valores correspondentes são gravados nos campos de entrada.

3. Edite qualquer campo posteriormente se você quiser ajustar o cenário.

O menu suspenso mostra as 10 execuções mais recentes de qualquer status. Se uma execução não inclui saídas para um dos seus passos a montante porque esse passo foi pulado ou o caminho não foi feito, apenas os campos disponíveis são preenchidos. O resto permanece como estava.

Se o fluxo de trabalho não foi executado antes, nenhuma execução anterior disponível é exibida e o menu suspenso fica oculto.

Execute o teste

Selecione Executar teste. O botão exibe um estado de operação enquanto a chamada está em andamento; a seção de Saída mostra um spinner, em seguida, o resultado ou um erro.

• O teste de redefinição limpa as entradas e a última saída.
• O teste executa o nó isoladamente na API do conector. O teste não aciona o restante do fluxo de trabalho.

Teste todo o fluxo de trabalho

Na barra de comandos superior, selecione o botão Reproduzir (Teste). Teste seu fluxo de trabalho de ponta a ponta contra o tempo de execução ao vivo.

Antes do início da execução, o designer:

1. Salva e publica o fluxo de trabalho se você tiver alterações não salvas, ou se for a primeira vez.
2. Instala novas conexões na primeira execução.
3. Dispara a execução. O caminho depende do tipo de gatilho.

Entradas simuladas (gatilho manual)

Para gatilhos manuais, o diálogo Enter entradas de gatilho manual exibe um campo por cada entrada definida no gatilho:

• Texto/número/email/data: controle de entrada apropriado.
• Boolean: Alternar botão.
• Opção única (enum): lista suspensa.
• Seleção múltipla: lista suspensa de várias seleções.
• Arquivo: Selecionador de arquivos. O conteúdo é enviado como parte da run.
• Objeto/matriz: área de texto de várias linhas em que você pode colar JSON.

Selecione Executar para iniciar o fluxo de trabalho com esses comandos, ou Cancelar para descartar sem rodar. Os campos necessários são marcados com um asterisco. Se os valores estiverem ausentes ou inválidos, as mensagens de validação embutidas aparecerão e a execução será bloqueada até que sejam corrigidas.

O diálogo aparece toda vez que você seleciona Testar. Os valores não são salvos entre execuções, portanto, você pode tentar rapidamente cenários diferentes.

Assista à execução do processo

Uma vez que uma execução está em andamento:

• A barra de comandos mostra um botão Cancelar enquanto a execução está ativa.
• O painel de Atividade à direita lista a sequência atual no topo com um selo de status: Em Execução, Esperando, Bem-sucedido, Falhou ou Cancelado. Selecione qualquer execução para abri-la na tela e inspecionar as entradas e saídas de cada etapa.

Selecionar execuções anteriores

O painel de Atividades também serve como histórico de execuções do seu fluxo de trabalho:

• Filtre por Todos/Bem-sucedido/Falhou/Em execução usando o menu suspenso no topo.
• Selecione Atualizar para repetir a lista.
• Selecione Carregar Mais na parte inferior para voltar à página.
• Selecionar uma execução carrega-a na tela, onde cada nó mostra as entradas recebidas e as saídas produzidas para essa execução. Os dados são os mesmos que a guia Teste no nível do nó usa quando você escolhe uma execução na lista suspensa.

Quando usar cada tipo de teste

• Iterando em um único passo de IA ou ação de conector? Use Teste este nó. É mais rápido, não publica e permite simular apenas os valores a montante que importam.
• Validando comportamento de ponta a ponta ou lógica de gatilhos? Use o teste de fluxo Executar. Ele exercita todo o gráfico contra o tempo real de execução.
• Reproduzindo um problema de produção? Abra a execução falhando no painel de Atividade, depois abra o nó que falha e use valores de carregamento da execução anterior na aba de Teste para reproduzir os dados exatos a montante na ação.