Editar e gerenciar o fluxo de trabalho do agente no designer

Para exibir um fluxo de agente ou fluxo de trabalho no designer, abra Copilot Studio, selecione Flows, selecione o fluxo e selecione a guia Build.

Para exibir um fluxo de agente no designer, abra Copilot Studio, selecione Flows, selecione o fluxo e selecione a guia Designer.

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.

Legenda:

1. Expandir/Recolher: expanda ou recolha todos os grupos de ações. Por exemplo, se uma ação tiver várias condições, selecione esse ícone para mostrar os detalhes da condição.
2. Ampliar: aumente o tamanho do fluxo na tela.
3. Reduzir: diminua o tamanho do fluxo na tela.
4. Ajustar exibição: redimensione a exibição para ajustar todo o fluxo na tela.
5. Minimapa: navegue até uma seção específica de um fluxo grande.
6. Pesquisar: procure uma operação em seu fluxo.

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ê deseja que seu fluxo execute ou conector que você deseja adicionar e selecione-a 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.

1. Abaixo do cartão em que você deseja adicionar a ação, selecione Inserir uma nova ação. O painel Adicionar uma ação é aberto.

2. Em Adicionar ação, comece a digitar a ação que deseja que seu fluxo execute e selecione-a 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-a no seu fluxo e depois selecione os três pontos (⋮) >Delete. Para confirmar a exclusão, selecione OK.

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.

Para exibir os parâmetros de um gatilho ou uma ação no fluxo de agente, selecione o respectivo cartão. O painel de configuração é aberto com a guia Parâmetros por padrão. 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.

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 no fluxo completo, abra a faixa do centro de saúde. Para exibir os detalhes de erros individuais, selecione o erro.

Os erros nas ações de fluxo do agente 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, no menu na parte superior do tela, selecione Verificador de fluxo. Para exibir os detalhes de erros individuais, selecione o erro. Como alternativa, selecione Abrir operação para abrir a operação no painel Verificador de Fluxo e corrigir o erro.

As execuções de teste permitem verificar uma etapa ou um fluxo inteiro sem sair do designer, usando dados upstream reais, valores que você mesmo simula ou saídas 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. Carregar valores da execução anterior: uma lista suspensa de execuções recentes desse fluxo. 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 selo à direita de cada linha mostra o tipo esperado do campo (cadeia de caracteres, email, data e hora, número etc.).

4. Saída: o resultado em tempo real do teste mais recente, formatado de acordo com o tipo de nó (JSON, resultado de prompt, resposta de conector, etc.).

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 o fluxo tiver sido executado antes, você poderá reproduzir dados reais em vez de digitá-los em:

1. Na lista suspensa Carregar valores de execução anterior, escolha uma execução. Cada entrada é identificada com a data/hora e o status da execução (por exemplo, 24 de abril, 09:12 — Concluído).

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 resultados para uma de suas etapas anteriores (porque essa etapa foi ignorada ou o caminho não foi tomado), só os campos que estiverem disponíveis serão preenchidos. O resto dos campos permanecem como estavam.

Se o fluxo não tiver sido executado antes, nenhuma execução anterior disponível será exibida e a lista suspensa ficará oculta.

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 dispara o restante do fluxo.

Testar todo o fluxo

Na barra de comandos superior, selecione o botão Reproduzir (Teste). Ao testar, seu fluxo é executado de ponta a ponta no ambiente de execução ao vivo.

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

1. Salva e publica o fluxo caso haja 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, a caixa de diálogo Inserir entradas de gatilho manual renderiza um campo por entrada que você definiu 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 (o conteúdo é carregado 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 com essas entradas ou Cancelar para ignorar sem executar. 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.

A caixa de diálogo é exibida sempre 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 (lado direito) mostra a execução atual no topo com um emblema de status: Executando, Aguardando, Bem-sucedido, Com Falha 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 funciona como o histórico de execução do fluxo:

• Filtrar por Todos/ Bem-sucedido/Com Falha/Executando usando a lista suspensa na parte superior.
• 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 uma única etapa de IA ou ação do conector?: teste este nó. É mais rápido, não publica e permite que você simule apenas os valores anteriores no fluxo que importam.
• Validando o comportamento de ponta a ponta ou a lógica de gatilho?: Executar o Teste de Fluxo. Ele exerce todo o grafo em relação ao tempo de execução real.
• Reproduzindo um problema de produção?: Abra a execução com falha do painel Atividade e, em seguida, abra o nó com falha e use Carregar valores da execução anterior em sua aba Teste para replicar exatamente os dados upstream na ação.

Só porque seu fluxo não tem erros e pode ser publicado, não significa que ele fará o que você deseja. Depois de publicar o fluxo do agente, teste o fluxo para garantir que ele funcione conforme o esperado.

É possível fazer um teste manual ou automaticamente. Após a execução do teste, você pode verificar a saída de cada ação para confirmar se o fluxo está funcionando.

1. Salve e publique seu fluxo.

2. No menu na parte superior da tela, selecione Testar. O painel Testar Fluxo é aberto.

3. Selecione se deseja executar o teste Manualmente ou Automaticamente.

4. No painel Fluxo de Execução, selecione Testar>Fluxo de Execução. Uma marca de verificação verde indica que o fluxo foi concluído com sucesso.

5. Selecione Concluído.

O teste de um fluxo de agente no designer não consome a capacidade do Copilot Studio.