Interface Harness.Builder

All Superinterfaces:

Buildable, CopyableBuilder<Harness.Builder,Harness>, SdkBuilder<Harness.Builder,Harness>, SdkPojo

Enclosing class:

Harness

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

Method Summary

Modifier and Type	Method	Description
Harness.Builder	allowedTools(String... allowedTools)	The allowed tools of the Harness.
Harness.Builder	allowedTools(Collection<String> allowedTools)	The allowed tools of the Harness.
Harness.Builder	arn(String arn)	The ARN of the Harness.
default Harness.Builder	authorizerConfiguration(Consumer<AuthorizerConfiguration.Builder> authorizerConfiguration)	Sets the value of the AuthorizerConfiguration property for this object.
Harness.Builder	authorizerConfiguration(AuthorizerConfiguration authorizerConfiguration)	Sets the value of the AuthorizerConfiguration property for this object.
Harness.Builder	createdAt(Instant createdAt)	The createdAt time of the Harness.
default Harness.Builder	environment(Consumer<HarnessEnvironmentProvider.Builder> environment)	The compute environment on which the Harness runs.
Harness.Builder	environment(HarnessEnvironmentProvider environment)	The compute environment on which the Harness runs.
default Harness.Builder	environmentArtifact(Consumer<HarnessEnvironmentArtifact.Builder> environmentArtifact)	The environment artifact (e.g., container) in which the Harness operates.
Harness.Builder	environmentArtifact(HarnessEnvironmentArtifact environmentArtifact)	The environment artifact (e.g., container) in which the Harness operates.
Harness.Builder	environmentVariables(Map<String,String> environmentVariables)	Environment variables exposed in the environment in which the Harness operates.
Harness.Builder	executionRoleArn(String executionRoleArn)	IAM role the Harness assumes when running.
Harness.Builder	failureReason(String failureReason)	Reason why create or update operations fail.
Harness.Builder	harnessId(String harnessId)	The ID of the Harness.
Harness.Builder	harnessName(String harnessName)	The name of the Harness.
Harness.Builder	maxIterations(Integer maxIterations)	The maximum number of iterations in the agent loop allowed before exiting per invocation.
Harness.Builder	maxTokens(Integer maxTokens)	The maximum total number of output tokens the agent can generate across all model calls within a single invocation.
default Harness.Builder	memory(Consumer<HarnessMemoryConfiguration.Builder> memory)	AgentCore Memory instance configuration for short and long term memory.
Harness.Builder	memory(HarnessMemoryConfiguration memory)	AgentCore Memory instance configuration for short and long term memory.
default Harness.Builder	model(Consumer<HarnessModelConfiguration.Builder> model)	The configuration of the default model used by the Harness.
Harness.Builder	model(HarnessModelConfiguration model)	The configuration of the default model used by the Harness.
Harness.Builder	skills(Collection<HarnessSkill> skills)	The skills of the Harness.
Harness.Builder	skills(Consumer<HarnessSkill.Builder>... skills)	The skills of the Harness.
Harness.Builder	skills(HarnessSkill... skills)	The skills of the Harness.
Harness.Builder	status(String status)	The status of the Harness.
Harness.Builder	status(HarnessStatus status)	The status of the Harness.
Harness.Builder	systemPrompt(Collection<HarnessSystemContentBlock> systemPrompt)	The system prompt of the Harness.
Harness.Builder	systemPrompt(Consumer<HarnessSystemContentBlock.Builder>... systemPrompt)	The system prompt of the Harness.
Harness.Builder	systemPrompt(HarnessSystemContentBlock... systemPrompt)	The system prompt of the Harness.
Harness.Builder	timeoutSeconds(Integer timeoutSeconds)	The maximum duration per invocation.
Harness.Builder	tools(Collection<HarnessTool> tools)	The tools of the Harness.
Harness.Builder	tools(Consumer<HarnessTool.Builder>... tools)	The tools of the Harness.
Harness.Builder	tools(HarnessTool... tools)	The tools of the Harness.
default Harness.Builder	truncation(Consumer<HarnessTruncationConfiguration.Builder> truncation)	Configuration for truncating model context.
Harness.Builder	truncation(HarnessTruncationConfiguration truncation)	Configuration for truncating model context.
Harness.Builder	updatedAt(Instant updatedAt)	The updatedAt time of the Harness.

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

harnessId

Harness.Builder harnessId(String harnessId)

The ID of the Harness.

Parameters:

harnessId - The ID of the Harness.

Returns:

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

harnessName

Harness.Builder harnessName(String harnessName)

The name of the Harness.

Parameters:

harnessName - The name of the Harness.

Returns:

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

arn

Harness.Builder arn(String arn)

The ARN of the Harness.

Parameters:

arn - The ARN of the Harness.

Returns:

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

status

Harness.Builder status(String status)

The status of the Harness.

Parameters:

status - The status of the Harness.

Returns:

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

See Also:

• HarnessStatus
• HarnessStatus

status

Harness.Builder status(HarnessStatus status)

The status of the Harness.

Parameters:

status - The status of the Harness.

Returns:

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

See Also:

• HarnessStatus
• HarnessStatus

executionRoleArn

Harness.Builder executionRoleArn(String executionRoleArn)

IAM role the Harness assumes when running.

Parameters:

executionRoleArn - IAM role the Harness assumes when running.

Returns:

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

createdAt

Harness.Builder createdAt(Instant createdAt)

The createdAt time of the Harness.

Parameters:

createdAt - The createdAt time of the Harness.

Returns:

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

updatedAt

Harness.Builder updatedAt(Instant updatedAt)

The updatedAt time of the Harness.

Parameters:

updatedAt - The updatedAt time of the Harness.

Returns:

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

model

Harness.Builder model(HarnessModelConfiguration model)

The configuration of the default model used by the Harness.

Parameters:

model - The configuration of the default model used by the Harness.

Returns:

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

model

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

The configuration of the default model used by the Harness.

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

Harness.Builder systemPrompt(Collection<HarnessSystemContentBlock> systemPrompt)

The system prompt of the Harness.

Parameters:

systemPrompt - The system prompt of the Harness.

Returns:

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

systemPrompt

Harness.Builder systemPrompt(HarnessSystemContentBlock... systemPrompt)

The system prompt of the Harness.

Parameters:

systemPrompt - The system prompt of the Harness.

Returns:

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

systemPrompt

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

The system prompt of the Harness.

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

Harness.Builder tools(Collection<HarnessTool> tools)

The tools of the Harness.

Parameters:

tools - The tools of the Harness.

Returns:

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

tools

Harness.Builder tools(HarnessTool... tools)

The tools of the Harness.

Parameters:

tools - The tools of the Harness.

Returns:

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

tools

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

The tools of the Harness.

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

Harness.Builder skills(Collection<HarnessSkill> skills)

The skills of the Harness.

Parameters:

skills - The skills of the Harness.

Returns:

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

skills

Harness.Builder skills(HarnessSkill... skills)

The skills of the Harness.

Parameters:

skills - The skills of the Harness.

Returns:

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

skills

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

The skills of the Harness.

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

Harness.Builder allowedTools(Collection<String> allowedTools)

The allowed tools of the Harness. All tools are allowed by default.

Parameters:

allowedTools - The allowed tools of the Harness. All tools are allowed by default.

Returns:

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

allowedTools

Harness.Builder allowedTools(String... allowedTools)

The allowed tools of the Harness. All tools are allowed by default.

Parameters:

allowedTools - The allowed tools of the Harness. All tools are allowed by default.

Returns:

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

truncation

Harness.Builder truncation(HarnessTruncationConfiguration truncation)

Configuration for truncating model context.

Parameters:

truncation - Configuration for truncating model context.

Returns:

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

truncation

default Harness.Builder truncation(Consumer<HarnessTruncationConfiguration.Builder> truncation)

Configuration for truncating model context.

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

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

Parameters:

truncation - a consumer that will call methods on HarnessTruncationConfiguration.Builder

Returns:

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

See Also:

• truncation(HarnessTruncationConfiguration)

environment

Harness.Builder environment(HarnessEnvironmentProvider environment)

The compute environment on which the Harness runs.

Parameters:

environment - The compute environment on which the Harness runs.

Returns:

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

environment

default Harness.Builder environment(Consumer<HarnessEnvironmentProvider.Builder> environment)

The compute environment on which the Harness runs.

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

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

Parameters:

environment - a consumer that will call methods on HarnessEnvironmentProvider.Builder

Returns:

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

See Also:

• environment(HarnessEnvironmentProvider)

environmentArtifact

Harness.Builder environmentArtifact(HarnessEnvironmentArtifact environmentArtifact)

The environment artifact (e.g., container) in which the Harness operates.

Parameters:

environmentArtifact - The environment artifact (e.g., container) in which the Harness operates.

Returns:

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

environmentArtifact

default Harness.Builder environmentArtifact(Consumer<HarnessEnvironmentArtifact.Builder> environmentArtifact)

The environment artifact (e.g., container) in which the Harness operates.

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

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

Parameters:

environmentArtifact - a consumer that will call methods on HarnessEnvironmentArtifact.Builder

Returns:

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

See Also:

• environmentArtifact(HarnessEnvironmentArtifact)

environmentVariables

Harness.Builder environmentVariables(Map<String,String> environmentVariables)

Environment variables exposed in the environment in which the Harness operates.

Parameters:

environmentVariables - Environment variables exposed in the environment in which the Harness operates.

Returns:

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

authorizerConfiguration

Harness.Builder authorizerConfiguration(AuthorizerConfiguration authorizerConfiguration)

Sets the value of the AuthorizerConfiguration property for this object.

Parameters:

authorizerConfiguration - The new value for the AuthorizerConfiguration property for this object.

Returns:

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

authorizerConfiguration

default Harness.Builder authorizerConfiguration(Consumer<AuthorizerConfiguration.Builder> authorizerConfiguration)

Sets the value of the AuthorizerConfiguration property for this object. This is a convenience method that creates an instance of the AuthorizerConfiguration.Builder avoiding the need to create one manually via AuthorizerConfiguration.builder().

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

Parameters:

authorizerConfiguration - a consumer that will call methods on AuthorizerConfiguration.Builder

Returns:

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

See Also:

• authorizerConfiguration(AuthorizerConfiguration)

memory

Harness.Builder memory(HarnessMemoryConfiguration memory)

AgentCore Memory instance configuration for short and long term memory.

Parameters:

memory - AgentCore Memory instance configuration for short and long term memory.

Returns:

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

memory

default Harness.Builder memory(Consumer<HarnessMemoryConfiguration.Builder> memory)

AgentCore Memory instance configuration for short and long term memory.

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

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

Parameters:

memory - a consumer that will call methods on HarnessMemoryConfiguration.Builder

Returns:

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

See Also:

• memory(HarnessMemoryConfiguration)

maxIterations

Harness.Builder maxIterations(Integer maxIterations)

The maximum number of iterations in the agent loop allowed before exiting per invocation.

Parameters:

maxIterations - The maximum number of iterations in the agent loop allowed before exiting per invocation.

Returns:

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

maxTokens

Harness.Builder maxTokens(Integer maxTokens)

The maximum total number of output tokens the agent can generate across all model calls within a single invocation.

Parameters:

maxTokens - The maximum total number of output tokens the agent can generate across all model calls within a single invocation.

Returns:

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

timeoutSeconds

Harness.Builder timeoutSeconds(Integer timeoutSeconds)

The maximum duration per invocation.

Parameters:

timeoutSeconds - The maximum duration per invocation.

Returns:

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

failureReason

Harness.Builder failureReason(String failureReason)

Reason why create or update operations fail.

Parameters:

failureReason - Reason why create or update operations fail.

Returns:

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