Package akka.javasdk.agent

Interface Agent.Effect.OnSuccessBuilder

Enclosing interface:

Agent.Effect<T>

public static interface Agent.Effect.OnSuccessBuilder

Method Summary

Modifier and Type	Method	Description
<T> Agent.Effect.MappingResponseBuilder<T>	map(Function<String,T> mapper)	Map the String response from the model into a different response type.
Agent.Effect.FailureBuilder<String>	onFailure(Function<Throwable,String> exceptionHandler)	Handle failures that occur during model processing.
<T> Agent.Effect.MappingResponseBuilder<T>	responseAs(Class<T> responseType)	Parse the response from the model into a structured response of a given responseType.
Agent.Effect<String>	thenReply()	Reply with the response from the model.
Agent.Effect<String>	thenReply(Metadata metadata)	Reply with the response from the model.

Method Details

thenReply

Agent.Effect<String> thenReply()

Reply with the response from the model.

Returns:

A message reply.

thenReply

Agent.Effect<String> thenReply(Metadata metadata)

Reply with the response from the model.

Parameters:

metadata - The metadata for the message.

Returns:

A message reply.

responseAs

<T> Agent.Effect.MappingResponseBuilder<T> responseAs(Class<T> responseType)

Parse the response from the model into a structured response of a given responseType.

Parameters:

responseType - The structured response type.

map

<T> Agent.Effect.MappingResponseBuilder<T> map(Function<String,T> mapper)

Map the String response from the model into a different response type.

onFailure

Agent.Effect.FailureBuilder<String> onFailure(Function<Throwable,String> exceptionHandler)

Handle failures that occur during model processing. This method allows recovery from various types of exceptions including:

• ModelException - General model processing failures
• RateLimitException - API rate limiting exceeded
• ModelTimeoutException - Model request timeout
• UnsupportedFeatureException - Unsupported model features
• InternalServerException - Internal service errors
• JsonParsingException - Response parsing failures
• ToolCallLimitReachedException - Tool call limit exceeded
• ToolCallExecutionException - Function tool execution errors
• McpToolCallExecutionException - MCP tool execution errors