Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Note
As funcionalidades deste artigo são suportadas pelo GitHub Copilot harness, que utiliza créditos do Copilot para faturação com base na utilização. Saiba mais sobre os Créditos Copilot na Visão Geral da faturação para agentes alimentados pelo arnês GitHub Copilot.
A faturação baseada no uso aplica-se à utilização, construção, teste e avaliação de agentes. Estas ações podem consumir Créditos Copilot.
Os fluxos de trabalho são criados e editados no visual designer redesenhado no Copilot Studio. O designer fornece uma tela onde pode construir ou editar uma automação, adicionar e remover ações, verificar erros e publicar o seu fluxo de trabalho sem sair do designer.
Mostrar um fluxo de trabalho no designer
Para apresentar um fluxo de trabalho no designer, abra o Copilot Studio, selecione Workflows, selecione o fluxo de trabalho e, em seguida, selecione o separador Build.
Mude a forma como o seu fluxo de trabalho é apresentado
Dependendo do tamanho e complexidade do seu fluxo de trabalho, pode querer ajustar a forma como é apresentado para facilitar o trabalho. A barra de ferramentas no canto inferior esquerdo da tela controla a exibição.
Legenda:
- Amplie: Aumente o tamanho do fluxo de trabalho na tela.
- Afastar o zoom: Diminuir o tamanho do fluxo de trabalho na tela.
- Vista de ajuste: Redimensione a vista para que o fluxo de trabalho completo caiba na tela.
- Arrumação: Reorganize o fluxo de trabalho e os ramos para uma visão mais limpa de ponta a ponta.
- Layout vertical: Mude para uma vista de layout vertical do fluxo de trabalho.
Adicionar e remover ações
No cartão após o qual deseja adicionar uma ação, selecione Adicionar um passo. O painel de Adicionar abre-se.
Em Adicionar, começa a escrever a ação que queres que o teu fluxo de trabalho execute ou o conector que queres adicionar, e depois seleciona-o da lista. Dependendo da sua seleção, talvez seja necessário fornecer informações adicionais para concluir a ação.
Se determinar que uma ação não é necessária, selecione o ícone Delete no canto superior direito da ação.
Verifique os parâmetros do fluxo de trabalho
Para visualizar os parâmetros de um gatilho ou ação no seu fluxo de trabalho, selecione o cartão dele. O painel de configuração abre-se do lado direito. Para inserir um valor para um parâmetro, selecione uma opção na lista suspensa ou insira uma expressão para definir o valor dinamicamente.
Verificar se existem erros
Erros nas ações do fluxo de trabalho são indicados a 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 visualizar os detalhes de erros individuais, selecione o erro.
Important
Não podes publicar um fluxo de trabalho se este contiver erros. Deve corrigir todos os erros antes de o poder publicar.
Publique o seu fluxo de trabalho
Se o seu fluxo de trabalho não tiver erros, pode publicá-lo. No menu no topo da tela, selecione Publicar.
Testar o fluxo de trabalho
As execuções de teste permitem verificar um passo ou um fluxo de trabalho completo sem sair do editor, utilizando dados reais provenientes de etapas anteriores, valores simulados por si ou saídas de uma execução anterior.
Existem duas formas de realizar um teste:
| O que queres verificar | Como testar | Onde encontrar |
|---|---|---|
| Uma única ação ou passo da IA isoladamente | Teste este nó | A aba de teste no painel lateral do nó |
| O fluxo de trabalho completo, de ponta a ponta | Executar o teste de fluxo | O botão Play na barra de comandos 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
Abre qualquer ação ou nó no teu fluxo de trabalho e seleciona o botão de Reproduzir ou Testar. Existem três secções:
Teste de execução/reset: Executa a etapa sob demanda, ou limpa as entradas atuais e a saída atual.
Valores de carga das execuções anteriores: Um menu desclassificante das execuções recentes deste fluxo de trabalho. Escolher um retira as saídas a montante dessa execução para os campos de entrada abaixo.
Entradas: Um campo editável por passo a montante que fornece as referências do nó. O emblema à direita de cada linha mostra o tipo esperado do campo (string, email, data-hora, número, e assim por diante).
Saída: O resultado em tempo real do teste mais recente, formatado para o tipo de nó.
Entradas simuladas
Por defeito, os campos de entrada estão em branco. É possível:
- Digite qualquer valor diretamente num campo. O campo aceita o tipo indicado no emblema direito.
- Deixa um campo vazio se o teu passo não depender disso.
Tip
A aba Teste lista automaticamente as saídas das etapas 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 Test.
Carregar valores de uma execução anterior
Se o seu fluxo de trabalho já foi executado antes, pode reproduzir dados reais em vez de os escrever:
No menu suspenso Load values from previous run, escolha uma execução.
O designer obtém as saídas de etapas dessa execução e aplica-os ao esquema de entrada do seu nó. Os valores correspondentes são escritos nos campos de entrada.
Edita qualquer campo depois se quiseres ajustar o cenário.
O menu suspenso mostra as 10 edições mais recentes de qualquer estado. Se uma execução não incluir as saídas de uma das suas etapas anteriores porque essa etapa foi ignorada ou esse caminho não tiver sido seguido, só são preenchidos os campos disponíveis. Os restantes mantêm-se como estavam.
Se o fluxo de trabalho não foi executado antes, Nenhuma execução anterior disponível é exibida e o menu suspenso fica oculto.
Executar o teste
Selecione Executar teste. O botão mostra um estado ocupado enquanto a chamada está em andamento; a secção de Saída mostra um spinner, depois o resultado ou um erro.
- O teste de reset apaga tanto as entradas como a última saída.
- O teste executa o nó isoladamente contra a API do conector. O teste não desencadeia o resto do fluxo de trabalho.
Testa todo o fluxo de trabalho
Na barra de comandos superior, selecione o botão play (Test). Teste o seu fluxo de trabalho de ponta a ponta no ambiente de execução ativo.
Antes do início da corrida, o designer:
- Guarda e publica o fluxo de trabalho se tiveres alterações não guardadas, ou se for a primeira vez.
- Instala quaisquer novas ligações na primeira execução.
- Desencadeia a corrida. O caminho depende do tipo de gatilho.
| Tipo de acionador | O que acontece quando selecionas Testar |
|---|---|
| Manual / Pedido HTTP | Abre-se uma caixa de diálogo para introduzir os dados de entrada do acionador; de seguida, o fluxo de trabalho é executado imediatamente. |
| Recorrência/janela deslizante/sondagem | Ou o horário começa e a primeira execução arranca automaticamente, ou, se já estiver instalado, o fluxo de trabalho é executado uma vez. |
| Evento de ligação (por exemplo, quando chega um email) | O fluxo de trabalho foi publicado e fica em espera. Podes ver À espera do gatilho.... Execute a ação no sistema de origem para lançar a sequência. |
| Webhook HTTP | O fluxo de trabalho é publicado; Ativa-o a partir do sistema externo, como normalmente farias. |
Entradas simuladas (acionamento 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: Controlo de entrada apropriado.
- Booleano: Interruptor de alavanca.
- Escolha única (enum): Menu deslizante.
- Multi-seleção: Seleção múltipla do menu suspenso.
- Ficheiro: Seletor de ficheiros. Os conteúdos são carregados como parte da execução.
- Objeto/array: Área de texto multilinha onde pode colar JSON.
Selecione Executar para iniciar o fluxo de trabalho com esses dados, ou Cancelar para fechar sem o executar. Os campos obrigatórios estão marcados com um asterisco. Se os valores estiverem em falta ou inválidos, aparecem mensagens de validação em linha e a execução é bloqueada até serem corrigidas.
O diálogo aparece sempre que selecionas Testar. Os valores não são guardados entre corridas, por isso podes tentar rapidamente diferentes cenários.
Assistir à corrida
Uma vez que uma corrida está em voo:
- A barra de comandos mostra um botão Cancelar enquanto a corrida está ativa.
- O painel de Atividade à direita lista a corrida atual no topo com um emblema de estado: Em Curso, À Espera, Bem-sucedido, Falhado ou Cancelado. Selecione qualquer execução para a abrir na tela e inspecione as entradas e saídas de cada passo.
Temporadas selecionadas anteriores
O painel de Atividades serve também como o histórico de execuções do seu fluxo de trabalho:
- Filtre por Todos/Com êxito/Falhou/Em execução utilizando a lista pendente no topo.
- Selecione Atualizar para recuperar a lista.
- Selecione Carregar Mais no final para recuar mais na página.
- Selecionar uma execução carrega-a na tela, onde cada nó mostra as entradas que recebeu e as saídas que produziu nessa execução. Os dados são os mesmos que o separador de Teste ao nível do nó utiliza quando se escolhe uma execução no menu pendente.
Quando usar cada tipo de teste
- Iterar com base num único passo de IA ou numa ação de conector? Use Teste este nó. É mais rápido, não publica e permite-te simular apenas os valores a montante que importam.
- Validar o comportamento end-to-end ou a lógica de acionamento? Utilize Executar teste de fluxo. Exerce todo o gráfico contra o tempo de execução real.
- Reproduzir um problema de produção? Abra a execução falhada a partir do painel de Atividade, depois abra o nó que falha e use valores de carregamento da execução anterior no separador de Teste para reproduzir os dados exatos a montante na ação.