- Introdução
- Agentes da UiPath no Studio Web
- Agentes da UiPath no Agent Builder
- Agentes codificados da UiPath

Guia do Usuário de Agentes
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.
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.
Para configurar diretrizes para uma ferramenta:
- Adicione qualquer ferramenta ao seu agente.
- Selecione a ferramenta e abra o painel Propriedades.
- Selecione Abrir ferramenta de criação de diretrizes.
- Defina um nome e uma descrição da diretriz e, em seguida, configure os tipos de regra e ação.
- Selecione Salvar. As ferramentas com diretrizes são marcadas com um ícone de escudo.
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.
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.
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:
- 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. - 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.
- Publique o aplicativo, conforme descrito em Publicando projetos de aplicativos.
- 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.
- Retorne ao seu agente e selecione o aplicativo recentemente implantado para suas diretrizes.