Edite e gerencie seu fluxo de trabalho no designer

Note

Os recursos deste artigo são usados por agentes ou fluxos de trabalho alimentados pelo GitHub Copilot.

A cobrança por uso se aplica ao uso, criação, teste e avaliação de agentes. Essas ações podem consumir Créditos do Copilot. Saiba mais em Gerenciar os custos de agentes viabilizados pelo GitHub Copilot harness.

Crie e edite fluxos de trabalho no visual designer 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. Use a barra de ferramentas no canto inferior esquerdo da tela para controlar a visualizaçã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 sua escolha, talvez seja necessário fornecer mais informações para completar a ação.

Se você decidir que não precisa de uma ação, selecione o ícone Delete 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.

Importante

Você não pode publicar um fluxo de trabalho se ele contiver erros. Você deve corrigir todos os erros antes de poder publicá-lo.

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

Testes permitem verificar uma etapa ou um fluxo de trabalho inteiro sem sair do designer. Use dados upstream reais, valores simulados por você mesmo ou saídas de uma execução anterior.

Há duas maneiras de executar um teste:

O que você deseja verificar	Como testar	Onde encontrá-lo
Uma única ação ou etapa de IA isolada	Testar este nó	A aba de Teste dentro do painel lateral do nó
O fluxo de trabalho completo, de ponta a ponta	Executar teste de fluxo	O botão play (Test) na barra de comando superior

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ó do fluxo de trabalho e selecione o botão Executar (Testar). Há três seções:

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

   

2. Carregar valores de uma execução anterior: Um menu suspenso com execuções recentes deste 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 em tempo real 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.

Dica

A guia Teste lista automaticamente as saídas das etapas anteriores referenciadas pelas expressões deste nó. Se você adicionar um novo token ao nó, o campo correspondente aparecerá na próxima vez em que você abrir Test.

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 incluir saídas de uma de suas etapas anteriores porque essa etapa foi ignorada ou esse caminho não foi seguido, apenas os campos disponíveis serã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 mostra um estado ocupado enquanto a chamada está em andamento; a seção de Saída mostra um spinner, depois 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 executa seu fluxo de trabalho de ponta a ponta no ambiente de execução em produção.

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.

Tipo de acionador	O que acontece quando você seleciona Teste
Solicitação manual/HTTP	Uma caixa de diálogo se abre para você inserir as entradas de gatilho, então o fluxo de trabalho é executado imediatamente.
Recorrência/janela deslizante/consulta periódica	Ou a programação começa e a primeira execução começa automaticamente, ou, se já estiver instalado, o fluxo de trabalho roda uma vez.
Evento de Conector (por exemplo, quando um e-mail é recebido)	O fluxo de trabalho foi publicado e fica aguardando. Você pode ver Aguardando o acionamento.... Execute a ação no sistema de origem para disparar a execução.
Webhook HTTP	O fluxo de trabalho foi publicado; acione-o a partir do sistema externo, como você faria normalmente.

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: Seletor de arquivos. Os conteúdos são carregados como parte da execução.
• 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 Atividade à direita lista a execução atual no topo com um indicador de status: Em execução, Aguardando, Concluído com êxito, 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 Atividade também serve como histórico de execução do seu fluxo de trabalho:

• Filtre por Todos/Bem-sucedidos/Com falha/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

• Refinando um único passo de IA ou ação do conector? Use Teste este nó. É mais rápido, não faz publicação e permite simular apenas os valores de upstream que realmente importam.
• Validando comportamento de ponta a ponta ou lógica de acionamento? Use Executar teste de fluxo. Ele exercita todo o gráfico contra o tempo real de execução.
• Reproduzindo um problema de produção? Abra a execução com falha no painel de Atividade, depois abra o nó com falha e use Carregar valores da execução anterior na guia Teste para reproduzir os dados exatos das etapas anteriores na ação.

Valores de exemplo no seletor de tokens

Quando você escreve uma expressão que faz referência à saída de um passo a montante, o seletor de tokens mostra um valor de amostra ao lado de cada token para que você possa ver como são os dados reais desse passo. Os valores de amostra são extraídos automaticamente do teste mais recente concluído do seu fluxo de trabalho, então você não precisa escolher uma execução ou adicionar tokens manualmente.

O comportamento é o seguinte:

• Os valores de amostra aparecem na própria linha da saída de cada etapa anterior.
• Apenas as saídas bem-sucedidas da última execução concluída são mostradas. Etapas que foram puladas, não alcançadas ou falhadas não têm valor amostral.
• Se o fluxo de trabalho ainda não foi executado, ou se a última execução não incluir a etapa referenciada, nenhum valor de amostra aparece ao lado desse token.

Os valores de exemplo são dados de visualização apenas para leitura. Editar uma expressão não modifica a execução subjacente, e fechar o seletor não descarta nada.

Exclua um fluxo de trabalho gerado pelo chat do Copilot

Você pode criar um fluxo de trabalho descrevendo-o no chat do Copilot na página inicial ou no chat de build de um agente. Quando você faz isso, o chat exibe um cartão de artefato integrado à conversa para o fluxo de trabalho. Você pode excluir um fluxo de trabalho a partir do seu cartão, mesmo depois de ele ser publicado.

1. No cartão de artefato do fluxo de trabalho no chat, selecione o ... menu.

2. Selecione Delete workflow.

3. No diálogo Excluir este artefato , revise o nome do artefato e confirme.

4. Selecione Excluir.

O fluxo de trabalho é removido permanentemente. O histórico de execuções associado também é deletado.

O item Delete workflow só é ativado depois que o workflow é salvo e publicado. Enquanto o fluxo de trabalho ainda está salvo ou publicado, ou antes de ser publicado pela primeira vez, o menu mostra o item desativado com uma dica curta explicando o motivo. A exclusão é permanente—não é possível desfazer.