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

Terminologia:

• Agentes: recursos fornecidos por tecnologias como Modelos de Linguagem Abrangente (LLMs), machine learning e automação empresarial tradicional, agentes são projetados para operar em ambientes dinâmicos e não deterministas. Eles podem planejar, agir, aprender e se adaptar, o que as torna ideais para processos que exigem avaliação, flexibilidade e reconhecimento 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 desenvolvido no UiPath Apps ou diretamente no Studio Web, permitindo criar formulários ou interações de interface gráfica com opções específicas para tarefas que exigem intervenção humana (tarefas do Action Center), como aprovações. Você pode definir as propriedades de entrada e saída dos aplicativos de ação adicionando propriedades de ação no esquema de ação.
  Observação: você só pode usar aplicativos publicados e implantados para configurar escalonamentos de agentes.

Pode haver situações nas quais os agentes enfrentam desafios ou exigem intervenção humana para avaliar, confirmar ou fornecer detalhes essenciais. Essa pode ser uma ação deliberada, em que determinadas 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 da ferramenta pode falhar inesperadamente ou retornar dados de uma estrutura inesperada, o usuário 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ões 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, visite Proteções. Ao criar escalonamentos para proteções, você pode usar o seguinte modelo do UiPath Marketplace: Ferramenta de agente Aplicativo de escalonamento de proteções.

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 um nome e descrição 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 para um único agente. Você pode atribuir vários escalonamentos para um agente e adicionar uma descrição para cada entrada, permitindo que o agente envie os valores apropriados para o aplicativo do Action Center. 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 de agentes.

Importante: os escalonamentos não são deterministas, 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 determinista, é 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 essas 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 agente apenas usando aplicativos de Ação. Recomendamos que você use aplicativos de Ação criados no Studio Web, em vez de aplicativos de Ação criados no UiPath Apps.

Criar um aplicativo de Ação do zero

1. Acesse o Automation Cloud™ 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, um estilo e os controles desejados. Para os fins deste tutorial, use o modelo Formulário D.

   Leia mais sobre o desenvolvimento de 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 à esquerda, 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. Usando o botão Caixa de ferramentas no canto superior esquerdo da página, navegue até a guia Exibir 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 em Propriedades de entrada e torne Obrigatório 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 são exclusivos para cada execução do 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 a 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: Aprovar e Negar.
    
    
    
    

    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 dos botões Enviar e Cancelar para Aprovar e Negar.
14. Selecione o botão Aprovar e vá para 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^TM

1. Acesse o Automation Cloud™ 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 Project Explorer, clique com o botão direito do mouse no projeto do aplicativo e, na lista suspensa Adicionar ao aplicativo , selecione Action.

   Isso abre automaticamente o esquema do Action Center no aplicativo.

5. Na seção Com o Autopilot , insira as instruções para o Autopilot gerar o esquema de ações.

   Por exemplo, você pode inserir: "Crie um esquema de ação onde um argumento de entrada for Idade, um argumento de entrada/saída será o salário e um argumento de saída será a 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 de aplicativo com base no esquema de ação gerado anteriormente.
8. Atualize o projeto do Studio Web.

   Seu aplicativo do Action Center já está pronto para ser publicado e implantado.

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, vá para o Orchestrator e implante o aplicativo.
   • Se você criou o aplicativo como parte de uma solução no Studio Web, navegue até a guia 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édia . Essa é a opção que recomendamos para um melhor desempenho com o Web Apps.
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 a ferramenta de pesquisa na web para fazer uma pesquisa no item de pesquisa fornecido. Você deve então criar um escalonamento para confirmar se o resultado da pesquisa é satisfatório antes de retornar sua saída final, uma simples linha da pesquisa na web.
3. No campo Solicitação do usuário , insira o seguinte: Fazer uma pesquisa por termo:.
4. Na parte do lado esquerdo do seu projeto, selecione Open Data Manager e, na guia Entrada , selecione Adicionar propriedade.
5. Selecione Editar nome e insira o termo da pesquisa. Selecione Aplicar para salvar as alterações.
6. No campo Descrição , insira o termo de pesquisa fornecido pelo usuário.
7. Na guia Saída , selecione Adicionar propriedade e defina o nome como Output e a descrição como resumo de linguagem natural dos resultados de pesquisa aprovados.
8. Selecione Obrigatório para tornar essa propriedade obrigatória.
   Figura 1. O prompt de 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 Pesquisa na web .
12. Abra o painel Propriedades para essa atividade e, na lista suspensa Conexão de atividades da UiPath GenAI , selecione uma conexão existente.

    Alternativamente, selecione Definir novo para criar uma nova conexão, ou selecione Abrir conexões para navegar para o Integration Service.

13. No campo Mecanismo de pesquisa , selecione uma PesquisaPersonalizadaDoGoogle.
14. Na seção Descrição da 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 do Action criado e implantado anteriormente na lista suspensa App .
       Neste exemplo, selecione EscalationTestApp.
    2. No campo Solicitação , insira Use isso para confirmar se os resultados da pesquisa são satisfatórios para o destinatário.
    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 guia 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 estará 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.