Run Agent

Importante:

Essa era uma atividade de visualização, disponível a partir da versão 25.2.2 do pacote de atividades System. A partir da versão 25.4.2, desde então, foi substituída permanentemente pela atividade Run Job . Você ainda encontrará "Run Agent" como resultado de pesquisa ao pesquisar por ele, mas agora adicionará a atividade Run Job .

UiPath.Activities.System.Agentic.RunAgent

Description

A atividade Run Agent inicia a execução de um processo predefinido em um agente designado. O Run Agent pode receber argumentos de entrada, pode ser suspenso, fornece saídas e permite interações futuras com sua saída.

Importante:

• Os agentes devem estar na pasta do Orchestrator antes de configurar essa atividade.

• Após atualizar um agente, certifique-se de republicá-lo e reimplantar o processo correspondente na pasta do Orchestrator.

Compatibilidade do projeto

Windows | Multiplataforma

Windows, configuração multiplataforma

• Propriedades do corpo da atividade:

  Caminho da pasta do Orchestrator

  Selecione a pasta do Orchestrator onde o agente que você deseja executar está implantado. No menu suspenso, serão exibidas apenas as pastas que você pode acessar. Se você não selecionar uma opção, seu Espaço de trabalho pessoal será usado.

  Nome do processo

  Selecione o processo associado ao agente que você deseja executar. Os processos baseados em agentes são exibidos. Se o agente necessário não estiver listado, selecione Gerenciar processos a serem redirecionados para sua pasta no Orchestrator, onde você pode adicionar o processo baseado em agente ausente.

  Entrada

  Depois de selecionar um processo baseado em agente, o campo Entrada será exibido. Selecione-o para abrir a janela de Mapeamento de dados, onde você pode fornecer valores para os argumentos de entrada do processo. Para recuperar a lista mais recente de argumentos de processo, selecione Atualizar argumentos no lado direito do campo.

  Importante:

  Para uma melhor experiência, certifique-se de usar a versão mais recente do Studio (2025.0.161). Versões do Studio anteriores à 2025.0.161 usam a janela Editor de Expressão .

  O fragmento de código a seguir mostra como fornecer valores para os argumentos de entrada do agente usando VB.NET e C#:

  'VB.NET
  New Email_Rewriter_Input() With {
      .feedback = "sample feedback", 
      .originalEmail = "sample email content"
  }

  //C#
  new Email_Rewriter_Input {
      feedback = "sample feedback",
      originalEmail = "sample email content"
  }

• Painel de propriedades:

  Continuar com erro

  Especifique se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Como resultado, se o campo não estiver configurado e ocorrer um erro, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.

  Saída

  Exibe a lista de argumentos de saída para o processo baseado em agente, conforme definido durante a criação do agente.

  Se um argumento de saída for do tipo Objeto, você poderá acessar suas subpropriedades. Por exemplo, se você tiver um objeto chamado "PaymentDetail" com propriedades como "DueDate", "Amount" e "Approver", poderá acessá-las assim: PaymentDetail.Amount, PaymentDetail.DueDate, PaymentDetail.Approver.