Package com.javaaidev.agenticpatterns.evaluatoroptimizer

Class EvaluatorOptimizerAgent<Request,Response>

java.lang.Object

com.javaaidev.agenticpatterns.core.Agent

com.javaaidev.agenticpatterns.taskexecution.TaskExecutionAgent<Request,Response>

com.javaaidev.agenticpatterns.taskexecution.NoLLMTaskExecutionAgent<Request,Response>

com.javaaidev.agenticpatterns.evaluatoroptimizer.EvaluatorOptimizerAgent<Request,Response>

Type Parameters:

Request - Type of agent input

Response - Type of agent output

All Implemented Interfaces:

Function<Request,Response>

Direct Known Subclasses:

PromptBasedEvaluatorOptimizerAgent

public abstract class EvaluatorOptimizerAgent<Request,Response>
extends NoLLMTaskExecutionAgent<Request,Response>

Evaluator-Optimizer Agent, refer to the pattern

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	EvaluatorOptimizerAgent.OptimizationInput<Response>

Field Summary

Fields

Modifier and Type	Field	Description
protected @Nullable TaskExecutionAgent<Response,Evaluation>	evaluationAgent
protected org.springframework.ai.chat.client.ChatClient	evaluationChatClient
protected org.springframework.ai.chat.client.ChatClient	generationChatClient
protected TaskExecutionAgent<Request,Response>	initialResultAgent
protected @Nullable TaskExecutionAgent<EvaluatorOptimizerAgent.OptimizationInput<Response>,Response>	optimizationAgent

Fields inherited from class com.javaaidev.agenticpatterns.taskexecution.TaskExecutionAgent

responseType

Fields inherited from class com.javaaidev.agenticpatterns.core.Agent

chatClient, observationRegistry

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	EvaluatorOptimizerAgent(org.springframework.ai.chat.client.ChatClient generationChatClient, org.springframework.ai.chat.client.ChatClient evaluationChatClient)
	EvaluatorOptimizerAgent(org.springframework.ai.chat.client.ChatClient generationChatClient, org.springframework.ai.chat.client.ChatClient evaluationChatClient, @Nullable io.micrometer.observation.ObservationRegistry observationRegistry)
protected	EvaluatorOptimizerAgent(org.springframework.ai.chat.client.ChatClient generationChatClient, org.springframework.ai.chat.client.ChatClient evaluationChatClient, @Nullable Type responseType, @Nullable io.micrometer.observation.ObservationRegistry observationRegistry)

Method Summary

Modifier and Type	Method	Description
protected abstract TaskExecutionAgent<Response,Evaluation>	buildEvaluationAgent(org.springframework.ai.chat.client.ChatClient chatClient, @Nullable io.micrometer.observation.ObservationRegistry observationRegistry)	Build the agent to evaluate the result
protected abstract TaskExecutionAgent<Request,Response>	buildInitialResultAgent(org.springframework.ai.chat.client.ChatClient chatClient, @Nullable io.micrometer.observation.ObservationRegistry observationRegistry)	Build the agent to generation initial result
protected abstract TaskExecutionAgent<EvaluatorOptimizerAgent.OptimizationInput<Response>,Response>	buildOptimizationAgent(org.springframework.ai.chat.client.ChatClient chatClient, @Nullable io.micrometer.observation.ObservationRegistry observationRegistry)	Build the agent to optimize the result
Response	call(@Nullable Request request)
protected int	getMaxIterations()	The maximum number of evaluation iterations, default to 3

Methods inherited from class com.javaaidev.agenticpatterns.taskexecution.NoLLMTaskExecutionAgent

getPromptTemplate

Methods inherited from class com.javaaidev.agenticpatterns.taskexecution.TaskExecutionAgent

apply, getPromptContext, instrumentedCall, updateChatClientRequest

Methods inherited from class com.javaaidev.agenticpatterns.core.Agent

getName

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.function.Function

andThen, compose

Field Details

generationChatClient

protected org.springframework.ai.chat.client.ChatClient generationChatClient

evaluationChatClient

protected org.springframework.ai.chat.client.ChatClient evaluationChatClient

initialResultAgent

protected TaskExecutionAgent<Request,Response> initialResultAgent

evaluationAgent

protected @Nullable TaskExecutionAgent<Response,Evaluation> evaluationAgent

optimizationAgent

protected @Nullable TaskExecutionAgent<EvaluatorOptimizerAgent.OptimizationInput<Response>,Response> optimizationAgent

Constructor Details

EvaluatorOptimizerAgent

protected EvaluatorOptimizerAgent(org.springframework.ai.chat.client.ChatClient generationChatClient,
 org.springframework.ai.chat.client.ChatClient evaluationChatClient)

EvaluatorOptimizerAgent

public EvaluatorOptimizerAgent(org.springframework.ai.chat.client.ChatClient generationChatClient,
 org.springframework.ai.chat.client.ChatClient evaluationChatClient,
 @Nullable io.micrometer.observation.ObservationRegistry observationRegistry)

EvaluatorOptimizerAgent

protected EvaluatorOptimizerAgent(org.springframework.ai.chat.client.ChatClient generationChatClient,
 org.springframework.ai.chat.client.ChatClient evaluationChatClient,
 @Nullable Type responseType,
 @Nullable io.micrometer.observation.ObservationRegistry observationRegistry)

Method Details

getMaxIterations

protected int getMaxIterations()

The maximum number of evaluation iterations, default to 3

Returns:

Maximum number of iterations

buildInitialResultAgent

protected abstract TaskExecutionAgent<Request,Response> buildInitialResultAgent(org.springframework.ai.chat.client.ChatClient chatClient,
 @Nullable io.micrometer.observation.ObservationRegistry observationRegistry)

Build the agent to generation initial result

Returns:

the agent, see TaskExecutionAgent

buildEvaluationAgent

protected abstract TaskExecutionAgent<Response,Evaluation> buildEvaluationAgent(org.springframework.ai.chat.client.ChatClient chatClient,
 @Nullable io.micrometer.observation.ObservationRegistry observationRegistry)

Build the agent to evaluate the result

Returns:

the agent, see TaskExecutionAgent

buildOptimizationAgent

protected abstract TaskExecutionAgent<EvaluatorOptimizerAgent.OptimizationInput<Response>,Response> buildOptimizationAgent(org.springframework.ai.chat.client.ChatClient chatClient,
 @Nullable io.micrometer.observation.ObservationRegistry observationRegistry)

Build the agent to optimize the result

Returns:

the agent, see TaskExecutionAgent

call

public Response call(@Nullable Request request)

Overrides:

call in class TaskExecutionAgent<Request,Response>