Interface InvokeHarnessRequest.Builder

All Superinterfaces:

AwsRequest.Builder, BedrockAgentCoreRequest.Builder, Buildable, CopyableBuilder<InvokeHarnessRequest.Builder,InvokeHarnessRequest>, SdkBuilder<InvokeHarnessRequest.Builder,InvokeHarnessRequest>, SdkPojo, SdkRequest.Builder

Enclosing class:

InvokeHarnessRequest

@Mutable
@NotThreadSafe
public static interface InvokeHarnessRequest.Builder
extends BedrockAgentCoreRequest.Builder, SdkPojo, CopyableBuilder<InvokeHarnessRequest.Builder,InvokeHarnessRequest>

Method Summary

Modifier and Type	Method	Description
InvokeHarnessRequest.Builder	actorId(String actorId)	The actor ID for memory operations.
InvokeHarnessRequest.Builder	allowedTools(String... allowedTools)	The tools that the agent is allowed to use for this invocation.
InvokeHarnessRequest.Builder	allowedTools(Collection<String> allowedTools)	The tools that the agent is allowed to use for this invocation.
InvokeHarnessRequest.Builder	harnessArn(String harnessArn)	The ARN of the harness to invoke.
InvokeHarnessRequest.Builder	maxIterations(Integer maxIterations)	The maximum number of iterations the agent loop can execute.
InvokeHarnessRequest.Builder	maxTokens(Integer maxTokens)	The maximum number of tokens the agent can generate per iteration.
InvokeHarnessRequest.Builder	messages(Collection<HarnessMessage> messages)	The messages to send to the agent.
InvokeHarnessRequest.Builder	messages(Consumer<HarnessMessage.Builder>... messages)	The messages to send to the agent.
InvokeHarnessRequest.Builder	messages(HarnessMessage... messages)	The messages to send to the agent.
default InvokeHarnessRequest.Builder	model(Consumer<HarnessModelConfiguration.Builder> model)	The model configuration to use for this invocation.
InvokeHarnessRequest.Builder	model(HarnessModelConfiguration model)	The model configuration to use for this invocation.
InvokeHarnessRequest.Builder	overrideConfiguration(Consumer<AwsRequestOverrideConfiguration.Builder> builderConsumer)	Add an optional request override configuration.
InvokeHarnessRequest.Builder	overrideConfiguration(AwsRequestOverrideConfiguration overrideConfiguration)	Add an optional request override configuration.
InvokeHarnessRequest.Builder	runtimeSessionId(String runtimeSessionId)	The session ID for the invocation.
InvokeHarnessRequest.Builder	skills(Collection<HarnessSkill> skills)	The skills available to the agent for this invocation.
InvokeHarnessRequest.Builder	skills(Consumer<HarnessSkill.Builder>... skills)	The skills available to the agent for this invocation.
InvokeHarnessRequest.Builder	skills(HarnessSkill... skills)	The skills available to the agent for this invocation.
InvokeHarnessRequest.Builder	systemPrompt(Collection<HarnessSystemContentBlock> systemPrompt)	The system prompt to use for this invocation.
InvokeHarnessRequest.Builder	systemPrompt(Consumer<HarnessSystemContentBlock.Builder>... systemPrompt)	The system prompt to use for this invocation.
InvokeHarnessRequest.Builder	systemPrompt(HarnessSystemContentBlock... systemPrompt)	The system prompt to use for this invocation.
InvokeHarnessRequest.Builder	timeoutSeconds(Integer timeoutSeconds)	The maximum duration in seconds for the agent loop execution.
InvokeHarnessRequest.Builder	tools(Collection<HarnessTool> tools)	The tools available to the agent for this invocation.
InvokeHarnessRequest.Builder	tools(Consumer<HarnessTool.Builder>... tools)	The tools available to the agent for this invocation.
InvokeHarnessRequest.Builder	tools(HarnessTool... tools)	The tools available to the agent for this invocation.

Methods inherited from interface software.amazon.awssdk.awscore.AwsRequest.Builder

overrideConfiguration

Methods inherited from interface software.amazon.awssdk.services.bedrockagentcore.model.BedrockAgentCoreRequest.Builder

build

Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder

copy

Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder

applyMutation, build

Methods inherited from interface software.amazon.awssdk.core.SdkPojo

equalsBySdkFields, sdkFieldNameToField, sdkFields

Method Details

harnessArn

InvokeHarnessRequest.Builder harnessArn(String harnessArn)

The ARN of the harness to invoke.

Parameters:

harnessArn - The ARN of the harness to invoke.

Returns:

Returns a reference to this object so that method calls can be chained together.

runtimeSessionId

InvokeHarnessRequest.Builder runtimeSessionId(String runtimeSessionId)

The session ID for the invocation. Use the same session ID across requests to continue a conversation.

Parameters:

runtimeSessionId - The session ID for the invocation. Use the same session ID across requests to continue a conversation.

Returns:

Returns a reference to this object so that method calls can be chained together.

messages

InvokeHarnessRequest.Builder messages(Collection<HarnessMessage> messages)

The messages to send to the agent.

Parameters:

messages - The messages to send to the agent.

Returns:

Returns a reference to this object so that method calls can be chained together.

messages

InvokeHarnessRequest.Builder messages(HarnessMessage... messages)

The messages to send to the agent.

Parameters:

messages - The messages to send to the agent.

Returns:

Returns a reference to this object so that method calls can be chained together.

messages

InvokeHarnessRequest.Builder messages(Consumer<HarnessMessage.Builder>... messages)

The messages to send to the agent.

This is a convenience method that creates an instance of the HarnessMessage.Builder avoiding the need to create one manually via HarnessMessage.builder().

When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to messages(List<HarnessMessage>).

Parameters:

messages - a consumer that will call methods on HarnessMessage.Builder

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

• messages(java.util.Collection<HarnessMessage>)

model

InvokeHarnessRequest.Builder model(HarnessModelConfiguration model)

The model configuration to use for this invocation. If specified, overrides the harness default.

Parameters:

model - The model configuration to use for this invocation. If specified, overrides the harness default.

Returns:

Returns a reference to this object so that method calls can be chained together.

model

default InvokeHarnessRequest.Builder model(Consumer<HarnessModelConfiguration.Builder> model)

The model configuration to use for this invocation. If specified, overrides the harness default.

This is a convenience method that creates an instance of the HarnessModelConfiguration.Builder avoiding the need to create one manually via HarnessModelConfiguration.builder().

When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to model(HarnessModelConfiguration).

Parameters:

model - a consumer that will call methods on HarnessModelConfiguration.Builder

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

• model(HarnessModelConfiguration)

systemPrompt

InvokeHarnessRequest.Builder systemPrompt(Collection<HarnessSystemContentBlock> systemPrompt)

The system prompt to use for this invocation. If specified, overrides the harness default.

Parameters:

systemPrompt - The system prompt to use for this invocation. If specified, overrides the harness default.

Returns:

Returns a reference to this object so that method calls can be chained together.

systemPrompt

InvokeHarnessRequest.Builder systemPrompt(HarnessSystemContentBlock... systemPrompt)

The system prompt to use for this invocation. If specified, overrides the harness default.

Parameters:

systemPrompt - The system prompt to use for this invocation. If specified, overrides the harness default.

Returns:

Returns a reference to this object so that method calls can be chained together.

systemPrompt

InvokeHarnessRequest.Builder systemPrompt(Consumer<HarnessSystemContentBlock.Builder>... systemPrompt)

The system prompt to use for this invocation. If specified, overrides the harness default.

This is a convenience method that creates an instance of the HarnessSystemContentBlock.Builder avoiding the need to create one manually via HarnessSystemContentBlock.builder().

When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to systemPrompt(List<HarnessSystemContentBlock>).

Parameters:

systemPrompt - a consumer that will call methods on HarnessSystemContentBlock.Builder

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

• systemPrompt(java.util.Collection<HarnessSystemContentBlock>)

tools

InvokeHarnessRequest.Builder tools(Collection<HarnessTool> tools)

The tools available to the agent for this invocation. If specified, overrides the harness default.

Parameters:

tools - The tools available to the agent for this invocation. If specified, overrides the harness default.

Returns:

Returns a reference to this object so that method calls can be chained together.

tools

InvokeHarnessRequest.Builder tools(HarnessTool... tools)

The tools available to the agent for this invocation. If specified, overrides the harness default.

Parameters:

tools - The tools available to the agent for this invocation. If specified, overrides the harness default.

Returns:

Returns a reference to this object so that method calls can be chained together.

tools

InvokeHarnessRequest.Builder tools(Consumer<HarnessTool.Builder>... tools)

The tools available to the agent for this invocation. If specified, overrides the harness default.

This is a convenience method that creates an instance of the HarnessTool.Builder avoiding the need to create one manually via HarnessTool.builder().

When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to tools(List<HarnessTool>).

Parameters:

tools - a consumer that will call methods on HarnessTool.Builder

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

• tools(java.util.Collection<HarnessTool>)

skills

InvokeHarnessRequest.Builder skills(Collection<HarnessSkill> skills)

The skills available to the agent for this invocation. If specified, overrides the harness default.

Parameters:

skills - The skills available to the agent for this invocation. If specified, overrides the harness default.

Returns:

Returns a reference to this object so that method calls can be chained together.

skills

InvokeHarnessRequest.Builder skills(HarnessSkill... skills)

The skills available to the agent for this invocation. If specified, overrides the harness default.

Parameters:

skills - The skills available to the agent for this invocation. If specified, overrides the harness default.

Returns:

Returns a reference to this object so that method calls can be chained together.

skills

InvokeHarnessRequest.Builder skills(Consumer<HarnessSkill.Builder>... skills)

The skills available to the agent for this invocation. If specified, overrides the harness default.

This is a convenience method that creates an instance of the HarnessSkill.Builder avoiding the need to create one manually via HarnessSkill.builder() .

When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to skills(List<HarnessSkill>).

Parameters:

skills - a consumer that will call methods on HarnessSkill.Builder

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

• skills(java.util.Collection<HarnessSkill>)

allowedTools

InvokeHarnessRequest.Builder allowedTools(Collection<String> allowedTools)

The tools that the agent is allowed to use for this invocation. If specified, overrides the harness default.

Parameters:

allowedTools - The tools that the agent is allowed to use for this invocation. If specified, overrides the harness default.

Returns:

Returns a reference to this object so that method calls can be chained together.

allowedTools

InvokeHarnessRequest.Builder allowedTools(String... allowedTools)

The tools that the agent is allowed to use for this invocation. If specified, overrides the harness default.

Parameters:

allowedTools - The tools that the agent is allowed to use for this invocation. If specified, overrides the harness default.

Returns:

Returns a reference to this object so that method calls can be chained together.

maxIterations

InvokeHarnessRequest.Builder maxIterations(Integer maxIterations)

The maximum number of iterations the agent loop can execute. If specified, overrides the harness default.

Parameters:

maxIterations - The maximum number of iterations the agent loop can execute. If specified, overrides the harness default.

Returns:

Returns a reference to this object so that method calls can be chained together.

maxTokens

InvokeHarnessRequest.Builder maxTokens(Integer maxTokens)

The maximum number of tokens the agent can generate per iteration. If specified, overrides the harness default.

Parameters:

maxTokens - The maximum number of tokens the agent can generate per iteration. If specified, overrides the harness default.

Returns:

Returns a reference to this object so that method calls can be chained together.

timeoutSeconds

InvokeHarnessRequest.Builder timeoutSeconds(Integer timeoutSeconds)

The maximum duration in seconds for the agent loop execution. If specified, overrides the harness default.

Parameters:

timeoutSeconds - The maximum duration in seconds for the agent loop execution. If specified, overrides the harness default.

Returns:

Returns a reference to this object so that method calls can be chained together.

actorId

InvokeHarnessRequest.Builder actorId(String actorId)

The actor ID for memory operations. Overrides the actor ID configured on the harness.

Parameters:

actorId - The actor ID for memory operations. Overrides the actor ID configured on the harness.

Returns:

Returns a reference to this object so that method calls can be chained together.

overrideConfiguration

InvokeHarnessRequest.Builder overrideConfiguration(AwsRequestOverrideConfiguration overrideConfiguration)

Description copied from interface: AwsRequest.Builder

Add an optional request override configuration.

Specified by:

overrideConfiguration in interface AwsRequest.Builder

Parameters:

overrideConfiguration - The override configuration.

Returns:

This object for method chaining.

overrideConfiguration

InvokeHarnessRequest.Builder overrideConfiguration(Consumer<AwsRequestOverrideConfiguration.Builder> builderConsumer)

Description copied from interface: AwsRequest.Builder

Add an optional request override configuration.

Specified by:

overrideConfiguration in interface AwsRequest.Builder

Parameters:

builderConsumer - A Consumer to which an empty AwsRequestOverrideConfiguration.Builder will be given.

Returns:

This object for method chaining.