maestro
latest
false
Importante :
A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.
UiPath logo, featuring letters U and I in white

Guia do usuário do Maestro

Última atualização 19 de dez de 2025

Implementação de um processo simples

Visão geral

Iniciar no Maestro pode ser tão simples ou tão avançado quanto seu caso de uso exigir. Um processo simples pode envolver algumas etapas conectadas (como receber uma entrada, executar uma automação e retornar um resultado), ideais para provas de conceito rápidas ou fluxos de negócios diretos. Esta seção apresenta um fluxo simples para que você possa se acostumar com o básico.

Este guia demonstra como implementar um processo simples que destaca os principais recursos de orquestração por agentes: modelagem, implementação, depuração, publicação, implantação e gerenciamento.O processo não cobre a integração com outros produtos da UiPath. Para obter instruções sobre a configuração e implementação de dependências, como Data Fabric, Integration Service, Studio Web, Agents, Apps de ação do Action Center, consulte Instruções – Processo complexo.

O objetivo é criar o processo de roteamento simples semelhante ao da imagem a seguir:

docs image

Modelar um processo

Observação:
  • A configuração do projeto de processo com agentes está atualmente vinculada ao tenant. Certifique-se de permanecer no mesmo tenant entre as sessões de edição.
  • A configuração do projeto de processo com agente atualmente suporta apenas um arquivo de processo de negócios (.bpmn). Embora você possa adicionar vários arquivos ao projeto, isso leva a problemas inesperados para debugging e para a publicação.

Comece modelando o processo de ponta a ponta e, em seguida, configure os componentes.

Crie um processo por agente como um novo tipo de projeto do Studio.

  1. Navegue até seu tenant do Automation Cloud™.

  2. Na barra do lado esquerdo, na lista de produtos, selecione Maestro.

  3. Na página de destino do Maestro, selecione Iniciar modelagem.Seu novo processo com agente é aberto.

    Você também pode começar criando um novo Processo com agente no Studio Web.

    processo do tipo orquestração por agentes

  4. Clique com o botão direito do mouse para renomear o projeto para Processo simples e o processo para Processo simples. Seu processo com agente é, por padrão, parte de uma solução. Leia sobre soluções no guia do usuário do Studio Web.

    renomear processo simples

  5. Selecione o elemento inicial e clique em Adicionar: anotação de texto na caixa de ferramentas e digite Caminho da variável de entrada.

    Adicionar anotação de texto

  6. Selecione o elemento inicial e clique em Adicionar: evento intermediário na caixa de ferramentas.

    adicionar evento intermediário

  7. Selecione Alterar elemento na barra de ferramentas e selecione Evento de captura intermediário do temporizador e digite Atraso para o nome do evento intermediário.

    evento de captura intermediário do temporizador

  8. Selecione o elemento temporizador e clique em Adicionar: Gateway exclusivo na caixa de ferramentas e digite Qual caminho? para o nome do gateway.

    docs image

  9. Selecione o gateway, clique em Adicionar: tarefa e digite Uma tarefa para o nome.

    tarefa adicionar

    Os erros de validação são mostrados no canto inferior esquerdo da tela.

    problemas de validação

  10. Selecione o gateway novamente e clique em Adicionar: Tarefa e Tarefa do tipo B para o nome.

    qual caminho

  11. Selecione o gateway e expanda a primeira condição, ele terá um nome gerado começando poredge_Gateway_{randomcharacters} e tipo A para o rótulo. Expanda a segunda condição e digite B para o rótulo.

    Condições

    rótulos de condição

  12. É uma prática recomendada criar um fim explícito para seu processo. Para identificar rapidamente qual caminho o processo seguiu, crie um fim explícito para cada um. Selecione a tarefa A e clique em Adicionar: evento de fim na caixa de ferramentas e digite Fim A para o nome.

    Fim A

  13. Selecione a tarefa B e clique em Adicionar: evento de fim na caixa de ferramentas e digite Fim B para o nome.

    Fim B

Parabéns! Você agora criou seu primeiro processo BPMN de ponta a ponta!

Agora adicione alguns recursos ao processo.

Implementar um processo

Iniciar evento

  1. Selecione o elemento de início e, no painel de propriedades, digite Início manual para o Nome e, na seção Argumentos, selecione Adicionar novo para adicionar uma variável que possamos usar quando iniciarmos o processo.

    Propriedades do evento de início

  2. Configure a variável com esses valores e clique em Salvar. Uma variável de saída será criada automaticamente.

    • Nome: caminho
    • Type: String
    • Valor: A

    adicionar variável

    start_event_input_arguments

  3. Selecione o evento Atraso e abra o painel de propriedades e, na seção Temporizador, selecione Tipo=Duração e 5 segundos na configuração do valor.

    duration

  4. Selecione o gateway e expanda as Condições para inserir a condição para os caminhos Não e Sim e selecione o seletor de entrada de texto para abrir o editor de Expressão para inserir as condições.

    Editor de expressão

  5. Use Inserir variável para localizar e inserir a variável de saída de Início manual path.

    use_variable

    Defina o valor igual a "A" e selecione Salvar.

    inserir a variável A

  6. Abra o editor de Expressão para a condição B e insira o caminho da variável de saída de Início manual, defina o valor igual a "B" e clique em Salvar.

    docs image

    Ou você pode simplesmente copiar/colar as expressões abaixo no editor de expressão:

    • A

      vars.path == "A"
      vars.path == "A"
      
    • B

      vars.path == "B"
      vars.path == "B"
      

Parabéns! Você agora configurou totalmente seu primeiro processo.

Observação:

Você pode baixar o BPMN para uso em outros projetos clicando com o botão direito do mouse no nome do arquivo .bpmn .

Debug um processo

É possível configurar pontos de interrupção passando o mouse sobre o canto superior esquerdo de um elemento e selecionando Clicar para adicionar um ponto de interrupção. Atualmente, os pontos de interrupção só podem ser definidos quando você começar a depurar um processo. No entanto, eles são retidos entre as execuções. Leia sobre depuração e pontos de interrupção.

docs image

Debug direto

Primeiro, execute seu processo diretamente para garantir que você o configurou corretamente. Defina o valor padrão para sua variável path como A, então você deve vê-lo fluir até a tarefa A e Fim A.

  1. Selecione Debug para testar seu processo.

    painel de depuração

  2. Observe como cada etapa é executada. Navegue pelas seções Trilha de Execução e Variáveis Globais/Incidentes para visualizar detalhes adicionais.Depuração de processo simples

  3. Selecione Voltar para o modo de projeto para sair da depuração.

Depurar etapa por etapa

Execute seu processo passo a passo para que você possa manipular a variável path para testar a rota B.

  1. Selecione Debug passo a passo.

    debug_step_by_step

  2. Selecione Próxima etapa para mover a execução para o temporizador

    próxima etapa

  3. Atualize a Variável global path para a origem do evento Início manual para B. Selecione Enter ou tab para confirmar a alteração.

    Variáveis globais

  4. Selecione Atualizar 1 variável e Atualizar variáveis na próxima caixa de diálogo para confirmar as alterações.

  5. Selecione Continuar para finalizar a execução.

  6. Assista como cada etapa é executada. Navegue pelas seções Trilha de execução e Variáveis/incidentes globais para visualizar detalhes adicionais. Dessa vez, o processo segue a rota B.

    rota B do processo

  7. Selecione Voltar para o modo de projeto para sair da depuração.

.

Publicação e implantação de um processo simples

  1. Selecione Publicar.

  2. Escolha o Local e selecione Publicar.

    publicar solução

  3. Leia Publicação e atualização de processos com agentes para obter as etapas para publicar no Orchestrator.

Parabéns! Você agora publicou, implantou e iniciou totalmente seu primeiro processo.

Agora é hora de fazer o gerenciamento de instâncias de runtime.

Gerenciar um processo de negócios

  1. Do portal do Automation Cloud, navegue até o serviço do Maestro.

  2. Selecione Processo Simples na lista de processos para abrir a visualização Todas as instâncias para seu processo. Você pode usar pesquisa para filtrar a lista, se necessário.

    processo simples

  3. Selecione a instância mais recente para abrir o visualizador de instâncias. Você verá o processo sendo executado ao vivo em cada etapa (supondo que o temporizador de atraso de 5 segundos ainda esteja em execução).

    processo simples

Você pode clicar no plano de fundo do modelo para ver Variáveis globais e Histórico de ações , bem como a trilha de execução. Você pode clicar em um nó no modelo ou na Trilha de execução para inspecionar Detalhes e Variáveis para essa etapa de execução. Parabéns! Você agora gerenciou totalmente seu primeiro processo. Interrompa o processo para corrigi-lo.

Interromper e corrigir um processo

Nesse procedimento, causaremos uma falha na execução para usar o gerenciamento de instâncias com o objetivo de recuperar.

  1. Acesse o Orchestrator, a guia Automações na pasta Meu espaço de trabalho e localize Simple.Process na lista Processos.

  2. Selecione Iniciar um trabalho para a entrada Simple.Process, mas desta vez edite os Argumentos antes de começar a interrompê-lo.

  3. Selecione a aba Argumentos e edite a variável path . Defina o valor como C e selecione Salvar.

    caminho dos argumentos

  4. Selecione Iniciar.

  5. Navegue até o Maestro e selecione Processo simples na lista de Processos para abrir a visualização Todas as instâncias para seu processo.

    visualização de todas as instâncias

  6. Selecione a opção Qual caminho? do gateway para ver o erro Ausência de fluxo de saída para o gateway , que é de se esperar, uma vez que não temos configuração para path==”C”.

    errors

  7. Clique no contêiner da primeira etapa ou no segundo plano do modelo para visualizar as Variáveis globais.

    variáveis-globais

  8. Certifique-se de que o fluxo seguirá uma condição configurada atualizando a variável path da saída de Início manual (a segunda) para A.

    início manual C

  9. Selecione Atualizar 1 variável para atualizar a variável e adicione um comentário para fins de auditoria.

    Atualizar variáveis

  10. Selecione Tentar novamente, adicione um comentário e escolha Tentar novamente a instância para tentar novamente a etapa com a nova variável e ver a instância ser concluída.

    :::note
    You might need to refresh the page to see the instance complete.
    :::
    
    ![retry instance](https://dev-assets.cms.uipath.com/assets/images/maestro/maestro-retry-instance-597470-64bdf93f.webp)
    :::note
    You might need to refresh the page to see the instance complete.
    :::
    
    ![retry instance](https://dev-assets.cms.uipath.com/assets/images/maestro/maestro-retry-instance-597470-64bdf93f.webp)
    
  11. Consulte o Histórico da Ação para ver a trilha de auditoria de nossas alterações.

    histórico_da_ação

Parabéns! Você corrigiu com sucesso uma instância quebrada.

Migrar entre versões de um processo

A lógica de fluxo de processo atual não é suficientemente robusta para gerenciar todos os cenários de caminho. Você está abordando esse problema ao publicar uma nova versão do processo. Esta versão atualizada acomodará de forma eficaz não apenas novas instâncias de processos, mas também retificará instâncias problemáticas existentes. Para garantir que você lide com eficácia com todos os cenários em que path não é igual a A, modifique a rota B para uma rota Não A.

Neste procedimento, você irá provocar uma falha na execução a fim de corrigi-la com uma nova versão.

  1. Navegue para o Orchestrator.
  2. Acesse Meu espaço de trabalho.
  3. Acesse a aba Automações e localize Simple.Process na lista Processos.
  4. Selecione Iniciar um trabalho para a entrada Simple.Process e escolha Iniciar.
  5. Selecione a aba Argumentos e edite a variável path .
  6. Defina o valor como C e escolha Salvar.
  7. Selecione Iniciar.

Agora corrija seu processo para que você possa migrar essa instância quebrada.

  1. Abra seu processo simples no UiPath Studio.

  2. Selecione a etapa gateway exclusivo Qual caminho? gateway e abrir o painel de propriedades.

  3. Altere o rótulo B para Não A e altere a condição para vars.path != A

    caminho do vars

  4. Altere o nome da tarefa B para tarefa Não A.

  5. Altere o nome do evento final Fim B para Fim Não A.

  6. Clique em Publicar, selecione o Feed do Espaço de Trabalho Pessoal do Orchestrator e clique em Publicar.

Agora migre sua instância quebrada para a nova versão.

  1. Navegue até o Maestro, selecione Instâncias de processo e escolha Processo Simples na lista de Processos para abrir a visualização Todas as instâncias para seu processo.

  2. Clique na instância mais recente para abrir o visualizador de instâncias. Você verá que o processo está em um estado de falha em Qual caminho? gateway.

    Observação:

    Pode ser necessário clicar no botão atualizar para a lista ver a instância mais recente.

  3. Selecione Migrar, escolha a versão de destino para o processo que você acabou de publicar (deve ser 1.0.1, mas pode ser diferente para você), forneça um comentário e selecione Migrar instância.

    Migrar instância

  4. Selecione Tentar novamente, adicione um comentário e clique em Tentar novamente a instância para repetir a etapa com a nova variável e observar a conclusão da instância.

    Observação:

    Pode ser necessário atualizar a página para ver a instância concluída.

    repetir instância

  5. Observe o Histórico de ações para ver a trilha de auditoria para suas alterações.

Parabéns! Você migrou com sucesso uma instância quebrada para uma nova versão do processo!

Processo final

É assim que o processo final se parece:

processo final

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo
Confiança e segurança
© 2005-2025 UiPath. Todos os direitos reservados.