agents
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 de Agentes

Última atualização 6 de out de 2025

Proteções

As diretrizes fornecem um mecanismo para controle de comportamentos inesperados dentro de chamadas de ferramentas de forma determinística.Elas permitem que os desenvolvedores configurar condições para intervenção humana e garantem que os escalonamentos ocorram precisamente quando as condições definidas forem atendidas.

Resumidamente, a função das diretrizes é:

  • Abordam entradas e saídas de chamadas de ferramentas imprevisíveis no runtime.
  • Reduzem a necessidade de intervenções de humanos no processo (HITL) para tarefas de correção e validação.
  • Permitir que os desenvolvedores criem regras personalizadas no nível de ferramenta individual.

Como funciona

Você define diretrizes para cada ferramenta de agente, da seguinte forma:

  • Pode haver uma ou mais diretrizes por ferramenta.

  • Cada diretriz contém uma ou mais regras e uma ação. As regras são avaliadas em relação às entradas e saídas da ferramenta.

  • Uma ação é disparada quando todas as regras são atendidas. A ação pode acontecer antes e/ou após a execução da ferramenta.

As proteções são exibidas no painel Propriedades para cada tipo de ferramenta (automações, atividades ou outros agentes). O construtor de diretrizes é onde você define a lista de regras que disparam a proteção e a ação a ser aplicada quando todas as regras forem atendidas.

No runtime, as diretrizes são verificadas de cima para baixo na ordem em que aparecem na lista. Você pode reordenar as diretrizes conforme necessário através de uma ação de arrastar e soltar usando o ícone de menu à esquerda.

Use a opção Habilitar diretrizes para avaliações para aplicar a diretriz selecionado durante as execuções de avaliação.

Configuração de diretrizes

Para configurar diretrizes para uma ferramenta:

  1. Adicione qualquer ferramenta ao seu agente.
  2. Selecione a ferramenta e abra o painel Propriedades.
  3. Selecione Abrir ferramenta de criação de diretrizes.
  4. Defina um nome e uma descrição da diretriz e, em seguida, configure os tipos de regra e ação.
  5. Selecione Salvar. As ferramentas com diretrizes são marcadas com um ícone de escudo.
Figura 1. Uma ferramenta de atividade com diretrizes aplicadas.
docs image

Tipos de regras

Os seguintes tipos de regras estão disponíveis:

  • Sempre aplicar a diretriz (padrão) – Essa diretriz sempre dispara a ação, independentemente da entrada ou saída. É aplicável à entrada do agente (pré-execução), saída (pós-execução) ou ambas (pré e pós-execução).
  • String – Essa diretriz se aplica aos campos de entrada e saída disponíveis. A regra é aplicável a campos de string, incluindo campos JSON aninhados, e suporta vários operadores (contém, começa com, termina com, é igual, está vazio etc.)
  • Número – Essa diretriz se aplica aos campos de entrada e saída disponíveis. A regra é aplicável a campos de números, incluindo campos JSON aninhados, e suporta vários operadores (contém, começa com, termina com, é igual, está vazio etc.).
  • Booleano – Essa diretriz se aplica aos campos de entrada e saída disponíveis. A regra é aplicável a campos booleanos, incluindo campos JSON aninhados, e é compatível com o operador Igual, com valores TRUE ou FALSE.
Tipos de ações

Para cada regra, você garante que a ação ocorra quando todas as regras forem atendidas.

Os seguintes tipos de ações estão disponíveis:

  • Log – Define um nível de gravidade para o registro em log. Essa ação é útil para enviar eventos personalizados para monitoramento de painéis
  • Filtrar – Remove campos selecionados da entrada e/ou saída de uma ferramenta, da seguinte forma:
    • Entradas: os campos selecionados não são enviados para a solicitação de API da ferramenta.
    • Saídas: os campos selecionados não são retornados ao agente.
      Observação: a qualidade do agente pode ser afetada se as informações críticas forem filtradas.
  • Bloquear – Impede a execução da ferramenta quando as condições são atendidas. Ao usar essa opção, você deve fornecer um motivo para o bloqueio. Bloquear uma ferramenta pode resultar em Resultado do agente.
  • Escalonar – Atribui um escalonamento a um usuário por meio de um aplicativo de escalonamento compatível.

Implementação de diretrizes

Após executar o agente, o painel de saída exibe:

  • O status de execução bem-sucedida.
  • A presença de diretrizes no trace.
  • Os detalhes de diretrizes aplicados ou ignorados.

Usar um aplicativo de escalonamento para diretrizes.

A ação de Escalonar requer um aplicativo de ação compatível. Um modelo está disponível no UiPath Marketplace com o seguinte nome: Aplicativo de Escalonamento do Guardrail da Ferramenta do Agente.

Para disponibilizar o aplicativo para diretrizes, siga as seguintes etapas:

  1. Baixe o modelo de aplicativo do Marketplace e importe o arquivo .uip para um novo projeto do Studio. Para obter detalhes, consulte Importando projetos de aplicativos no guia do usuário do Studio Web.
  2. Você pode adicionar novos controles e eventos ao aplicativo, mas não altere o esquema de ação subjacente. Alterar o esquema torna o aplicativo incompatível com os escalonamentos de diretrizes.
  3. Publique o aplicativo, conforme descrito em Publicando projetos de aplicativos.
  4. Acesse o Orchestrator e implante o aplicativo em uma pasta compartilhada, conforme descrito em Lançando projetos de aplicativos.

    Certifique-se de que a pasta tenha robôs disponíveis sem servidor para evitar erros durante o escalonamento.

  5. Retorne ao seu agente e selecione o aplicativo recentemente implantado para suas diretrizes.

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.