Class AgentUtil

java.lang.Object

dev.langchain4j.agentic.internal.AgentUtil

public class AgentUtil
extends Object

Field Summary

Fields

Modifier and Type	Field	Description
static final String	AGENTIC_SCOPE_ARG_NAME
static final String	INVOCATION_PARAMETERS_ARG_NAME
static final String	LOOP_COUNTER_ARG_NAME
static final String	MEMORY_ID_ARG_NAME

Method Summary

Modifier and Type	Method	Description
static Map<String,Class<?>>	agenticSystemDataTypes(AgentInstance rootAgent)
static AgentInvocationArguments	agentInvocationArguments(AgenticScope agenticScope, Method method)
static AgentInvocationArguments	agentInvocationArguments(AgenticScope agenticScope, List<AgentArgument> agentArguments)
static AgentInvocationArguments	agentInvocationArguments(AgenticScope agenticScope, List<AgentArgument> agentArguments, Map<String,Object> additionalArgs)
static List<AgentExecutor>	agentsToExecutors(Collection<?> agents)
static AgentExecutor	agentToExecutor(InternalAgent agent)
static AgentExecutor	agentToExecutor(Object agent)
static AgentArgument	argumentFromParameter(Parameter parameter)
static List<AgentArgument>	argumentsFromMethod(Method method)
static List<AgentArgument>	argumentsFromMethod(Method method, Map<String,Object> defaultValues)
static List<AgentArgument>	argumentsFromMethod(Method method, Map<String,Object> defaultValues, Set<String> optionalArgs)
static List<AgentArgument>	argumentsFromMethod(Method method, Set<String> optionalArgs)
static <T> T	buildAgent(Class<T> agentServiceClass, InvocationHandler invocationHandler)
static Optional<Method>	getAnnotatedMethodOnClass(Class<?> clazz, Class<? extends Annotation> annotation)
static <T> T	keyDefaultValue(Class<? extends TypedKey<T>> key)
static String	keyName(Class<? extends TypedKey<?>> key)
static AgentInvoker	nonAiAgentInvoker(Method agenticMethod, String name, String description, String outputKey, boolean async)
static AgentExecutor	nonAiAgentToExecutor(Object agent, Method agenticMethod)
static String	outputKey(String outputKey, Class<? extends TypedKey<?>> typedOutputKey)
static Class<?>	rawType(Type type)
static AgentInvocationArguments	untypedAgentInvocationArguments(AgenticScope agenticScope)	Builds the arguments for an untyped agent, which receives the whole AgenticScope state as a single Map.
static Method	validateAgentClass(Class<?> agentServiceClass)
static Method	validateAgentClass(Class<?> agentServiceClass, boolean failOnMissingAnnotation)
static Method	validateAgentClass(Class<?> agentServiceClass, boolean failOnMissingAnnotation, Class<? extends Annotation> patternAnnotation)

Methods inherited from class Object

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

Field Details

MEMORY_ID_ARG_NAME

public static final String MEMORY_ID_ARG_NAME

See Also:

• Constant Field Values

AGENTIC_SCOPE_ARG_NAME

public static final String AGENTIC_SCOPE_ARG_NAME

See Also:

• Constant Field Values

LOOP_COUNTER_ARG_NAME

public static final String LOOP_COUNTER_ARG_NAME

See Also:

• Constant Field Values

INVOCATION_PARAMETERS_ARG_NAME

public static final String INVOCATION_PARAMETERS_ARG_NAME

See Also:

• Constant Field Values

Method Details

outputKey

public static String outputKey(String outputKey,
 Class<? extends TypedKey<?>> typedOutputKey)

keyDefaultValue

public static <T> T keyDefaultValue(Class<? extends TypedKey<T>> key)

keyName

public static String keyName(Class<? extends TypedKey<?>> key)

agentsToExecutors

public static List<AgentExecutor> agentsToExecutors(Collection<?> agents)

agentToExecutor

public static AgentExecutor agentToExecutor(Object agent)

nonAiAgentToExecutor

public static AgentExecutor nonAiAgentToExecutor(Object agent,
 Method agenticMethod)

nonAiAgentInvoker

public static AgentInvoker nonAiAgentInvoker(Method agenticMethod,
 String name,
 String description,
 String outputKey,
 boolean async)

agentToExecutor

public static AgentExecutor agentToExecutor(InternalAgent agent)

getAnnotatedMethodOnClass

public static Optional<Method> getAnnotatedMethodOnClass(Class<?> clazz,
 Class<? extends Annotation> annotation)

argumentsFromMethod

public static List<AgentArgument> argumentsFromMethod(Method method)

argumentsFromMethod

public static List<AgentArgument> argumentsFromMethod(Method method,
 Set<String> optionalArgs)

argumentsFromMethod

public static List<AgentArgument> argumentsFromMethod(Method method,
 Map<String,Object> defaultValues)

argumentsFromMethod

public static List<AgentArgument> argumentsFromMethod(Method method,
 Map<String,Object> defaultValues,
 Set<String> optionalArgs)

argumentFromParameter

public static AgentArgument argumentFromParameter(Parameter parameter)

untypedAgentInvocationArguments

public static AgentInvocationArguments untypedAgentInvocationArguments(AgenticScope agenticScope)

Builds the arguments for an untyped agent, which receives the whole AgenticScope state as a single Map. The map is a filtered copy rather than the state itself: a copy so that the recorded AgentInvocation.input() keeps the state as it was at invocation time instead of following later writes, and filtered so that values which cannot be serialized never reach the agent or the persisted invocation.

agentInvocationArguments

public static AgentInvocationArguments agentInvocationArguments(AgenticScope agenticScope,
 Method method)
                                                         throws MissingArgumentException

Throws:

MissingArgumentException

agentInvocationArguments

public static AgentInvocationArguments agentInvocationArguments(AgenticScope agenticScope,
 List<AgentArgument> agentArguments)
                                                         throws MissingArgumentException

Throws:

MissingArgumentException

agentInvocationArguments

public static AgentInvocationArguments agentInvocationArguments(AgenticScope agenticScope,
 List<AgentArgument> agentArguments,
 Map<String,Object> additionalArgs)
                                                         throws MissingArgumentException

Throws:

MissingArgumentException

validateAgentClass

public static Method validateAgentClass(Class<?> agentServiceClass)

validateAgentClass

public static Method validateAgentClass(Class<?> agentServiceClass,
 boolean failOnMissingAnnotation)

validateAgentClass

public static Method validateAgentClass(Class<?> agentServiceClass,
 boolean failOnMissingAnnotation,
 Class<? extends Annotation> patternAnnotation)

buildAgent

public static <T> T buildAgent(Class<T> agentServiceClass,
 InvocationHandler invocationHandler)

agenticSystemDataTypes

public static Map<String,Class<?>> agenticSystemDataTypes(AgentInstance rootAgent)

rawType

public static Class<?> rawType(Type type)