Gerenciamento de agentes UiPath

A página Agentes no Automation Cloud^TM fornece uma experiência completa de gerenciamento de agentes, oferecendo os seguintes recursos:

• Migração de agentes pioneiros para pacotes de solução
• Monitoramento do desempenho de agentes implantados
• Identificando e abordando incidentes de agente
• Acessando modelos de agente do Marketplace

Esse hub centralizado permite o monitoramento em tempo real de todos os runtimes de agentes, com alertas para erros, degradação da pontuação de integridade e avaliações ruins de desempenho de runtime.

Terminologia

• UmaInstância de agente é um único agente implantado em um processo de negócios em execução, representado como uma Tarefa no BPMN, sendo a execução ao vivo de um runtime de agente que responde a gatilhos específicos, filas ou outras condições de fluxo de trabalho.​

• O gerenciamento da Instância do agente representa o conjunto de tarefas relacionadas ao monitoramento, manutenção, melhoria e encerramento de agentes e trabalhos de agentes.

Principais funcionalidades

Aqui estão os recursos principais da página redesenhada de Agentes no Automation Cloud^TM:

• Monitoramento de agente em tempo real usando fluxos de trabalho BPMN.
• Tratamento e recuperação de erros por meio de eventos definidos pelo BPMN.
• Coordenação de agente em runtime entre agentes e operadores humanos.
• Mesclagem e manuseio de consenso por meio de gateways de tomada de decisão.
• Análise de desempenho e otimização com base em várias métricas.
• Para verificações de governança e conformidade que garantem a adesão às regras da empresa.

Guia Início

A aba Início fornece uma visualização ampla do runtime e do monitoramento do agente.A partir daqui você pode:

• Gerencie os agentes implantados e monitore o desempenho deles.
• Gerencie e monitore seus agentes dos primeiros usuários.
• Gerenciar e monitorar incidentes e erros dos agentes.
• Monitore o status de seus índices e o progresso da ingestão deles.
• Confira os modelos de agentes que estão disponíveis no Marketplace.

Aba de Instâncias de agentes

A aba Todas as instâncias de agentes fornece visibilidade sobre agentes implantados na produção e inclui:

• Monitoramento de painéis para a Linha do tempo de instâncias ativas e a Linha do tempo de instâncias concluídas.

• Uma lista de agentes em tempo real: exibe agentes que foram executados durante o intervalo de tempo selecionado.Para cada agente, os metadados importantes de execução são exibidos. Selecionar um agente abre sua visualização de instância individual, que inclui:
  • Uma breve descrição do agente, incluindo configurações e políticas de retenção.
  • Uma lista cronológica de todas as execuções de trabalhos durante o intervalo de tempo selecionado. Selecionar um trabalho abre uma visualização de trace detalhada para essa execução.

    A visualização de trace oferece os seguintes insights sobre cada execução do agente: fluxo de execução com resultados codificados por cores (sucesso, falha, nova tentativa), pré-visualização dos horários de início e término, status de execução, fragmentos de entrada e saída e detalhes completos sobre payloads JSON, logs e erros, métricas de tempo de execução (uso de token, latência). Para obter detalhes, consulte a seção a seguir.

Use o filtro de tempo para ajustar o intervalo exibido: última hora, último dia, última semana, último mês.

Entendendo a visualização de trace

A visualização de trace combina uma representação gráfica da lógica do agente com dados de execução alinhados no tempo, permitindo que você inspecione o fluxo e os resultados de cada etapa. A tela mostra nós representando os principais componentes do agente, como modelos e ferramentas, conectados em sequência.

Depois de entrar na visualização de trace de uma execução de agente, siga estas etapas para interagir e investigar os dados de trace:

1. Visualizar informações do nó. Passe o mouse sobre qualquer nó na tela para ver uma dica de ferramenta que inclui:
   • O status de execução (sucesso, nova tentativa ou falha)
   • Carimbos de data e hora de início e fim
   • Uma visualização dos dados de entrada e saída
   Isso é útil para obter uma ideia rápida do que aconteceu em cada etapa sem precisar abrir os detalhes completos.
2. Exibir detalhes completos do nó. Selecione qualquer nó para abrir um painel detalhado que inclui:
   • Cargas úteis de entrada e saída completas (JSON)
   • Logs de execução ou mensagens de erro (se aplicável)
   • Métricas de tempo de execução, como latência e uso de tokens
   • Parâmetros de configuração, se disponíveis
3. Navegue entre etapas relacionadas, para explorar como as informações foram processadas pelo agente:
   • Selecione nós conectados para navegar para montante ou jusante.
   • Isso ajuda você a rastrear como as decisões, entradas ou saídas de uma etapa influenciaram a próxima.
4. Use o painel Trace de Execução. Esse painel mostra uma lista cronológica de todas as ações gravadas durante a execução do agente.
   • Selecione uma linha no log de trace para destacar o nó correspondente na tela.
   • Da mesma forma, selecionar um nó na tela destaca automaticamente a linha relevante no log de trace.

Guia de Primeiros Usuários

A aba Agentes de Primeiros Usuários mostra todos os agentes que você criou no Agent Builder antes de 14 de maio de 2025.

Selecione o botão Migrar para cada agente para migrá-lo para o Studio. Para obter detalhes, consulte Etapas da migração.

Figura 1. Guia de instâncias do agente de adoção inicial

Guia de erros

A aba Erros permite o monitoramento para agentes com o maior número de erros. A aba mostra:

• Agentes com mais erros, exibidos como um gráfico. Use o menu suspenso Mostrar para exibir os 5 superiores ou os 10 superiores itens para o período de tempo selecionado.

• Tabela de Incidentes, com uma lista de incidentes de execução de agentes, incluindo uma coluna Descrição que fornece percepções rápidas sobre a causa de cada incidente. Ao selecionar as entradas na coluna Visto pela primeira vez ou Visto pela última vez para um incidente, você pode exibir o painel de detalhes do trabalho correspondente.

Para agrupar incidentes por Agente ou Processo pai, selecione as caixas de seleção correspondentes.

Guia Índices de contextualização

A aba Índices de fundamentação permite que você monitore o status de seus índices e rastreie seu progresso de ingestão no nível do tenant.

A seção Monitoramento de índices fornece insights gráficos sobre as seguintes métricas:

• Consultas: rastreia o número de consultas realizadas em seus índices durante um intervalo de tempo selecionado.

• Trabalhos de índice: exibe uma contagem de trabalhos de ingestão. Se nenhum trabalho tiver sido executado no período de tempo selecionado, um gráfico de espaço reservado é exibido.

A tabela Índices lista todos os índices disponíveis em seu tenant. Para obter informações mais detalhadas sobre índices, selecione um índice da tabela. A visualização individual fornece as seguintes informações:

• O número de Consultas durante o intervalo selecionado.
• O histórico de trabalhos de sincronização de índice durante o intervalo selecionado. Selecione uma entrada na tabela de sincronização para obter uma visualização detalhada dos documentos processados.

Figura 2. Gerenciamento de abas de índices de contextualização

Aba Modelos

A aba Modelos fornece acesso direto aos modelos de agente disponíveis no UiPath Marketplace.

Para saber como usar modelos, consulte Como usar modelos de agentes.

Figura 3.Modelos de agente no Marketplace