Class DeclarativeUtil

java.lang.Object

dev.langchain4j.agentic.declarative.DeclarativeUtil

public class DeclarativeUtil
extends Object

Method Summary

Modifier and Type	Method	Description
static AgentCondition	activationCondition(Class<?> agentClass)	Reads the activation condition of the agent declared by the given class or interface: the static method annotated with ActivationCondition without a value.
static void	addSupplierParameterResolver(SupplierParameterResolver resolver)
static <T> Function<AgenticScope, T>	agenticScopeFunction(Class<?> agentType, Method functionMethod, Class<T> targetClass)	Creates a function invoking the given static method declared on, or inherited by, the given agent type: its parameters supported by a registered SupplierParameterResolver are resolved, the others are read from the AgenticScope, and are null when the function is applied without one.
static <T> Function<AgenticScope, T>	agenticScopeFunction(Method functionMethod, Class<T> targetClass)
static Predicate<AgenticScope>	agenticScopePredicate(Class<?> agentType, Method predicateMethod)
static Predicate<AgenticScope>	agenticScopePredicate(Method predicateMethod)
static void	buildAgentFeatures(Class<?> agentServiceClass, AgenticService<?,?> builder)
static void	checkNoDecisionSuppliers(Class<?> agentType)	Checks that the given type, built as an agent of another kind, declares no method annotated with DecisionModelSupplier or DecisionThresholdSupplier, which would be silently ignored.
static void	checkReturnType(Method method, Class<?> expected)	Checks that the given method can return an instance of the expected type: its return type must be a subtype or a supertype, like Object, of the expected one.
static void	configureAgent(Class<?> agentType, AgentBuilder<?,?> agentBuilder)
static void	configureAgent(Class<?> agentType, ChatModel chatModel, AgentBuilder<?,?> agentBuilder, AgenticServices.AgentConfigurator agentConfigurator)
static void	configureDecisionAgent(Class<?> agentType, DecisionAgentBuilder<?> builder)
static void	configureDecisionAgent(Class<?> agentType, DecisionAgentBuilder<?> builder, AgenticServices.AgentConfigurator agentConfigurator)	Applies the declarative configuration of the given decision agent interface to its builder: the DecisionModelSupplier, the DecisionThresholdSupplier, the AgentListenerSupplier, the ActivationCondition and the agent configurator.
static <T> void	configureOutput(Class<T> agentServiceClass, AgenticService<?,?> builder)
static int	frameworkParameterCount(Class<?> agentType, Method method)
static List<SupplierParameterResolver>	getSupplierParameterResolvers()
static <T> T	invokeStatic(Method method, Object... args)
static <T> T	invokeSupplierWithResolvers(Class<?> agentType, Method method, Class<T> targetClass)	Invokes a static supplier method: all its parameters must be provided by the registered SupplierParameterResolvers.
static boolean	isDecisionAgent(Class<?> agentType)	Whether the given type is a decision agent: an interface whose @Agent method is annotated with @Decide, or which declares a DecisionModelSupplier method.
static Optional<Executor>	parallelExecutor(Class<?> agentServiceClass)
static Optional<Method>	predicateMethod(Class<?> agentServiceClass, Predicate<Method> methodSelector)	Selects the static condition method matching the given selector.
static Optional<Method>	selectMethod(Class<?> agentServiceClass, Predicate<Method> methodSelector)

Methods inherited from class Object

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

Method Details

configureAgent

public static void configureAgent(Class<?> agentType,
 AgentBuilder<?,?> agentBuilder)

configureAgent

public static void configureAgent(Class<?> agentType,
 ChatModel chatModel,
 AgentBuilder<?,?> agentBuilder,
 AgenticServices.AgentConfigurator agentConfigurator)

isDecisionAgent

public static boolean isDecisionAgent(Class<?> agentType)

Whether the given type is a decision agent: an interface whose @Agent method is annotated with @Decide, or which declares a DecisionModelSupplier method.

configureDecisionAgent

public static void configureDecisionAgent(Class<?> agentType,
 DecisionAgentBuilder<?> builder)

configureDecisionAgent

public static void configureDecisionAgent(Class<?> agentType,
 DecisionAgentBuilder<?> builder,
 AgenticServices.AgentConfigurator agentConfigurator)

Applies the declarative configuration of the given decision agent interface to its builder: the DecisionModelSupplier, the DecisionThresholdSupplier, the AgentListenerSupplier, the ActivationCondition and the agent configurator.

Throws:

AgenticSystemConfigurationException - if the interface also declares a ChatModelSupplier or a StreamingChatModelSupplier

checkNoDecisionSuppliers

public static void checkNoDecisionSuppliers(Class<?> agentType)

Checks that the given type, built as an agent of another kind, declares no method annotated with DecisionModelSupplier or DecisionThresholdSupplier, which would be silently ignored.

Throws:

AgenticSystemConfigurationException - if it does

checkReturnType

public static void checkReturnType(Method method,
 Class<?> expected)

Checks that the given method can return an instance of the expected type: its return type must be a subtype or a supertype, like Object, of the expected one.

Throws:

IllegalArgumentException - if it cannot

invokeStatic

public static <T> T invokeStatic(Method method,
 Object... args)

configureOutput

public static <T> void configureOutput(Class<T> agentServiceClass,
 AgenticService<?,?> builder)

predicateMethod

public static Optional<Method> predicateMethod(Class<?> agentServiceClass,
 Predicate<Method> methodSelector)

Selects the static condition method matching the given selector.

Throws:

IllegalArgumentException - if the selected method doesn't return a boolean

buildAgentFeatures

public static void buildAgentFeatures(Class<?> agentServiceClass,
 AgenticService<?,?> builder)

activationCondition

public static AgentCondition activationCondition(Class<?> agentClass)

Reads the activation condition of the agent declared by the given class or interface: the static method annotated with ActivationCondition without a value. An ActivationCondition with a value is allowed only on a ConditionalAgent, where it selects the subagents to activate, and where a condition without value is not allowed.

Returns:

the activation condition of the agent, or null when it has none

Throws:

AgenticSystemConfigurationException - if there is more than one such method, if it doesn't return a boolean, or if a condition with a value is declared on a class that is not a conditional agent

parallelExecutor

public static Optional<Executor> parallelExecutor(Class<?> agentServiceClass)

selectMethod

public static Optional<Method> selectMethod(Class<?> agentServiceClass,
 Predicate<Method> methodSelector)

agenticScopePredicate

public static Predicate<AgenticScope> agenticScopePredicate(Method predicateMethod)

agenticScopePredicate

public static Predicate<AgenticScope> agenticScopePredicate(Class<?> agentType,
 Method predicateMethod)

frameworkParameterCount

public static int frameworkParameterCount(Class<?> agentType,
 Method method)

Returns:

the number of parameters of the given method that are not provided by a registered SupplierParameterResolver

invokeSupplierWithResolvers

public static <T> T invokeSupplierWithResolvers(Class<?> agentType,
 Method method,
 Class<T> targetClass)

Invokes a static supplier method: all its parameters must be provided by the registered SupplierParameterResolvers.

Throws:

AgenticSystemConfigurationException - if a parameter is not supported by any resolver

agenticScopeFunction

public static <T> Function<AgenticScope, T> agenticScopeFunction(Method functionMethod,
 Class<T> targetClass)

agenticScopeFunction

public static <T> Function<AgenticScope, T> agenticScopeFunction(Class<?> agentType,
 Method functionMethod,
 Class<T> targetClass)

Creates a function invoking the given static method declared on, or inherited by, the given agent type: its parameters supported by a registered SupplierParameterResolver are resolved, the others are read from the AgenticScope, and are null when the function is applied without one.

addSupplierParameterResolver

public static void addSupplierParameterResolver(SupplierParameterResolver resolver)

getSupplierParameterResolvers

public static List<SupplierParameterResolver> getSupplierParameterResolvers()