Class GuardrailAgentEvaluator

java.lang.Object

com.flowable.agent.engine.impl.guardrail.GuardrailAgentEvaluator

public class GuardrailAgentEvaluator
extends Object

Evaluates content by invoking a guardrail agent (an agent model of type "guardrailAgent"). The guardrail agent is expected to always return a JSON response with: {"pass": true/false, "confidence": 0.0-1.0, "reason": "..."}

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	GuardrailAgentEvaluator.GuardrailAgentResult	Result from evaluating content with a guardrail agent.

Field Summary

Fields

Modifier and Type	Field	Description
protected final AgentRuntimeService	agentRuntimeService
protected final tools.jackson.databind.ObjectMapper	objectMapper

Constructor Summary

Constructors

Constructor	Description
GuardrailAgentEvaluator(AgentRuntimeService agentRuntimeService, tools.jackson.databind.ObjectMapper objectMapper)

Method Summary

Modifier and Type	Method	Description
GuardrailAgentEvaluator.GuardrailAgentResult	evaluate(AgentDefinitionModel.GuardrailReference guardrailRef, String content, String tenantId)	Evaluates the given content using the specified guardrail agent.
GuardrailAgentEvaluator.GuardrailAgentResult	evaluate(AgentDefinitionModel.GuardrailReference guardrailRef, String content, String tenantId, Map<String,Object> additionalVariables)	Evaluates the given content using the specified guardrail agent.
protected GuardrailAgentEvaluator.GuardrailAgentResult	parseStructuredResult(AgentInvocationResult invocationResult)

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

agentRuntimeService

protected final AgentRuntimeService agentRuntimeService

objectMapper

protected final tools.jackson.databind.ObjectMapper objectMapper

Constructor Details

GuardrailAgentEvaluator

public GuardrailAgentEvaluator(AgentRuntimeService agentRuntimeService,
 tools.jackson.databind.ObjectMapper objectMapper)

Method Details

evaluate

public GuardrailAgentEvaluator.GuardrailAgentResult evaluate(AgentDefinitionModel.GuardrailReference guardrailRef,
 String content,
 String tenantId)

Evaluates the given content using the specified guardrail agent.

Parameters:

guardrailRef - the guardrail reference (must be of type "agent")

content - the content to validate (user input or LLM output)

tenantId - the tenant ID for multi-tenant environments

Returns:

the evaluation result

evaluate

public GuardrailAgentEvaluator.GuardrailAgentResult evaluate(AgentDefinitionModel.GuardrailReference guardrailRef,
 String content,
 String tenantId,
 Map<String,Object> additionalVariables)

Evaluates the given content using the specified guardrail agent.

Parameters:

guardrailRef - the guardrail reference (must be of type "agent")

content - the content to validate (user input or LLM output)

tenantId - the tenant ID for multi-tenant environments

additionalVariables - additional variables to pass to the guardrail agent (e.g. parent agent input parameters)

Returns:

the evaluation result

parseStructuredResult

protected GuardrailAgentEvaluator.GuardrailAgentResult parseStructuredResult(AgentInvocationResult invocationResult)