Criação de escalonamentos de agentes com aplicativos do Action Center

Terminologia:

• Agentes: com recursos alimentados por tecnologias como modelos de linguagem abrangente (LLMs), machine learning e automação empresarial tradicional, os agentes são projetados para operar em ambientes dinâmicos e não determinísticos. Eles podem planejar, agir, aprender e adaptar, tornando-os ideais para processos que exigem julgamento, flexibilidade e consciência contextual. Ao contrário de sistemas determinísticos, como robôs RPA, que seguem lógica estruturada e regras fixas, os agentes usam uma abordagem probabilística para tomar decisões com base em padrões e dados em tempo real. Isso torna os agentes altamente adequados para automatizar fluxos de trabalho não estruturados e com muitas exceções, onde as condições e os resultados variam.
• Aplicativos de ação: um tipo de aplicativo projetado no UiPath App Studio ou diretamente no Studio Web, permitindo que você crie formulários ou interações de interface gráfica com opções específicas para tarefas que requerem intervenção humana (tarefas do Action Center), como aprovações. Você pode definir as propriedades de entrada e saída de aplicativos de ação adicionando propriedades de ação no esquema de ação. Além do App Designer no UiPath App Studio e no Studio Web, você também pode criar a interface da tarefa como um aplicativo de ação codificada— um aplicativo React ou Angular personalizado desenvolvido como código no IDE de sua escolha.

Observação:

Você só pode usar aplicativos publicados e implantados para configurar os escalonamentos do agente.

Pode haver situações em que os agentes enfrentam desafios ou exigem intervenção humana para avaliar, confirmar ou fornecer detalhes essenciais. Isso pode ser uma ação deliberada, onde certas etapas são sempre atribuídas a um humano antes de fazer a transição de volta para um agente. Alguns exemplos em que os escalonamentos podem ser necessários são os seguintes: uma chamada de ferramenta pode falhar inesperadamente ou retornar dados de uma estrutura inesperada, pode precisar de ajuda para diferenciar entre vários clientes com o mesmo nome em um aplicativo de terceiros ou pode ter baixa confiança em uma ação. Também pode haver motivos organizacionais para que eles não sejam confiáveis para tomar certos tipos de decisão ou realizar certas ações.

Em todos esses casos, os agentes precisam poder escalonar para um humano e:

1. Exiba todos os detalhes relevantes de maneira eficaz, direta e personalizável.
2. Permita que o Human-In-The-Loop (HITL) forneça a decisão ou informações relevantes, seja por meio de uma simples decisão de Aprovação/Recusa para um caso ou fornecendo vários detalhes do negócio - emails, números de pedido ou referências a contas em plataformas externas.

Os agentes podem até precisar que uma de suas ferramentas seja corrigida antes que eles possam continuar a operação em um caso de negócios. Você pode usar a ferramenta Guardrails para gerenciar automaticamente chamadas de ferramentas irregulares. Para obter mais informações, acesse Proteções. Ao criar escalonamentos para diretrizes, você pode usar o seguinte modelo do UiPath Marketplace: Aplicativo de Escalonamento de Guardrails da Ferramenta do Agente.

O que são escalonamentos?

Escalonamentos são ferramentas usadas para envolver usuários no processo em execução de um agente. Os escalonamentos são usados para avaliar ou validar as decisões de um agente ou fornecer informações que o agente pode não ter. Portanto, os humanos ainda têm um papel vital na manutenção da integridade e proficiência de um agente. Você pode definir condições para escalonamentos específicos por meio das seguintes configurações:

• Solicitação do sistema ou do usuário: defina o objetivo do agente e deixe claro quando usar um escalonamento específico.
• Escalonamento — no componente de escalonamento, selecione um aplicativo de Ação projetado para uma circunstância específica. Ao dar ao aplicativo de ação uma descrição e um nome exclusivos, o agente pode entender melhor qual escalonamento deve usar e quando, juntamente com as instruções do sistema e do prompt do usuário. Você pode adicionar vários escalonamentos a um único agente. Você pode atribuir vários escalonamentos a um agente e adicionar uma descrição a cada entrada, permitindo que o agente envie valores apropriados para o aplicativo Action. Todas essas configurações afetam significativamente a eficácia e a pontuação de integridade geral do agente. Para obter mais informações sobre a pontuação de um agente, acesse Pontuação dos agentes.

Importante:

Os escalonamentos não são determinísticos, o que significa que o agente usa as instruções fornecidas para decidir quando e o que escalonar. Se você precisar de um escalonamento consistente e determinístico, é recomendável usar um aplicativo de Ação fora do agente. Em vez disso, você encerraria o agente e usaria suas saídas em uma ação do aplicativo. Certifique-se de considerar estas recomendações, de acordo com seus casos de uso.

1. Crie um aplicativo de Ação

Primeiro, é necessário criar e configurar um novo aplicativo do Action Center. As etapas neste procedimento mostram como criar um aplicativo que aprova os resultados da pesquisa. Você pode adaptar essas etapas para seus casos de uso específicos.

Observação:

Você pode configurar escalonamentos de agentes apenas usando apps de ação. Para aplicativos criados usando o Apps Designer, recomendamos que você use aplicativos de ação criados no Studio Web em vez de aplicativos de ação criados no UiPath App Studio. Você também pode usar um App de ação codificada criado como código no IDE de sua escolha — consulte Criação e implantação de Apps de ação codificada para obter detalhes.

Criar um aplicativo de Ação do zero

1. Acesse a plataforma de nuvem e selecione o serviço Studio Web.

2. Na guia Automações, selecione Novo projeto e escolha o tipo de projeto do aplicativo .

   

3. Selecione um modelo preferido, estilo e os controles desejados. Para os fins deste tutorial, use o modelo Formulário D. Leia mais sobre como desenvolver seu aplicativo.

4. Selecione Nome do aplicativo e, em seguida, na guia Geral , selecione Nome do aplicativo para abrir o editor de expressão.

5. Dê ao novo aplicativo um nome: "Aplicativo de Aprovação de Ferramentas" e salve.

6. No painel de navegação esquerdo, selecione FormWrapper e remova os controles que você não usará neste exemplo: FirstName, LastName, Email, Telefone, Rua, Estado, CEP e País.

7. Selecione o botão Explorador de projetos no canto superior esquerdo da página, selecione o botão + adicionar e escolha a opção Ação .

   

8. No botão Caixa de ferramentas na parte superior esquerda da página, navegue até a guia Exibição e adicione um rótulo ao aplicativo.

   

   Agora você precisa transformar este aplicativo em um aplicativo de Ação; caso contrário, você não poderá usá-lo para configurar um escalonamento de agente.

9. Selecione o botão Explorador de projetos no canto superior esquerdo da página, selecione o botão + adicionar e escolha a opção Ação . A caixa de diálogo Propriedades da ação é exibida.

10. Na caixa de diálogo Propriedades da ação , adicione webSearchResults nas Propriedades de entrada e torne-a Obrigatória marcando a caixa relacionada. As propriedades de entrada do esquema de ação são derivadas do contexto do agente e apresentadas ao usuário. Eles provavelmente serão exclusivos para cada execução de agente. Observe que, diferente das propriedades Input/Output, você não pode alterar esses valores durante a revisão. As propriedades Input/Output são derivadas do contexto do agente e você pode modificá-las. O agente também documenta quaisquer alterações retornadas para ele. As propriedades de saída são valores adicionais que os usuários podem inserir para serem enviados de volta ao agente.

11. Crie dois resultados: Approve e Deny.

    

    O resultado é um evento que, juntamente com as propriedades Input/Output, é enviado de volta ao agente. Fornecer um resultado significativo orienta as próximas etapas do agente, que podem envolver o encerramento de sua execução devido a uma falha. Portanto, os testes são cruciais.

12. Retorne ao formulário e nomeie o rótulo que você criou anteriormente no editor de expressão com "webSearchResults; para aprovação é: "+ActionProperties.webSearchResults. Selecione Salvar.

    

13. Altere os nomes de seus botões Enviar e Cancelar para Aprovar e Negar.

14. Selecione o botão Aprovar e acesse a guia Eventos à direita.

15. Adicione uma automação "Clicando em" selecionando o botão Editar automação .

16. Adicione uma atividade Enviar ação . Leia mais sobre como adicionar atividades no Studio Web.

17. Na seção Resultado , escolha o valor Aprovar .

18. Selecione o botão Negar e vá para a guia Eventos à direita.

19. Adicione uma automação "Clicando em" selecionando o botão Editar automação .

20. Adicione uma atividade Enviar ação . Leia mais sobre como adicionar atividades no Studio Web.

21. Na seção Resultado , escolha o valor Negar .

Criar um aplicativo de ação usando o Autopilot

1. Acesse a plataforma de nuvem e selecione o serviço Studio Web.

2. Na guia Automações, selecione Novo projeto e escolha o tipo de projeto do aplicativo .

   

3. Selecione o modelo Página em branco . Para aproveitar os recursos do Autopilot na criação do aplicativo de Ação, você precisa ter um aplicativo em branco.

4. No Explorador de projetos, clique com o botão direito do mouse no projeto do aplicativo e, na lista suspensa Adicionar ao aplicativo , selecione Ação. Isso abre automaticamente o esquema de ação dentro do aplicativo.

5. Na seção Com o Autopilot , insira as instruções para o Autopilot para gerar o esquema de ação. Por exemplo, você pode inserir: "Crie um esquema de ação onde um argumento de entrada seja Idade, um argumento Entrada/Saída é salário e um argumento de saída é taxa de juros".

6. Selecione Gerar ação para gerar o esquema de ação.

7. Selecione Gerar página do esquema para gerar uma configuração do aplicativo com base no esquema de ação gerado anteriormente.

8. Atualize o projeto do Studio Web. Seu aplicativo do Action Center agora está pronto para ser publicado e implantado.

Use um app de ação codificado

Em vez de criar a interface da tarefa com o Designer de aplicativos, você pode usar um aplicativo de ação codificada— um aplicativo React ou Angular personalizado desenvolvido como código em seu IDE preferido. Isso dá a você controle total sobre a interface da tarefa, seu comportamento e sua integração com a UiPath e sistemas externos.

Um aplicativo de ação codificada segue o mesmo ciclo de vida que um aplicativo de ação do Studio Web:

• Definido em código no IDE de sua escolha
• Conexão estabelecida com a UiPath
• Implantado no Orchestrator
• Usado como interface para a tarefa de escalonamento do agente

Após publicá-lo e implantá-lo, selecione-o na lista suspensa Aplicativo ao configurar o escalonamento, exatamente como qualquer outro aplicativo de Ação.

Para obter etapas detalhadas sobre como criar e implantar Apps de ação codificada, consulte Criação e implantação de Apps de ação codificada e a seção Introdução da documentação do SDK.

Publicar e implantar o aplicativo Ação

Para disponibilizar esse aplicativo da Ação na organização, você precisa publicá-lo e implantá-lo:

1. Selecione Publicar.
2. Escolha o nome "EscalationTestApp" e selecione Publicar novamente.
3. Dependendo de onde você estiver criando o aplicativo da Ação, implante o aplicativo da seguinte forma:
   • Se você criou o aplicativo em um projeto de aplicativo, acesse o Orchestrator e implante o aplicativo.
   • Se você criou o aplicativo como parte de uma solução no Studio Web, navegue até a aba Soluções no Orchestrator e implante o aplicativo. Certifique-se de que ele seja executado em um runtime sem servidor.
4. Depois de implantar o aplicativo, selecione o botão Editar os detalhes do processo .
5. Selecione Avançar.
6. Na seção Cloud Robot - Serverless , escolha a opção Médio . Essa é a opção que recomendamos para um melhor desempenho com o Apps Web.
7. Selecione Atualizar.

2. Crie um agente

1. Crie um novo Agente seguindo este procedimento de criação de agente.

2. No campo Prompt do sistema , insira o seguinte: Use the web search tool to do a search on the provided search item. You must then raise an escalation to confirm that the search result is satisfactory before returning your final output, a simple one-liner from the web search.

3. No campo Prompt do usuário , insira o seguinte: Do a search on term:.

4. Na parte esquerda do seu projeto, selecione Abrir Data Manager e, na aba Entrada , selecione Adicionar propriedade.

5. Selecione Editar nome e insira searchTerm. Selecione Aplicar para salvar as alterações.

6. No campo Descrição , insira the search term provided from the user.

7. Na guia Saída , selecione Adicionar propriedade e defina o nome como Output e a descrição como natural language summary of the approved search results.

8. Selecione Obrigatório para tornar essa propriedade obrigatória.

   Figura 1. O prompt do Usuário e do Sistema do Agente

   

9. Volte para o Prompt do Usuário, e adicione a propriedade criada anteriormente usando chaves duplas {{ }}.

   Neste exemplo, insira chaves duplas de abertura {{ e, em seguida, selecione searchTerm.

10. Na seção Ferramentas , selecione Adicionar ferramenta e acesse a aba Atividades .

11. Pesquise e selecione a atividade Web Search .

12. Abra o painel Propriedades para essa atividade e, na lista suspensa Conexão de atividades UiPath GenAI , selecione uma conexão existente. Como alternativa, selecione Definir novo para criar uma nova conexão ou selecione Abrir conexões para navegar até o Integration Service.

13. No campo Mecanismo de pesquisa , selecione um GoogleCustomSearch.

14. Na seção Descrição de pesquisa , no menu de ajuste, selecione Argumento e selecione o argumento criado anteriormente, que deve conter o tópico que você deseja pesquisar na web. O agente também usa a descrição do argumento, fornecido no Data Manager, como parte do prompt do usuário.

    Figura 2. O painel Propriedades da atividade Web Search

    

15. Na seção Escalonamentos , selecione Adicionar escalonamento:

    1. Selecione o aplicativo de Ação criado e implantado anteriormente na lista suspensa Aplicativo . Neste exemplo, selecione EscalationTestApp.

    2. No campo Prompt , insira Use this to confirm the search results is satisfactory with the assignee.

    3. Expanda a seção Entradas para visualizar os campos do aplicativo Ação.

       Figura 3. Configuração do escalonamento do agente

       

16. Execute o agente.

17. Na aba Traces do agente, selecione a URL da tarefa que está pendente com o destinatário configurado anteriormente.

    1. Revise a tarefa de escalação que está aguardando você e aprove-a se tudo estiver em ordem.

       
       Observação:

       O agente ficará em um estado suspenso até que o escalonamento seja resolvido pelo usuário atribuído no Action Center.

18. Volte para o espaço de trabalho dos Agentes, onde você deve ver o Agente executando a tarefa e fornecendo o resultado esperado.