Agentes no fluxo

Nós de agente em linha em projetos do Maestro Flow, configurados na tela do Studio Web junto com conectores e nós de script sem uma etapa de publicação separada.

O UiPath Agents in Flow permite incorporar agentes de pouco código diretamente dentro de um projeto do Maestro Flow como nós de agente em linha. Em vez de criar um agente separadamente no Agent Builder e invocá-lo por meio de uma chamada de processo, você configura a solicitação de sistema, o modelo, o esquema de entrada/saída e as ferramentas do agente da mesma tela do Studio Web em que você projeta o fluxo.

Os nós de agente integrado são nós de primeira classe na tela de fluxo. Eles aparecem ao lado de conectores, nós de Script e outros componentes de fluxo. As variáveis de fluxo vão e voltam de agentes em linha de forma nativa, e você pode encadear vários agentes em série dentro de um único fluxo.

Agents em linha versus Agents independentes

	Agents in Flow em linha	Agents independentes
Espaço de configuração	Tela de fluxo no Studio Web	Agent Builder no Studio Web
Implantação	Sem etapa de publicação separada — o agente faz parte do fluxo	Deve ser publicado como um processo de agente independente antes de usar em um fluxo
Troca de variáveis	Variáveis de fluxo referenciadas de forma nativa na solicitação e na saída do agente	Você pode passar variáveis por meio de parâmetros de invocação de processo
Encadeamento	Vários agentes em série em um único fluxo	Você pode invocar um agente de outro usando a ferramenta de agente
Inserção de variável em solicitações	Usa convenções $ ($vars, $metadata)	Usa convenções @ do Studio Web

Tipos de agentes

• Autônomo — o agente seleciona e executa ferramentas para realizar uma tarefa.

Ferramentas

Os agentes em linha oferecem suporte às seguintes categorias de ferramentas:

Categoria da ferramenta	Disponibilidade
Processos RPA	Disponível
Fluxos de trabalho da API	Disponível
Atividades	Disponível
Outros fluxos (Maestro)	Disponível
Agente (invoque um agente independente publicado)	Disponível
Conectores do Integration Service	Disponível
Ferramentas integradas (Analisar arquivos, resumir, transformação em lote)	Disponível
Escalonamentos	Disponível
Ferramentas de MCP	Não disponível
A2A (Agente para Agente)	Não disponível
Extração e Processamento Inteligente (IXP) (extração de documento)	Não disponível

Context

A contextualização está disponível para agentes em linha em igualdade com o Agent Builder.

Proteções

Você pode adicionar proteções no nível do agente, no nível do LLM ou no nível de ferramenta individual. As proteções avaliam entradas e saídas do agente em relação a políticas definidas e disparam uma ação quando houver correspondência.

As proteções integradas detectam categorias de conteúdo específicas automaticamente:

• Detecção de PII
• Conteúdo prejudicial
• Detecção de propriedade intelectual
• Ataques de prompt de usuário

Escalonamentos

Os escalonamentos estão disponíveis para agentes em linha em igualdade com o Agent Builder.

Variáveis de saída

Cada agente em linha retorna um objeto output. O campo padrão é content, que contém o texto da resposta do agente. Você pode declarar variáveis de saída adicionais na guia Variáveis para retornar dados estruturados — cada variável requer um nome e tipo, e a solicitação do sistema deve direcionar o agente para preenchê-las.

A saída de nós anteriores é referenciada em nós subsequentes usando $vars.<node>.output.<field>, por exemplo, $vars.agent1.output.content.

Depuração e avaliações

Depuração

Você pode depurar nós de agente individuais em linha isolados a partir do Studio Web usando pontos de interrupção, execução passo a passo e rastreamentos de execução. Nós de agente individuais podem ser depurados isoladamente selecionando o nó e usando a opção Debug passo a passo.

As execuções de fluxo completo aparecem como trabalhos no Orchestrator, onde você pode monitorar o status da execução. Após a conclusão de uma execução, o trace da execução está disponível na guia Execução do painel inferior, mostrando um detalhamento passo a passo com tempo para cada nó, incluindo chamadas e saídas de LLM.

Avaliações

Você pode avaliar agentes em linha por nó na tela usando o botão Avaliar na barra de ferramentas. As guias Conjuntos de dados e Avaliadores no painel inferior gerenciam conjuntos de dados de avaliação e avaliadores e adicionam avaliadores a uma execução de conjunto de dados. A guia Execuções mostra o histórico de execuções de avaliação.

A avaliação para agentes em linha é basicamente igual à do Agent Builder, embora a experiência para criar avaliações seja diferente. Alguns recursos do Agent Builder ainda não estão disponíveis para agentes de Fluxo em linha. Para obter detalhes, consulte Limitações.

Três categorias de avaliador estão disponíveis:

Categoria	Tipo	Description
Validação de saída	Contém texto	É aprovado quando a saída do agente contém o texto especificado
Validação de saída	Correspondência Exata	Verifica se a saída do agente corresponde exatamente à saída esperada
Validação de saída	Similaridade JSON	Compara a similaridade estrutural de objetos ou valores JSON
Juiz de LLM	saída do Juiz de LLM	Utiliza um modelo de linguagem para avaliar o quanto a saída corresponde à saída esperada em significado e intenção
Juiz de LLM	JSON estrito do Juiz de LLM	Utiliza um modelo de linguagem para avaliar a correspondência estrutural estrita de JSON
Juiz de LLM	Sequência de ações do juiz de LLM	Usa um modelo de linguagem para julgar se o agente seguiu o comportamento esperado
Juiz de LLM	Simulação de juiz com LLM	Você usa um modelo de linguagem para julgar o caminho de execução do agente simulado
Chamada da ferramenta	Argumentos de chamada de ferramenta	Verifica se as ferramentas foram chamadas com argumentos corretos
Chamada da ferramenta	Contagem de Chamadas de Ferramenta	Verifica o número de vezes que cada ferramenta foi chamada
Chamada da ferramenta	Ordem das chamadas de ferramentas	Verifica se as ferramentas foram chamadas na sequência esperada
Chamada da ferramenta	Saída de chamadas da ferramenta	Verifica se as saídas da ferramenta correspondem aos valores esperados