Agents no fluxo (visualização)

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

Os agentes do UiPath no fluxo permitem que você incorpore agentes de pouco código diretamente dentro de um projeto do Maestro Flow como nós de agentes 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 do sistema, o modelo, o esquema de entrada/saída e as ferramentas do agente a partir da mesma tela do Studio Web onde você projeta o fluxo.

Os nós de agentes incorporados 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 passam de e para agentes em linha nativamente, e você pode encadear vários agentes em série dentro de um único fluxo.

Agentes em linha versus agentes independentes

	Agentes em linha no fluxo	Agentes 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 do uso em um fluxo
Troca de variáveis	Variáveis de fluxo referenciadas nativamente na solicitação e saída do agente	Variáveis passadas por meio de parâmetros de invocação de processo
Encadeamento	Vários agentes em série em um único fluxo	Invoque um agente a partir de outro usando a ferramenta Agente
Inserção de variáveis em prompts	Usa convenções de $ ($vars, $metadata)	Usa convenções @ do Studio Web

Tipos de agentes

• Autônomo — O agente seleciona e executa ferramentas para concluir uma tarefa.

Ferramentas

Os agentes embutidos são compatíveis com as seguintes categorias de ferramentas:

Categoria da ferramenta	Disponibilidade
Processos de RPA	Disponível
Fluxos de trabalho da API	Disponível
Atividades	Disponível
Outros fluxos (Maestro)	Disponível
Agente (invoca 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
MCP tools	Não disponível
A2A (agente para agente)	Não disponível
IXP (extração de documento)	Não disponível

Context

A contextualização está disponível para agentes em linha em paridade 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 da ferramenta individual. As proteções avaliam entradas e saídas do agente em relação a políticas definidas e disparam uma ação em uma 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 paridade com o Agent Builder.

Variáveis de saída

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

A saída de nós upstream é referenciada em nós downstream 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 isoladamente do Studio Web usando pontos de interrupção, execução passo a passo e traces de execução. Os nós de agentes 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 rastreamento da execução fica disponível na guia Execução do painel inferior, mostrando um detalhamento passo a passo com o tempo para cada nó, incluindo chamadas e saídas de LLM.

Avaliações

Você pode avaliar agentes em linha por nó a partir da 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 aba Execuções mostra o histórico de execução de avaliação.

A avaliação para agentes em linha está amplamente em paridade com o 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 incorporados. 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	Passa 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
Julgamento do LLM	Saída do Julgamento do LLM	Usa um modelo de linguagem para avaliar o quão próximo a saída corresponde à saída esperada em significado e intenção
Julgamento do LLM	JSON estrito do juiz do LLM	Usa um modelo de linguagem para avaliar a correspondência estrutural do JSON restrito
Julgamento do LLM	Trajetória do juiz do LLM	Usa um modelo de linguagem para avaliar se o agente seguiu o comportamento esperado
Julgamento do LLM	Simulação de juiz do LLM	Usa um modelo de linguagem para julgar o caminho de execução do agente simulado
Tool Call	Argumentos da chamada da ferramenta	Verifica se as ferramentas foram chamadas com argumentos corretos
Tool Call	Contagem de chamadas de ferramenta	Verifica o número de vezes que cada ferramenta foi chamada
Tool Call	Ordem da chamada da ferramenta	Verifica se as ferramentas foram chamadas na sequência esperada
Tool Call	Saída da chamada da ferramenta	Verifica se as saídas da ferramenta correspondem aos valores esperados