Editar e gerir o fluxo de agente ou fluxo de trabalho no estruturador

Tanto os fluxos de agente quanto os fluxos de trabalho são criados e editados em estruturadores visuais no Copilot Studio. Os novos fluxos de trabalho, agora em pré-visualização pública, utilizam um estruturador visual redesenhado, enquanto os fluxos de agente usam o estruturador visual original. Ambos os estruturadores visuais fornecem uma tela onde pode continuar a criar ou editar uma automatização. Adicione e remova ações, verifique erros e publique o seu fluxo, tudo sem sair do estruturador. Também pode ajustar a forma como o fluxo de agente ou o fluxo de trabalho é apresentado, para se poder concentrar em áreas específicas.

Importante

Este artigo contém documentação de pré-visualização do Microsoft Copilot Studio e está sujeito a alterações.

As funcionalidades de pré-visualização não se destinam à produção e poderão ter caraterísticas restritas. Estas funcionalidades estão disponíveis antes de uma versão oficial para que possa aceder antecipadamente e enviar comentários.

Se está a criar um agente pronto para produção, consulte Descrição Geral do Microsoft Copilot Studio.

Para apresentar um fluxo de agente ou um fluxo de trabalho no estruturador, abra o Copilot Studio, selecione Fluxos, selecione o fluxo e, em seguida, selecione o separador Criar.

Captura de ecrã do estruturador do Copilot Studio a mostrar um fluxo de trabalho publicado com um acionador e várias ações.

Mudar a forma como o fluxo é apresentado

Consoante o tamanho e a complexidade do fluxo de agente ou do fluxo de trabalho, convém ajustar a forma como o fluxo é apresentado para facilitar o trabalho. A barra de ferramentas no canto inferior esquerdo da tela controla a vista.

Captura de ecrã da barra de ferramentas de opções de visualização no estruturador do Copilot Studio, com avisos numerados de 1 a 6.

Legenda:

  1. Ampliar: aumentar o tamanho do fluxo de trabalho na tela.
  2. Reduzir: diminua o tamanho do fluxo de trabalho na tela.
  3. Ajustar vista: redimensione a vista para ajustar o fluxo de trabalho completo à tela.
  4. Organizar: Reorganizar o fluxo de trabalho e os ramos para obter uma vista ponto a ponto mais clara.
  5. Esquema vertical: mude para uma vista de esquema vertical do fluxo de trabalho.

Adicionar e remover ações

  1. No cartão ao qual pretende adicionar a ação, selecione Adicionar um passo. O painel Adicionar é aberto.

  2. Em Adicionar, comece a escrever a ação que pretende que o seu fluxo execute ou o conector que pretende adicionar e, em seguida, selecione-o na lista. Dependendo da sua seleção, poderá ser necessário fornecer informações adicionais para concluir a ação.

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

Verificar parâmetros de fluxo

Para ver os parâmetros de um acionador ou uma ação no seu fluxo de trabalho, selecione o respetivo cartão. O painel de configuração é aberto no lado direito. Para introduzir um valor para um parâmetro, selecione uma opção na lista pendente ou introduza uma expressão para definir o valor dinamicamente.

Ver histórico de versões dos fluxos de agente

Um histórico de versões é registado no Microsoft Dataverse à medida que cria ou modifica um fluxo de agente. Para compreender como um fluxo de agente evoluiu, reveja o respetivo histórico de versões. As versões de fluxo são agrupadas por data, com indicadores para a versão mais recente, versão publicada e versões publicadas anteriormente.

O histórico de um fluxo baseia-se em versões guardadas, por isso é boa ideia guardar rascunhos antes de concluir o fluxo.

Para utilizar o painel de histórico de versões, deve guardar o seu fluxo de agente pelo menos uma vez.

  1. No menu no topo da tela, selecione Histórico de versões.

  2. Para ver as versões registadas do fluxo, expanda um item na lista.

  3. Para apresentar a versão no estruturador, selecione-a na lista.

Verificar se existem erros

Os erros nas ações do fluxo de trabalho estão indicados a vermelho. Para ver detalhes de um erro numa ação, selecione o erro. Para listar todos os erros em todo o fluxo, abra a barra do centro de estado de funcionamento. Para ver os detalhes de erros individuais, selecione o erro.

Importante

Não pode publicar um fluxo se este contiver erros. É necessário corrigir todos os erros antes de publicar o fluxo.

Publicar o fluxo de trabalho

Se o seu fluxo de trabalho não tiver erros, pode publicá-lo. Para publicar o seu fluxo, no menu no topo da tela, selecione Publicar.

Testar o fluxo de agente ou o fluxo de trabalho

As execuções de teste permitem verificar um passo ou um fluxo completo sem sair do estruturador, utilizando dados reais a montante, valores simulados por si ou saídas de uma execução anterior.

Existem duas formas de executar um teste:

O que pretende verificar Como testar Onde o encontrar
Uma única ação ou passo de IA isoladamente Testar este nó O separador Teste no painel lateral do nó
O fluxo completo, ponto a ponto Executar teste de fluxo O botão Reproduzir na barra de comando superior

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

Testar um único nó num fluxo de trabalho

Abra qualquer ação ou nó no seu fluxo de trabalho e selecione o botão Reproduzir ou Testar. Existem três secções:

  1. Teste de Execução/Reposição: executa o passo a pedido ou limpa as entradas e a saída atuais.

    Captura de ecrã do painel de teste do nó que mostra as secções Entradas, Configurar e Saída com o botão Testar realçado.

  2. Carregar valores da execução anterior: um menu pendente com as execuções recentes deste fluxo. Escolher uma extrai as saídas do passo a montante dessa execução para os campos de entrada abaixo.

  3. Entradas: um campo editável por saída do passo a montante que o nó referencia. O destaque à direita de cada linha mostra o tipo esperado do campo (cadeia, e-mail, data-hora, número, etc.).

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

Entradas simuladas

Por predefinição, os campos de entrada estão em branco. Pode:

  • Escreva qualquer valor diretamente num campo. O campo aceita o tipo indicado no destaque do lado direito.
  • Deixar um campo vazio se o seu passo não depender dele.

Captura de ecrã do painel de teste do nó que mostra campos de entrada em branco com destaques de tipo à direita.

Sugestão

O que aparece aqui? O separador Teste lista automaticamente as saídas do passo a montante que as expressões deste nó referenciam. Se adicionar um novo token ao nó, o campo correspondente aparece da próxima vez que abrir Testar.

Carregar valores de uma execução anterior

Captura de ecrã do menu pendente Carregar valores da execução anterior, que mostra as execuções anteriores com etiquetas de data, hora e estado.

Se o fluxo tiver sido executado anteriormente, pode reproduzir dados reais em vez de escrevê-los:

  1. No menu pendente Carregar valores da execução anterior, escolha uma execução. Cada entrada é identificada com a data/hora e o estado da execução (por exemplo, 24 de abril, 09:12 — Bem-sucedido).

  2. O estruturador obtém as saídas dos passos dessa execução e projeta-as através do esquema de entrada do nó. Os valores correspondentes são escritos nos campos de entrada.

  3. Edite qualquer campo posteriormente, caso queira ajustar o cenário.

O menu pendente mostra as 10 execuções mais recentes de qualquer estado. Se uma execução não incluir as saídas para um dos seus passos a montante (porque esse passo foi ignorado ou o caminho não foi seguido), apenas os campos disponíveis são preenchidos. O resto dos campos mantêm-se como estavam.

Se o fluxo não tiver sido executado anteriormente, a opção Não há execuções anteriores disponíveis é apresentada e o menu pendente fica oculto.

Executar o teste

Selecione Executar teste. O botão mostra um estado ocupado enquanto a chamada está em curso; a secção Saída mostra um ícone de progresso e, em seguida, o resultado ou um erro.

  • Repor teste limpa tanto as entradas como o último resultado.
  • O teste executa o nó de forma isolada em relação à API do conector. O teste não aciona o resto do fluxo.

Testar o fluxo completo

Na barra de comando superior, selecione o botão Reproduzir (Testar). Esta opção executa o seu fluxo ponto a ponto no runtime em direto.

Antes de a execução ser iniciada, o estruturador:

  1. Guarda e publica o fluxo se tiver alterações não guardadas (ou se for a primeira vez).
  2. Instala quaisquer novas ligações na primeira execução.
  3. Aciona a execução. O caminho depende do tipo de acionador.
Tipo de acionador O que acontece quando seleciona Testar
Manual / pedido HTTP É aberta uma caixa de diálogo para introduzir as entradas do acionador e, em seguida, o fluxo é executado imediatamente.
Periodicidade/janela deslizante/consulta Ou o agendamento é iniciado e a primeira execução arranca automaticamente ou, se já estiver instalado, o fluxo é executado uma vez.
Evento de conector (por exemplo, quando é recebido um e-mail) O fluxo é publicado e fica em espera. Pode ver A aguardar pelo acionador…. Execute a ação no sistema de origem para acionar a execução.
Webhook HTTP O fluxo está publicado; acione-o a partir do sistema externo como habitualmente faz.

Entradas simuladas (acionador manual)

Para acionadores manuais, a caixa de diálogo Introduzir entradas do acionador manual compõe um campo para cada entrada definida no acionador:

  • Texto/número/e-mail/data: controlo de entrada adequado.
  • Booleano: botão de ativar/desativar.
  • Escolha única (enumeração): lista pendente.
  • Seleção múltipla: menu pendente de seleção múltipla.
  • Ficheiro: Seletor de ficheiros (o conteúdo é carregado como parte da execução).
  • Objeto/matriz: Área de texto multilinha onde pode colar JSON.

Selecione Executar para iniciar o fluxo com essas entradas ou Cancelar para dispensar sem executar. Os campos obrigatórios estão marcados com um asterisco. Se estiverem em falta valores ou forem inválidos, aparecem mensagens de validação inline e a execução é bloqueada até serem corrigidos.

A caixa de diálogo aparece sempre que seleciona Testar. Os valores não são guardados entre execuções, permitindo experimentar rapidamente diferentes cenários.

Observar a execução

Quando uma execução está em curso:

  • A barra de comando mostra um botão Cancelar enquanto a execução está ativa.
  • O painel de Atividade (lado direito) lista a execução atual no topo com um destaque de estado: Em execução, A aguardar, Com Êxito, Falhada ou Cancelada. Selecione qualquer execução para a abrir na tela e inspecionar as entradas e saídas de cada passo.

Selecionar execuções anteriores

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

  • Filtre por Todos / Com êxito / Falhados / Em execução utilizando o menu pendente no topo.
  • Selecione Atualizar para voltar a obter a lista.
  • Selecione Carregar Mais na parte inferior para ver execuções mais antigas.
  • Selecionar uma execução carrega-a na tela, onde cada nó apresenta as entradas que recebeu e as saídas que produziu nessa execução. Os dados são os mesmos que o separador Testar, ao nível do nó, utiliza quando escolhe uma execução no respetivo menu pendente.

Quando utilizar cada tipo de teste

  • A iterar num único passo de IA ou numa ação de conector?: Teste este nó. É mais rápido, não publica e permite simular apenas os valores a montante relevantes.
  • Validar o comportamento ponto a ponto ou a lógica de acionador?: Execute o teste de fluxo. Testa o grafo completo no runtime real.
  • A reproduzir um problema de produção?: Abra a execução falhada a partir do painel Atividade, depois abra o nó falhado e utilize Carregar valores da execução anterior no separador Testar para reproduzir os dados exatos a montante na ação.

Conteúdos relacionados

  • Last updated on