Gerenciamento de agentes UiPath

A página Agents no Automation Cloud serve como seu hub de registro e observabilidade centralizado para todos os agentes da UiPath. Use-a para monitorar o desempenho, testar o comportamento de conversação, gerenciar recursos compartilhados e manter a visibilidade em todo seu ecossistema implantado.

A partir de um único local, você pode:

• Monitorar Agents implantados e revisar métricas de desempenho em tempo real.
• Teste agentes de conversação antes e após a implantação.
• Investigar e resolver incidentes de Agents ou condições de integridade degradadas.
• Acessar e implantar modelos de Agents a partir do UiPath Marketplace.
• Gerenciar índices de contextualização.

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 CloudTM:

• 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.

Visão geral

A guia Visão geral fornece um resumo de alto nível de seu ecossistema de agentes, consolidando insights operacionais, indicadores de desempenho e análises de consumo em uma visualização centralizada. Ele atua como uma central de comando para entender como está o desempenho dos agentes em sua organização e com que eficiência eles estão consumindo recursos.

Insights de desempenho

A guia agrega dados de runtime em todos os agentes implantados para ajudar você a monitorar tendências de desempenho e identificar oportunidades de otimização. As principais métricas incluem:

• Total de trabalhos: rastreia o número total de execuções de agentes concluídas, fornecendo uma medida de atividade e adoção.
• Taxa de sucesso: mede o percentual de execuções de agentes bem-sucedidas, para ajudar você a avaliar a confiabilidade e detectar erros recorrentes ou instabilidade nas configurações dos agentes.
• Tempo médio de resposta: indica a rapidez com que seus agentes são capazes de concluir tarefas, permitindo que você monitore a latência e a eficiência em escala.
• Consumo de Agent Units: quantifica o uso total de unidades em todos os agentes, permitindo melhores previsões, orçamentos e alocação de recursos.

Monitoramento e análise de feedback

A guia também mostra tendências de consumo e feedback em seu ambiente:

• Os relatórios de consumo de Agent Unitd identificam os agentes mais ativos ou caros, ajudando a priorizar o ajuste ou a alocação de recursos.
• Os resumos de feedback realçam quais agentes recebem a maioria das interações de usuários ou classificações de desempenho, ajudando as equipes a se concentrar na melhoria da experiência e do impacto do usuário.

Filtro e análise baseada no tempo

Os administradores podem analisar dados em várias dimensões, como tipo de agente, estado de implantação ou intervalo de tempo, para identificar anomalias e avaliar tendências em períodos operacionais definidos (por exemplo, visualizações diárias, semanais ou mensais). Esses filtros habilitam análises direcionadas e simplificam a geração de relatórios.

• Gerencie os agentes implantados e monitore o desempenho deles.
• Gerencie e monitore seus agentes dos primeiros usuários.

Agentes implantados

A guia Agentes implantados fornece uma visualização consolidada de todos os agentes implantados (considerando todos os tipos de agentes), junto com métricas de desempenho em tempo real, integridade e feedback. Ela atua como o workspace principal para monitorar a eficiência operacional, diagnosticar problemas e garantir que os agentes implantados entreguem resultados consistentes e de alta qualidade.

Visibilidade de agentes unificada

Essa visualização agrega todos os agentes prontos para produção em seu tenant, independentemente do tipo, permitindo que administradores e desenvolvedores avaliem rapidamente o status operacional e a atividade recente. Cada cartão de agente exibe o tipo do agente (Conversacional, Autônomo ou Codificado) como um selo, junto com as principais métricas operacionais:

• Taxa de sucesso – O percentual de execuções bem-sucedidas, ajudando você a identificar agentes degradados ou de baixo desempenho.
• Tempo de resposta médio – Uma medida de velocidade de execução e eficiência em trabalhos recentes.
• Volume de feedback – O número de avaliações de usuários ou do sistema coletadas para o agente.
• Indicadores de integridade – Sinais visuais (por exemplo, Saudável, Degradado) refletindo tendências gerais de desempenho e estabilidade do runtime.

Os agentes podem ser filtrados por estado, pasta ou intervalo de tempo. Use o filtro Tipo para restringir a visualização a um tipo de agente específico: Conversacional, Autônomo ou Codificado.

Insights operacionais e rastreamento de desempenho

A guia fornece análise contextual, que se estende além do simples status de runtime. Você pode explorar:

• Trabalhos ativos e concluídos – Linhas de tempo separadas rastreiam execuções ao vivo em comparação com execuções concluídas, ajudando a identificar picos e gargalos de cargas de trabalho.
• Padrões de erro e latência – Os gráficos de desempenho exibem erros de execução, tempo até a primeira resposta e percentis de latência, permitindo que as equipes façam um ajuste fino da capacidade de resposta.
• Tendências de feedback – A análise de sentimento agregada (positivo versus negativo) mostra como a qualidade do agente evolui ao longo do tempo e quais atualizações afetam a satisfação do usuário.

Esses insights ajudam a diagnosticar problemas sistêmicos, validar novas implantações e priorizar esforços de otimização.

Observação:

Os gráficos de gerenciamento de instâncias não estão disponíveis quando a criptografia CMK está habilitada para traces. Como os atributos de Trace são criptografados no Insights e, portanto, não podem ser consultados, a análise necessária para gerar esses gráficos não pode ser executada.

Análise de uso e consumo

O painel destaca como os agentes interagem com seus ambientes e como os recursos são consumidos:

• Uso de Agent Units – Rastreia o consumo total e identifica valores discrepantes no custo ou na utilização de recursos.
• Principais recursos invocados – Lista as ações usadas com mais frequência (ferramentas, atividades ou índices) em execuções de agentes, ajudando as equipes a entender padrões de comportamento e dependências comuns.

Visualização detalhada do runtime do agente

Selecionar um agente individual abre um workspace de análise detalhado, combinando:

• Um diagrama de runtime, que mapeia a lógica, ferramentas e origens de memória do agente.
• Visualizações de pontuação de integridade, que avaliam o projeto das solicitações, a integração de ferramentas e a cobertura de avaliação.
• Os traces de execução com visibilidade granular em cada execução (entradas, saídas, erros e detalhes de temporização), permitindo que os desenvolvedores reconstruam e depurem o processo de raciocínio do agente.

A visualização de instâncias do agente fornece observabilidade completa de execuções de agentes individuais, oferecendo um trace completo de decisões, ações e métricas de desempenho dentro de uma única execução.

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 completa.
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.

Agentes de rascunho

A guia Agentes de rascunho contém agentes não publicados ou em andamento que estão sendo desenvolvidos.

Cada rascunho é exibido como um cartão que inclui:

• O nome do agente (ou "Sem título", se ainda não tiver sido renomeado).
• O último carimbo de data/hora atualizado.
• Um link rápido para reabrir o rascunho no Studio Web para edição adicional.

Os Agents de rascunho podem ser retomados, editados ou publicados após finalizados.

Contextualização de índices

A guia Contextualização de índices permite que você monitore o status e a integridade de seus índices e rastreie o progresso da 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 o número de trabalhos de ingestão concluídos. Se nenhum trabalho tiver sido executado no período selecionado, um gráfico de espaço reservado será 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:

• Nome do índice, pasta e dados de origem
• Status de integridade, indicando se um índice está Saudável ou Degradado
• Tamanho do armazenamento, status da ingestão, Última sincronização e Última consulta

Selecione um índice na tabela para abrir sua página de detalhes. A Visualização de Detalhes do Índice fornece:

• Consultas durante o intervalo selecionado.
• Um gráfico de integridade mostrando a pontuação geral de integridade e os dois critérios de componentes.
• Histórico de ingestão, listagem de execuções de sincronização concluídas, com falha, ignoradas ou excluídas.

Use esta visualização para investigar índices degradados, revisar a confiabilidade da ingestão ou marcar quando um índice foi consultado pela última vez.

Pontuação de integridade do índice

A integridade do índice ajuda você a monitorar a condição de seus índices de contextualização e identificar aqueles que podem precisar de manutenção ou limpeza. Ele fornece uma pontuação automatizada e objetiva mostrando o quão bem cada índice é executado e com que frequência ele é usado.

Cada Índice recebe uma pontuação de integridade com base em dois critérios:

• Confiabilidade da ingestão – Quão bem os documentos foram processados durante a execução de ingestão mais recente.
• Utilização – Quão recentemente o índice foi consultado.

A pontuação combinada ajuda você a determinar se um índice está saudável e está entregando valor (pontuação geral acima de 75%), ou degradado (pontuação geral de 75% ou abaixo). A pontuação é atualizada automaticamente após cada ingestão ou consulta bem-sucedida.

A integridade do índice é recalculada a cada 15 minutos para todos os tenants e aplica-se apenas a índices com trabalhos de ingestão concluídos. Os novos índices têm um período de carência de 24 horas após a criação antes que a pontuação de integridade comece.

A tabela a seguir descreve como cada critério de Índice é calculado e ponderado para determinar a pontuação geral de integridade do Índice.

Critério	Métrica	Fórmula	Observações
Confiabilidade da ingestão	Taxa de sucesso da última ingestão.	100 × (1 - failed_docs / total_docs)	Documentos ignorados e excluídos não são considerados.Se nenhuma ingestão for concluída dentro de 24 horas, a pontuação = 0.
Utilização	Dias desde a última consulta (Máx. 90 dias)	100 × (1 - days_since_last_query / 90)	Após 24 horas sem nenhuma consulta, a pontuação é 0.
Saúde geral	Média de ambas as métricas	(Confiabilidade da ingestão + utilização)	Calculado apenas se ambas as pontuações de componentes existirem.

Você pode revisar o status de integridade em dois locais:

• A lista de índices de contextualização – A coluna mostra um indicador colorido (verde para Saudável, vermelho para Degradado).Passar o mouse sobre ele exibe detalhes para cada Dimension (Confiabilidade da ingestão e Utilização).
• A visualização de detalhes do índice – O gráfico de Saúde dedicado exibe a pontuação geral e as métricas de componentes.Você também pode rastrear o histórico de ingestão e investigar problemas quando a confiabilidade é baixa.

Guia Feedback (Visualização)

A guia Feedback fornece uma visualização centralizada para revisar os traces de agente e capturar feedback que ajuda a melhorar a confiabilidade do agente ao longo do tempo. Ele conecta a análise de runtime à memória episódica orientada por feedback, permitindo que os agentes refinem gradualmente sua tomada de decisão sem regravações de solicitações constantes.

O feedback atende a duas funções complementares:

• Análise e diagnóstico de runtime: revise as execuções de agente concluídas para entender o comportamento, identificar problemas e anotar decisões ou saídas específicas.
• Entrada na memória episódica: o feedback de alta qualidade pode ser promovido para memória episódica, permitindo que o agente repita comportamentos bem-sucedidos e evite comportamentos incorretos em execuções futuras.

Visão geral do feedback

A seção superior da página fornece insights agregados:

• Agents com o maior volume de feedback mostra quais agentes recebem o maior volume de feedback positivo e negativo.
• O feedback ao longo do tempo visualiza tendências de feedback, ajudando você a correlacionar alterações de comportamento com melhorias ou regressões.
• Os filtros de intervalo de tempo permitem que você restrinja a análise a execuções recentes ou históricas.

Figura 3. A guia Feedback no Gerenciamento de Instância de Agents

Adição de feedback para execuções de agente

Para fornecer feedback:

1. Selecione Adicionar feedback na página Feedback.
2. Escolha um trabalho runtime de agente na lista de trabalhos executados.
3. Revise o trace e anexe feedback ao trecho relevante.

Proteções

A guia Proteções fornece uma visualização centralizada da atividade de proteção em seus agentes implantados, ajudando os operadores a garantir que os agentes se comportem de forma confiável, segura e alinhada com as políticas organizacionais. as organizacionais. Ela revela dados sobre proteção em runtime em um só lugar, desde a cobertura da configuração até os resultados da aplicação.

A guia é organizada em três estágios:

• Configurar proteções — adicione proteções no nível do agente, no nível do LLM ou no nível da ferramenta aos seus agentes.
• Monitorar — analise a atividade de proteção em runtime, monitorando a frequência com que as proteções são disparadas e quais ações elas impõem.
• Ajustar proteções — use dados de avaliação para testar, refinar e otimizar o comportamento das proteções ao longo do tempo. ao longo do tempo.s proteções ao longo do tempo.s proteções ao longo do tempo.

Uso de proteções pelos agentes

O gráfico de setores mostra a parcela de agentes em seu tenant que têm proteções configuradas em relação aos que não têm, com base em dados de execução. Apenas os agentes que foram executados pelo menos uma vez são refletidos neste gráfico. Use esta visualização para avaliar a cobertura de governança em seu ecossistema de agentes implantado e identificar agentes que podem precisar de configuração de proteção.

Principais ações invocadas

O gráfico de barras empilhadas mostra o volume e a divisão das ações de proteção impostas em seus agentes. Cada barra representa um agente implantado, segmentado por tipo de ação: Bloquear, Escalar e Filtrar. Um filtro permite exibir os 5 ou 10 primeiros agentes por total de invocações de proteção, consistente com outros gráficos de monitoramento na página Agentes.

Detalhes das proteções

A tabela lista todos os agentes implantados com sua atividade de proteção. Você pode filtrar a tabela para mostrar agentes com proteções, agentes sem proteções ou todos os agentes. O filtro de intervalo de tempo permite que você restrinja os dados a um período selecionado.

Coluna	Description
N.º de proteções	O número de proteções configuradas para o agente.
Proteção mais recente	O nome da proteção acionada mais recentemente durante a execução do agente.
Tipo de proteção	A classificação de tipo da proteção.
Escopo	O nível no qual a proteção se aplica: agente, LLM ou ferramenta.
Estágio de execução	Define se a proteção será executada antes ou após a execução do agente, ferramenta ou LLM: Pré-execução ou Pós-execução.
Ação mais recente	A ação imposta pela proteção acionada mais recentemente: Escalar, Registrar, Filtrar ou Bloquear.
Resultado da Ação	O resultado da ação imposta mais recentemente: Continuar, Rejeitar, Registrar, Filtrar ou Bloquear.